rcs2atfs - Online in the Cloud

PROGRAM:

NAME

rcs2atfs - convert RCS archives to AtFS format

SYNOPSIS

rcs2atfs [-o outputfile] [ -q] archive ...
rcs2atfs [-o outputfile] [ -q] -R directory ...

DESCRIPTION

Rcs2atfs converts version histories from RCS archives to ShapeTools' AtFS format. It uses
rlog(1) to get information about an RCS archive and issues shell commands (usually through
a pipe directly to /bin/sh) to check out the RCS revisions and check the files in as AtFS
versions, trying to keep as many attributes as possible.

The RCS archives are left unchanged.

It is recommended to create a special directory with the name RCS for the RCS archives,
but AtFS histories are always kept in a special directory AtFS.

Rcs2atfs treats its arguments as names of RCS archives. These can be the names of the
archive files themselves, ending with ,v, or the names of the files stored in the
archives.

If the -R option is given, the arguments are interpreted as directory names. Rcs2atfs
recursively descends each directory tree (symbolic links are followed) and converts the
RCS archives it finds. The correspondig AtFS archives are created where the RCS archives
are found.

Rcs2atfs tries to keep the revision numbers of the RCS history also as AtFS version
numbers. This is impossible if an RCS history contains branches. In this case the
revisions are saved as AtFS versions in the order of their check-in date. In either case
the RCS revision number is kept as a symbolic name for the corresponding AtFS version,
e.g. the AtFS version of RCS revision 1.2 will have the symbolic name ``r1.2''.

Attributes that don't change:
·
author

·
log message

·
comment leader

·
description

·
symbolic names (with the exception of the additional symbolic name derived from the RCS
revision number)

Other attributes:
mtime set to the check-in date of the RCS revision

state The value of this attribute is given to the AtFS attribute RCSstate. If it has the
value Exp, the state of the AtFS version will be saved, if Stab, it will be
proposed, if Rel, it will be published.

OPTIONS

-R (recursive)
The arguments are treated as directories. Rcs2atfs recursively descends the
directory tree (symbolic links are followed) and builds an AtFS archive for each
RCS archive it finds.

-o outputfile
rcs2atfs writes shell commands to outputfile, not directly to /bin/sh, and no
conversion is done. If this shell script is executed from the directory where
rcs2atfs was invoked, the archives are converted as if rcs2atfs had been invoked
without -o.
The main use of this option is to investigate problems with the conversion of
archives.

-q (quiet)
The names and revision numbers of converted archives are not echoed on standard
output.

EXAMPLES

The command

rcs2atfs -R $HOME/development

traverses the directory tree $HOME/development and converts every RCS archive in it into
an AtFS archive. During the conversion, the name of every RCS archive and every revision
number is echoed on standard output.

rcs2atfs -q RCS/*

Each archive in the RCS directory is converted to an AtFS history. The names and revision
numbers of the converted archives are not echoed.

Use rcs2atfs online using onworks.net services