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.
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.
|
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.
|
Causes prcs populate to add all files with the :no-keywords
attribute.
|
Used in prcs execute to indicate that the names of files to be
processed, or the options attached to them, must not match pattern.
|
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).
|
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.
|
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.
|