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 ] 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 subdirectories 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 TeamWare workspace. TeamWare was formerly known as CodeManager. If it names a directory that is not a 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.

    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 -n option shows what would be done without actually writing freezepoint-file.

extract [ -w workspace ] [ -k freezepoint-file ]
[ -d destination-dir] [ -n ] [ -q ]

    Using sccs get, extract the appropriate deltas from the files listed in freezepoint-file and create a new hierarchy under destination-dir. The workspace argument specifies a 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 specified as -, then the freezepoint is read from the standard input.

    If the -d option is not specified, the current directory ("dot") is used. The directory specified by destination-dir must either not exist or be empty.

    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.

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

SEE ALSO
TeamWare User's Guide

bringover(1), freezepointfile(4), resolve(1), sccs(1), twfreeze.1(1)