Next: , Previous: checkout, Up: Subcommands


6.5 Prcs populate

— Command: prcs populate [option ...] [project [file-or-dir ...]]

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 P

would 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 D1

would 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).