rcscomb



NAME

      rcscomb - Copies selected versions of RCS files from one RCS library
      to another.


SYNOPSIS

      rcscomb [options] files RCS_dest


DESCRIPTION

      The rcscomb command checks out specified versions of files placed in
      the RCS source library and checks them in the RCS_dest library. The
      files are checked in into the RCS_dest library with the same version,
      as when checked out from the source library.

      Optionally the source RCS library is deleted and instead of it a link
      to the destination RCS library is created.

      Before the combining is done, the RCS library must be checked, this is
      default. If option -a the RCS library is also combined.

      If -b option is used, every selected file will be combined into a file
      branch in the destination RCS library. The file branch will be created
      from the version copied when creating the work directory.

      The CR directory (including Change Requests) is kept as is, CRs with
      the state Rel get the symbolic name specified with the -n option.

    PARAMETERS
      files
           Specifies which files will be taken to the new RCS library. All
           specified files that match values defined by options are put in
           the new RCS. Normally all files from the source RCS directory are
           taken.

           If in the destination RCS directory a file version with the same
           name already exists, or if the version numbers of the files are
           the same, then the version is not copied, but all the names that
           belong to the source file version are added to the corresponding
           version in the destination RCS library. The file is checked in
           with the same version as in the source directory, this means that
           not all file version numbers will be used in the destination
           directory.

           Files with status Unchanged are not copied.

           If no option is specified then the latest versions are copied.

      RCS_dest
           Specifies the RCS directory where the RCS files are combined
           into.


    OPTIONS
      -r rev
           Select the latest version of files whose number is less than or
           equal to rev. If rev indicates a branch rather than a version,
           the latest version on that branch is retrieved. If -r rev is
           omitted, the latest version on the default branch is retrieved.
           If rev is $, the command determines the version number from
           keyword values in the working file. Otherwise, a version is
           composed of one or more numeric or symbolic fields separated by
           periods.

      -s state
           Select the latest version on the selected branch whose state is
           set to state.

      -w login
           Select the latest version on the selected branch which was
           checked in by the user with login name login.

      -x suffixes
           Select files specified by the suffixes for RCS files. A nonempty
           suffix matches any pathname ending in the suffix. An empty suffix
           matches any pathname of the form RCS/file or path/RCS/file. The
           -x option can specify a list of suffixes separated by /. For
           example, -x ,v/ specifies two suffixes: ,v and the empty suffix.
           If two or more suffixes are specified, they are tried in order
           when looking for an RCS file; the first one that works is used
           for that file. If no RCS file is found but an RCS file can be
           created, the suffixes are tried in order to determine the new RCS
           file's name. The default for suffixes is installation-dependent;
           normally it is ,v/ for hosts like Unix that permit commas in file
           names, and is empty (i.e. just the empty suffix) for other hosts.

      -d date
           Select the latest version on the selected branch whose checkin
           date/time is less than or equal to date. The date and time may be
           given in free format. The time zone LT stands for local time;
           other common time zone names are understood. For more detail see
           the co(1) command.

      -g grp
           Select files that belong to the group grp.

      -m   Delete the RCS source directory and create a link to the
           destination RCS directory.

      -n name
           Specify a new symbolic name for all files in the new RCS library.

      -S state
           Specify a new state for the files in the new RCS library.

      -M message
           Specify a log message for the files checked in into the new RCS
           library. By default message is set to "Combined version".

      -a   Do an "action" on the directory, combine the RCS libraries.  If
           not specified, only check if the library can be combined. The
           default, is to do only check of the library.

      -v   List which files are copied into new RCS library from the old
           RCS.

      -b   Create a branch for each selected file when combining it into the
           RCS_dest library. Files with status Unchanged will also be copied
           into a branch in the destination RCS library.

      -f   Forces combining of a version, even if warnings are got during
           the check step. Only file versions which do not have later
           versions in the file can be combined. For example, a file with
           version 1.3 can be combined only if the file version in the
           destination directory is 1.2 or lower.


EXAMPLES

      rcscomb -a -r R1_0_0  /rel/RCS

      copies all the file versions specified by the symbolic name R1_0_0
      from the RCS library placed in the current directory to the /rel/RCS
      directory. The command starts with check of the library.

      rcscomb -a  /rel/RCS

      takes the latest versions of all the files from the RCS library in
      current directory and copies them to /rel/RCS. The command starts with
      check of the library.

      rcscomb -a -b  /rel/RCS

      takes the latest versions of all the files from the RCS library in
      current directory and checks them into /rel/RCS as a branch. The
      command starts with check of the library.


SEE ALSO

      ci(1), co(1), rcs(1), s_combine(1)


AUTHOR

      Ivica Crnkovic, Elisabet de Waal