PowerAda aprojhide

From OC Systems Wiki!
Jump to: navigation, search


NAME

aprojhide - mark a file or unit as "hidden" within a project.

SYNOPSIS

aprojhide [-hFIv] [-L sublib] [-u|-f] [-r | -m dest] [names...]

DESCRIPTION

aprojhide is used to mark a file or compilation unit as "hidden" at its current position in a project. This is a somewhat obscure concept, but is important when deleting or changing the project-relative location of source files within a delta project. The motivation and practical use of this tool is described in Chapter 5, "Hide deleted files."

Powerada will now include files or units marked as hidden in its lists. However, the files and units are not deleted, and can be unhidden with the "-r" option.

The files that are hidden in a directory are listed with a '*' before the name by

aprojls -l [directory_name]

and are listed in a file called ".hidden" in that directory. similarly,

aprojls -l [directory/]adalib

will identify hidden units in a sublibrary.

OPTIONS

-h
Prints version and command line help information.
-F
Forces the action without a prompt for confirmation.
-I
Specifies that a list of file or unit names will be read from standard input. If the -f option is specified, the names are interpreted as file names. Otherwise the names are interpreted as compilation unit names.
-v
Verbose output.
-L sublib
Specifies the sublibrary where the named unit is located (default is adalib).
-u
Indicates that the names specified are compilation unit names (this is default case if neither -f nor -u is specified).
-f
Indicates that the names specified are source file names, not compilation unit names. All units associated with each of the source file names will be hidden, as well as the file itself.
-r
Restore the hidden file or unit.
-m dest
Move the file or unit to the specified destination directory or sublibrary.

PARAMETERS

names
Specifies the names of the compilation units or source files that will be used in the aprojhide operation.

FILES

$POWERADA/bin/aprojhide - the aprojhide program image.

ENVIRONMENT VARIABLES

POWERADA
This must be defined and indicate the powerada/ada95 directory in the PowerAda installation.
POWERADA_BASELINES
Names a baselines file identifying aliases for baseline projects.

EXAMPLES

BUGS/LIMITATIONS

See Problems and Questions at the beginning of this Appendix.