s_establish



NAME

      system establish - Establish a system configuration.


SYNOPSIS

      system establish [options] system_path [dest_config]


DESCRIPTION

      The system establish  command combines the RCS libraries to the RCS
      libraries in the parent configuration. Optionally it removes all the
      working versions of files from the RCS libraries. It also defines a
      status and a symbolic name for the files kept in the library. By
      default also the read only access is defined for the complete system
      configuration structure.

      RCS libraries that are defined as links to other configurations are
      not processed.

      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 that are defined
      as links and which are defined as directories.

      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, or
      the default name if the -n option is not specified.

    PARAMETERS
      system_path
           Specifies a system configuration or a subsystem in a system
           configuration as a top of a directory structure which will be
           established.

      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.

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

      -k   Keep the RCS directories, remove all working versions.

      -K   This only works together with -k.  Do not remove the versions
           after the selected version of each copied file, from the RCS
           library (RCS/file,v). The default is to only save the selected
           version of the file in the RCS library. Status and eventual name
           are set on the selected version of the file.


      -nrl This only works together with -k.  Do not remove eventual lock
           from each file, warning messages will be sent for this version of
           the file. The option may be useful together with -k option, when
           the locked version is a version that should be kept anyway.
           Default is to remove the lock from the file version, and remove
           the file version if it is not needed.

      -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 combined or not.

      -n name
           Specify a new symbolic name for all files in the new RCS library.
           By default name is defined from the configuration name (example:
           configuration 1.0-0. The name is R1_0_0).

      -c cmode
           Set read-write-execute access on the structure. By default the
           "g-w" (group have no write acess) access is defined.

      -S state
           Specify a new state for the files in the new RCS library. By
           default, state is defined to "Rel".

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

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

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


SEE ALSO

      ci(1), co(1), rcs(1), s_combine(1), s_rcsiniw(1), s_info(1),
      checkcomb(1)


AUTHOR

      Ivica Crnkovic, Elisabet de Waal