aelcf(1)

NAME
aelcf - list change files

SYNOPSIS
aelcf [ option... ]
aelcf -Help
aelcf -VERSion

DESCRIPTION
The aelcf command is used to list the files which make up a change. The file names are printed one per line on the output.

If there are no files matching your criteria (see below) the output will be empty, and no error will be issued.

This is very similar to the aegis -l cf listing, but it only lists file names, it lists no other attributes, and it is considerably faster.

If your filenames have newlines in them, you have a problem. You can use any of the posix_filename_charset, dos_filename_required, windows_filename_required, or shell_safe_filenames fields in your project configuration file to prevent this. See aenf(1) and aepconf(5) for more information.

OPTIONS
The following options are understood:

-ACtion name
    This option may be used to specify which file actions you are interested in. Valid values are "create", "modify", "remove", etc, as may be observed in the Action column of the aegis -l pf listing. The default is to list files with all actions except removed files. You may use this option more than once.

-Not_ACtion name
    This option may be used to exclude an action from the listing. If no actions are explicitly included or excluded, the default is to exclude removed files. You may use this option more than once.

-USAge name
    This option may be used to specify which file usages you are interested in. Valid values are "source", "test", etc, as may be observed in the Usage column of the aegis -l pf listing. The default is to list files with all usages. You may use this option more than once.

-Not_USAge name
    This option may be used to exclude usages from the listing. The default is to exclude no usages. You may use this option more than once.

SEE ALSO

ael(1)
    list interesting things

aelpf(1)
    list project files

aenf(1)
    add new files to be created by a change

aepconf(5)
    project configuration file