PowerAda aprojfind
Contents
NAME
aprojfind - an extension to the Unix 'find' command for PowerAda projects
SYNOPSIS
aprojfind -[hLNP] [project_path] [find_arguments | -S | -D ]
DESCRIPTION
aprojfind uses the GNU find tool in conjunction with knowledge of the project hierarchy to locate files, directories, and sublibraries within the project which match certain criteria.
The find_arguments that may be provided are a subset of those supported by the GNU find command. In particular, those options that specify the output format such as -exec, -ls, -ok, -printf, -print0 are not supported. The goal is to provide the maximum flexibility, sometimes at the risk of good error recovery.
OPTIONS
- -h
- Prints version, and command line help information..
- -D
- Shows only non-sublibrary directories
- -L
- Shows only files in local project (no shadows)
- -N
- Shows only newest of multiple shadows of a file
- -P
- Shows only project-relative names (implies -N)
- -S
- Shows only sublibrary directories
- find_arguments
- options passed to find command
PARAMETERS
- project_path
- The directory name of a path which includes the project root.
FILES
$POWERADA/bin/aprojfind - the aprojfind program image
$POWERADA/tools/bin/gfind - the GNU find command
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
# find all files in the project that have execute permission
aprojfind -type f -perm -100
# remove all the sublibraries in the working project:
rm -r 'aprojfind -LS'
SEE ALSO
aprojls
BUGS/LIMITATIONS
aprojfind doesn't do much checking of the find_options, but just passes them along to find. In particular, options which modify the output format will break aprojfind, which parses the output.
Also, see Problems and Questions at the beginning of this Appendix.