NAME

      systemNewconf - create a new system configuration


SYNOPSIS

      systeNewconf [-f] [-v] [-nco] [-r rev] [[-w] [-b] [-k] [-br b_rev]
      [-nrl]] [system ] [old_configuration] [new_configuration]


DESCRIPTION

      The system newconf command creates a new configuration (release)
      structure under the system directory. The new configuration is copied
      from an old one, so that it looks exactly the same as the old
      configuration after the creating. The files are, however, not copied,
      but links to them are created. The directory structure of the new
      configuration is the same as for the old one. This directory structure
      should later be used for an integration of the new release. The
      directory structure below is created.

    PARAMETERS
      system
           The system name including the system path.

      old_configuration
           The name of an existing system configuration.

      new_configuration
           The name of the configuration to be created.

      -v   Shows which directories have been created. List all the
           subsystems that are initiated and all the files copied to the new
           RCS libraries.

      -nco Do not check out files from the RCS libraries when the
           configuration is created. Default is to check out the files.

      -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 option -r is
           omitted then the name of the old configuration is taken as rev.
           In the case that the configuration is specified as x.y-z, where
           x,y and z are numbers, the corresponding symbolic name will be
           Rx_y_z.  If rev is specified as latest than the latest versions
           of the files will be copied to the new RCS libraries.  Otherwise,
           a version is composed of one or more numeric or symbolic fields
           separated by periods.

      -w   Initiate the new configuration. For each subsystem creates a new
           RCS library (instead of having a symbolic link to the original
           library), and copies a particular version of files to the new
           library.

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

           Used with the -w option.

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

           Used with the -w option.


EXAMPLES

      systemNewconf -nco ex_system 1.0-0 1.1-0

      System ex_system configuration 1.1-0 is created

      systemNewconf -w -r latest 1.0-0 1.1-0

      creates a new configuration and initiates it. The latest versions of
      files from 1.0-0 are copied to the 1.1-0 configuration.

      systemNewconf -w -r latest -b 1.0-0 1.1-0

      creates a new configuration and initiates it. The latest versions of
      files from 1.0-0 are copied to the 1.1-0 configuration, all files will
      have a branch in the new configuration.


AUTHOR

      Elisabet de Waal