Man Page twfreeze.1
NAME
twfreeze, freezepttool - generate or translate SCCS Merge-
able delta IDs for lists of files
SYNOPSIS
twfreeze [ -V ]
DESCRIPTION
twfreeze formerly known as freezepttool, is a graphical user
interface that 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 mani-
pulated by the teamware commands bringover(1) and resolve(1)
may have their SIDs renumbered over time, but the SMIDs for
the deltas do not change.
twfreeze defines a source file to be a file filename with a
corresponding SCCS file found in ./SCCS/s.filename.
Sun WorkShop TeamWare automatically creates freezepoint
files if you turn on autofreezepointing. You can access
autofreezepointing through Configuring. Choose Workspace >
Properties > Freezepointing tab.
OPTIONS
-V Displays the version being run.
To start twfreeze, type twfreeze at a shell prompt. When
twfreeze starts, the Workspace field is initialized with the
value of the shell environment variable CODEMGR_WS if it is
set. If not, and if the current directory is contained
within a workspace, then the Workspace field is initialized
with the containing workspace. All file names in the
freezepoint file are relative to the workspace.
To create a list of directories and files that you want
archived in a freezepoint file, select the File -> Add Files
to List menu item. This invokes a point-and-click file
chooser that you can use to create a list of directories and
files in the Directories and Files pane.
The default name of the freezepoint file is freezepoint.out.
If you want a different name, edit the Freezepoint field.
To create the freezepoint, choose the Create button.
A freezepoint file contains one line per source file and
identifies the current default delta for that source file.
Identification is not done using SCCS SIDs, because they may
be renumbered by Code Manager operations. Instead, deltas
are identified by SCCS Mergeable IDs, (SMIDs) that do not
change even when the SIDs are renumbered. See
freezepointfile(4) for more information.
To extract a freezepoint, change the Category to Extract and
fill in the Freezepoint and the Destination Directory
fields. If the Workspace field is not filled in, the
workspace name stored in the freezepoint file will be used.
The Destination Directory must specify an empty or new
directory.
Choosing the Extract button causes a series of sccs get
operations to be performed on the source files listed in the
freezepoint file. The version of each file extracted is the
version specified by the SMID on its line in the freezepoint
file.
Note that the workspace used to perform an extract operation
need not be the same workspace that was originally used to
create the freezepoint file. Any copy or descendant of the
original workspace that contains all the source files listed
in the freezepoint file will work.
Files that have been renamed cause errors when they are
encountered during extraction. The freezepoint file does
contain enough information to verify that each file found by
name is the same file that held that name when the
freezepoint was created. This information can be used by
users of the command-line program freezept(1) to track down
renamed files and positively identify the desired files and
extract the desired deltas. See freezepointfile(4) for more
information.
SEE ALSO
Sun WorkShop TeamWare User's Guide
bringover(1), codemgr(1), def.dir.flp(1), dmake(1), freezept(1),
putback(1), rcs2ws(1), resolve(1), teamware(1), twbuild(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)