PowerAda aprojls
Contents
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
, andadalib.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.