Importing RCS data

About this task

This example demonstrates the use of command-line tools to import data from an RCS source tree on Linux or the UNIX system to a new VOB. The root of the RCS tree is /usr/libpub on a host where the empty VOB has already been activated, at /vobs/libpub.

Procedure

  1. Create the data file.
    1. Go to the source data.
      Change to the root directory of the existing RCS source tree:

      cd /usr/libpub

    2. Run the export utility.
      Use clearexport_rcs to create the data file and place descriptions of RCS files (,v files) in it:

      clearexport_rcs
      Exporting element "./Makefile,v" ...
      Extracting element history ...
      .
      Completed.
      Exporting element ...
      Creating element ...
      Element "./Makefile" completed.
        .
        .
      Element "./lineseq.c" completed.
      Creating datafile ./cvt_data ...

      The data file, cvt_data, is created in the current directory.
  2. Import the data file.
    1. Use any view. clearimport ignores the config spec.
      Using a dynamic view improves the performance of the import operation.
    2. Go to the target VOB.
      Change to the root directory of /vobs/libpub:

      cd /vobs/libpub

    3. Run clearimport.
      Run clearimport on the data file, cvt_data, to populate /vobs/libpub:

      clearimport /usr/libpub/cvt_data
      Converting files from /usr/libpub to .
      Created element "././Makefile" (type "text_file").
      Changed protection on "././Makefile".

      Making version of ././Makefile

      Checked out "././Makefile" from version "/main/0".
      Comment for all listed objects:
      Checked in "././Makefile" version "/main/1".
        .
        .

      There is no need to check out or check in the VOB’s root directory element; this is handled automatically. If problems cause clearimport to terminate prematurely, you can fix the problems and run clearimport again.