s_combine



NAME

      system combine - Copies selected versions of RCS files from one system
      configuration to the original one.


SYNOPSIS

      system combine [options] system_path [dest_config]


DESCRIPTION

      The system combine command checks out specified versions of files
      placed in RCS libraries in a system configuration or a part of it and
      checks in these versions, with the same revision number, into the RCS
      libraries of the parent system configuration. After the files are
      combined into the original libraries, the RCS directories in the
      specified system configuration are removed and links to the RCS
      libraries in the parent configuration are created. If a subsystem
      exists only in the new configuration, it is kept there, but it is
      initialised, i.e. only one version of the files are left.

      The command system info -r  shows the parent configuration.

      If the configuration should be combined into another configuration
      than the parent one, use the parameter dest_config.

      The command system info -R shows which RCS libraries are defined as
      links and which are defined as directories.

      Files with status Unchanged are not copied to the destination
      directory.

      RCS libraries that are defined as links to other configurations are,
      by default, not processed for combining.

      By default, the latest versions of all files are taken.

      Before a configuration can be combined, it must be checked. The
      command starts with check of the configuration.  Together with the
      option -a the command also does combine the configuration, not only
      checks it.

      If -b option is used, every selected file will be combined into a file
      branch in the destination RCS libraries. 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
      system_path
           Specifies a system configuration or a subsystem in a system
           configuration as a top of the directory structure that will be
           processed.

      dest_config
           If specified this configuration is used as destination instead of
           the parent configuration.

    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.

      -nt  Apply the command on only the specified directory, instead of the
           complete directory tree, starting from the system_path specified.

      -i   Ask for each subsystem if it should be initiated or not.

      -nm  Keep the RCS source directory and no not create a link to the
           destination directory. Default is to delete the RCS source
           directory and to create a link to the destination 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 configuration, combine the RCS libraries.
           If not specified only check if the configuration can be combined
           is done. The default is to do only check of the configuration.

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

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

      -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

      system combine -a -r R2_0_0 sys1/R2_0_0

      copies all the file versions specified by the symbolic name R2_0_0
      from the system configuration R2_0_0 to the parent system
      configuration. The command starts with check of the configuration.

      system combine -a -r R2_0_0 -b sys1/R2_0_0

      copies all the file versions specified by the symbolic name R2_0_0
      from the system configuration R2_0_0 to the parent system
      configuration, and creates a branch for each copied file in the parent
      RCS libraries. The command starts with check of the configuration.


SEE ALSO

      ci(1), co(1), rcs(1), rcscomb(1), s_info(1), checkcomb(1)


AUTHOR

      Ivica Crnkovic, Elisabet de Waal