PowerAda aprojls

From OC Systems Wiki!
Jump to: navigation, search


NAME

aprojls - List files and units within a PowerAda project

SYNOPSIS

aprojls [-hadlpxFHPS] [paths ... ]

DESCRIPTION

aprojls produces text output which includes both local and shadowed files, directories, sublibraries, and units in the current project.

If no path is specified, the current directory is used.

If a path specified is a sublibrary, the units in the sublibrary are listed.

If a path specified is an adalib.imports file, the full list of sublibraries it represents is shown; with -P, only the unique project-relative sublibraries are shown.

The -l flag displays a variety of information about the entities shown, similar to that seen in a directory or sublibrary view within powerada, except all optional fields are provided. A pipe character ('|') in the first column indicates that the file or unit is local; a blank indicates the file is shadowed.

OPTIONS

-a
Show hidden files/units
-h
Prints version, and command line help information
-d
Don't show directory or sublibrary contents
-l
Long: show powerada info about each file
-p
List all files in the entire project
-x
Explode contents of special files: PowerAda executables, adalib.imports, and adalib.files
-F
Show fully-qualified names rather than names relative to the local directory names
-H
Show only hidden files
-P
Show project-relative names
-S
Show shadows, i.e., files/units in parent baselines "covered" by more recent files of the same project-relative path (implies -F)

PARAMETERS

paths
one or more directory, file or sublibrary names

FILES

$POWERADA/bin/aprojls - the aprojls 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

# use aprojls with aprojbuild to rebuild a possibly-shadowed
# executable
aprojbuild -lx 'aprojls -F my_program'
# list all the local and shadowed units in the local 
# sublibrary
aprojls -l adalib
#list all the local and shadowed units in the local executable
aprojls -x exe_name
# check the validity of your all your adalib.imports and by
# displaying any errors that result from "exploding" them
# (this will work for adalib.files, too):
find $(aprojinfo -rl1) -name adalib.imports |\
   xargs -s2000 aprojls -x > /dev/null # keep only stderr

SEE ALSO

aprojbaseline, aprojrm, powerada

BUGS/LIMITATIONS

See Problems and Questions at the beginning of this Appendix.