Node: Options, Next: , Previous: Specifying Files and Directories, Up: Subcommands



Options

This section collects definitions of options used in PRCS subcommands. Many options have both a short form (e.g., -f) and a GNU-format long form (e.g., --force); in these cases, the long form is listed immediately below the short form. In the descriptions below, a Standard option is one that is legal on all subcommands, and an Option is valid on one or more subcommands.

--all Option
Used in prcs execute to indicate that the specified command is to be executed just once, with all files as arguments.

-d Option
--delete Long Form
Tells PRCS to perform some optional deletion action. Used by prcs populate to indicate that files that are not present in a working directory are to be removed from the Files list.

-f Standard Option
--force Long Form
Force: resolve what would normally be interactive queries in some fixed way, depending on the subcommand, assuring that PRCS will never use the standard input.

-h Standard Option
-H Standard Option
--help Long Form
Prints out help very similar to the contents of this section.

-i Option
--immediate Long Form
Causes certain actions to occur immediately during execution of a command. For prcs uncompress, causes the files in a project to be uncompressed on the spot, rather than incrementally as they are needed.

-j number Standard Option
--jobs=number Long Form
Allows PRCS to spawn up to number child processes at once. Almost always, 2 or 3 will result in faster operations and higher machine load. Experimentation will yield the best results.

-k Option
--keywords Long Form
Causes prcs diff to compare keywords, instead of stripping them before comparison.

-l Standard Option
--long-format Long Form
-L Standard Option
--long-long-format Long Form
Various long formats, depending on the subcommand.

--match pattern Option
Used in prcs execute to indicate that the names of the files to be processed, or the options attached to them, must match pattern.

-n Standard Option
--no-action Long Form
Indicates that the command is to report what would happen in the absence of -n, without changing working files or the repository.

-N Option
--new Long Form
In prcs diff, produces comparisons against empty ("new") files where a file is missing in one of the versions being compared. If you intend to use the -N option and later apply the diffs you should make sure to always use one of the context diff formats. See the PRCS_DIFF_OPTIONS environment variable See Environment Variables.

--no-keywords Option
Causes prcs populate to add all files with the :no-keywords attribute.

--not pattern Option
Used in prcs execute to indicate that the names of files to be processed, or the options attached to them, must not match pattern.

--pipe Option
Causes prcs execute to supply file data as the standard input.

-p Option
--preserve, -@b{-}preserve-permissions, -@b{-}permissions Long Form
Preserve permissions on files that are checked out, ignoring any standard protections the user may have set for newly-created files (as by the file mode creation mask in UNIX).

-P Option
--exclude-project-file Long Form
Prevent situations where the project file may be treated as an ordinary file. For example, this causes prcs diff not to output changes in the project files of each version.

--plain-format Standard Option
Turns off PRCS's default formatting of its output, which is to break lines at the screen width and surround filenames with single quotes. Setting the PRCS_PLAIN_FORMAT environment variable has the same effect (see Environment Variables).

--pre Option
Used in prcs execute to indicate that directories are to be listed in pre-order: directory names first, then their non-directory contents, then subdirectories.

-q Standard Option
--quiet Long Form
Suppress normal informational messages.

-r version Option
--revision=version Long Form
Identifies a version of a project. The version is a version specifier. See Version Names and Specifiers. The space between -r and version is optional.

-R directory Standard Option
--repository=directory Long Form
Use directory as the repository, ignoring the value of the PRCS_REPOSITORY environment variable.

-s Standard Option
--skilled-merge Long Form
Turn off most of the safety features of prcs merge, allowing a skilled user finer control over the process. See merge.

--sort=type Option
Set the type of sorting for the info command to perform on its output. The two valid values for type are version and date. The default is version.

-u Option
--unlink Long Form
When PRCS writes a working file or the project file, it generally does so by replacing any existing file of that name. With this option, however, if the file to be written is a symbolic link, that link is removed and a new file is created. Thus, the file that was originally linked to is unchanged.

-v Standard Option
--version Long Form
Prints the version of PRCS and exits.

--version-log=new version log Option
Causes prcs checkin to set the Version-Log on the command line. You will be prompted if there is an existing New-Version-Log already. This option overrides the PRCS_LOGQUERY environment variable.

-z Option
--compress Long Form
Indicates that a command should perform (de)compression.