s_rcsiniw



NAME

      system rcsiniw - Initiate a system configuration for work.


SYNOPSIS

      system rcsiniw [options] system_path


DESCRIPTION

      The system rcsiniw command prepares a system configuration or a part
      of it for a new work session. For the specified configuration, or for
      a part of it, the command looks for the RCS directories placed in each
      subsystem. If a RCS library is defined as a symbolic link, it removes
      the link and creates a new RCS directory. The files are copied from
      the original RCS directory to the created RCS directory. After the
      copying all file versions except one (default latest version) are
      purged.  In this way the new RCS directory gets one (working) version
      of every file.

    PARAMETERS
      system_path
           Specifies a system configuration or a subsystem in a system
           configuration that will be initiated.

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

      -e   Keep the subsystem directories empty, i.e. do not check out the
           working versions of files.

      -nt  Do not apply the command on the complete directory tree, but only
           on the directory specified with system_path.

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

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

      -b   Create a branch for all files in each sub-directory. The branch
           is created from the copied file version.  Default is to create it
           as the first branch from the file version, if a branch already
           exist from this file version, a new branch is created with an
           incremented branch number.

           The first version in the branch has the same file contents as the
           copied file version.  The file version in the branch will have
           the state specified by the option -S.

           The created branch is set to default, i.e. the files will be
           checked out and checked in to this branch by default, without
           giving any revision number.

      -br branch_rev
           Same as -b. The only difference is that all files will have the
           revision specified by branch_rev.

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

      -o   Even if the starting RCS library is not a link but a sub-
           directory, initiate it. If the option is omitted, the RCS
           directory will be kept in its original form.

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

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

      system rcsiniw -r R1_0_0 system1/R2_0_0

      initiates the R2_0_0 configuration of the system system1.


SEE ALSO

      checkin(1), checkout(1), rcs(1), rcsiniw(1), s_newconf(1)


AUTHOR

      Ivica Crnkovic, Elisabet de Waal