Man Page freezept.1
NAME
freezept - generate or translate SCCS Mergeable delta IDs
for lists of files
SYNOPSIS
freezept command args ...
DESCRIPTION
The freezept command reads SCCS files and computes SCCS
Mergeable IDs (SMIDs) for the deltas in each file using the
Xerox Secure Hash Function. A SMID consists of four eight-
digit hexadecimal numbers. At any point in time, there is a
one-to-one correspondence between the SMIDs and SIDs for all
the deltas in a given source file. Source files that are
manipulated by the Code Manager commands bringover(1) and
resolve(1) may have their SIDs renumbered over time, but the
SMIDs for the deltas do not change.
The freezept command defines a source file to be a file
filename with a corresponding SCCS file found in
./SCCS/s.filename.
USAGE
create [ -w workspace ] [ -k freezepoint-file ]
[ -c comment ] [ -n ] [ -q ]
[ -t YYYY/MM/DD[/hh/mm/ss] ] [ -z ] files or dirs
Create the freezepoint file for the specified files and
directories from within workspace and write the
freezepoint to freezepoint-file. Given a directory
name, freezept create recursively looks for SCCS sub-
directories and processes the SCCS history files found
within them.
Workspace is written into freezepoint-file for possible
use by extract.
The workspace argument is expected to specify a Sun
WorkShop TeamWare workspace. Sun WorkShop TeamWare was
formerly known as CodeManager. If it names a directory
that is not a Sun WorkShop TeamWare workspace, then a
warning is issued. If the -w option is not specified,
then the value of the shell environment variable
CODEMGR_WS is used. If CODEMGR_WS is not set and the
current directory is contained within a workspace, the
containing workspace is used.
If the -k option is not specified, the freezepoint is
written to the file freezepoint.out. If freezepoint-
file is specified as -, then the freezepoint is written
to the standard output and the -q option is implied (to
avoid mingling with the normal output).
The -c option specifies a comment to be included in the
freezepoint file. If the -c option is not specified,
freezept prompts for a comment from the standard input.
The -n option shows what would be done without actually
writing freezepoint-file.
As each file is processed, a line is written to the
standard output naming the file and the SID of the
delta being freezepointed. The -q option suppresses
these messages.
The -t option allows you to create a freezepoint file
based on a date. The date format is
YYYY/MM/DD[/hh/mm/ss]. For example,
example% freezept -w myws -t 1999/05/24/23/45/00
creates a freezepoint file that represents the state of
workspace on 24th of May 1999 at 23:45:00.
If the -z option is specified, the freezepoint file is
compressed with the /bin/compress command. A compressed
file has a .Z extension.
diff file1 file2
Displays the differences between two freezepoint files.
extract [ -w workspace ] [ -k freezepoint-file ]
[ -d destination-dir] [ -f filelist ] [ -n ]
[ -q ] [ -o ] [ -x ]
Using sccs get, extract the appropriate deltas from the
files listed in freezepoint-file and create a new
hierarchy under destination-dir. The workspace argu-
ment specifies a Sun WorkShop TeamWare workspace that
contains the SCCS history files from which to extract.
If workspace is not specified, the workspace stored in
freezepoint-file is used.
If the -k option is not specified, the file
freezepoint.out is read. If freezepoint-file is speci-
fied as -, then the freezepoint is read from the stan-
dard input.
If the -d option is not specified, the current direc-
tory ("dot") is used. The directory specified by
destination-dir must either not exist or be empty.
By default, freezept extracts all files whose names
appear in the freezepoint file. The -f option extracts
a subset of the list of files that appears in the
freezepoint file. filelist is a file that contains the
relative path names of the files to be extracted. These
names must be listed exactly as they appear in the
freezepoint file.
As each file is processed, a line is written to the
standard output naming the file and the SID of the
delta being extracted. The -q option suppresses these
messages.
The -n option shows what would be done without actually
extracting any files.
By default, freezept only writes to an empty directory.
Specifying the -o option authorizes freezept to
overwrite the contents of the destination directory.
The -x option directs freezept to create a workspace in
the destination directory and reconstruct the SCCS his-
tory of each file up to and including the version named
in the freezepoint file.
If some of the required SCCS files are found but others
are missing, the missing files are noted in warnings.
Rename support is not implemented.
smid [ -w workspace ] [ -r SID ] [ -a ] file
Translate SID to a SMID for the specified file. If SID
is specified, just print the translation for that SID.
If the -a option is present, display the entire SMID =
SID translation for the file; for example, each SMID
and SID for each delta in the file.
sid [ -w workspace ] [ -m "SMID" ] [ -a] file
Translate SMID to its equivalent SID for the specified
file. If SMID is specified, just print the translation
for that SMID. If the -a option is present, display the
entire SID = SMID translation for the file. For exam-
ple; each SID and SMID for each delta in the file.
Note that because a SMID contains three blank spaces
between the four hex digits, it is necessary to enclose
the SMID argument in quotation marks on the command
line so that it is parsed as a single argument.
update [ -w workspace ] [ -k freezepoint-file ]
[ -c comment ] [ -n ] [ -q ] files or dirs
Performs the same function as the create subcommand
except that freezepoint-file is updated rather than
created from scratch.
SEE ALSO
Sun WorkShop TeamWare User's Guide
bringover(1), codemgr(1), def.dir.flp(1), dmake(1), putback(1),
rcs2ws(1), resolve(1), teamware(1), twbuild(1), twfreeze(1),
twmerge(1), twversion(1), workspace(1), ws_undo(1),
access_control(4), args(4), children(4), conflicts(4),
description(4), freezepointfile(4), history(4), locks(4),
nametable(4), notification(4), parent(4), putback.cmt(4)