Next: depopulate, Previous: checkout, Up: Subcommands
ADDITIONAL OPTIONS: ‘-d’, ‘-u’, ‘--no-keywords’
Add each file in the file-or-dir list to the Files list of the .prj file identified by project, without modifying the repository. For each directory in file-or-dir, recursively adds all files in that directory structure (or the directory itself, if it is empty). The file-or-dir operand list defaults to the current directory.
Without the ‘-d’ option, any files already in the Files list remain there unchanged. With ‘-d’, populate will prompt you about removing files from the Files list that are listed there as appearing under one of the directories given in the file-or-dir list, but are not found in the working directory. With ‘-d’ and ‘-f’, it will remove them silently.
For example, suppose the file P.prj lists files C, D1/A, D1/B, D2/A, D2/B. Suppose a working directory contains files A, D1/B, and D2/B. Then the command
prcs populate -d Pwould remove files C, D1/A, and D2/A from the Files list of P.prj, and add file A. For the same initial P.prj file, the command
prcs populate -d P D1would remove D1/A from P.prj, and would add nothing.
New files are added with null internal file identifiers. Populate attempts to fill in the
:symlink
and:directory
options. It also applies a heuristic test to each file added to guess whether it is a non-text file; for each file it judges to be a non-text file, it includes the:no-keywords
option for that file (see Files attribute).