rcsiniw



NAME

      rcsiniw - Initiate a RCS directory for new work session.


SYNOPSIS

      rcsiniw [options] [files]


DESCRIPTION

      The rcsiniw command prepares a work directory and belonging RCS
      directory for a new work session. It looks for the RCS directory
      placed in the current directory. If the RCS library is defined as a
      symbolic link, it removes the link and creates the RCS directory
      instead of link. 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 each file. If the RCS
      library is not defined as a symbolic link, but as a directory, then
      all the working versions are kept in the RCS if the option -o is not
      specified.

      CRs (Change Requests) in the CR directory are copied to the new
      configuration, CRs with the states Rel or Obsolete are not copied.

      Note: The command produces a file in the current directory (.rcsiniw).
      The file contains a list of all files and which versions that are
      initiated. This list must not be removed.

    PARAMETERS
      files

      Specifies which files will be taken in the new working structure. All
      specified files that match values defined by options are put in the
      new RCS. Normally no file should be specified, which means that all
      files, will be taken into account.

    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.  If no option is
           specified the latest versions are used.

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

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

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

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

      -S state
           Specify a new state for the files in the new RCS library. Default
           is to set it to Unchanged.

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


EXAMPLES

      rcsiniw -r R1_0_0

      copies all the file versions specified by the symbolic name R1_0_0
      from the RCS library pointed by the RCS link from the current
      directory, creates the RCS subdirectory and stores the files in the
      new RCS library.

      rcsiniw

      takes the latest versions of all the files from the original RCS
      library.

      rcsiniw -b -r R1_0_0
      copies all the file versions specified by the symbolic name R1_0_0
      from the RCS library pointed by the RCS link from the current
      directory, creates the RCS subdirectory and stores the files in the
      new RCS library.  Then it creates a branch for each copied file, and
      sets the created branch to default for each file.

      rcsiniw -br 3.1 -e
      copies the latest versions of all the files from the original RCS
      library.  Then it creates a branch for each copied file, the version
      of each file will be named copied_file_version.3.1. The created branch
      is set to default for each file.
      The files will not be checked out from the RCS library.



SEE ALSO

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


AUTHOR

      Ivica Crnkovic, Elisabet de Waal