."
." Copyright (c) 1992 by Sun Microsystems, Inc.
."
." @(#)freezepttool.1	1.42	92/07/27 SMI
."
.TH TWFREEZE 1 "00/03/28  Sun WorkShop 6"
.ds ]W
.SH NAME
twfreeze, freezepttool \- generate or translate SCCS Mergeable delta IDs for
lists of files
.SH SYNOPSIS
.B twfreeze
[
.B \-V
]
.LP
.SH DESCRIPTION
.LP
.B twfreeze
formerly known as freezepttool, is a graphical user interface that reads 
.SM SCCS 
files and computes 
.SM SCCS 
Mergeable IDs 
.SM (SMIDs) 
for
the deltas in each file using the Xerox Secure Hash Function.  A 
.SM SMID
consists of four eight-digit hexadecimal numbers.  At any point in time, there
is a one-to-one correspondence between the 
.SM SMIDs 
and 
.SM SIDs 
for all
the deltas in a given
source file.  Source files that are manipulated by the teamware
commands 
.BR bringover "(1)" 
and 
.BR resolve "(1)" 
may have their 
.SM SIDs 
renumbered
over time, but the 
.SM SMIDs 
for the deltas do not change.
.LP
.B twfreeze
defines a source file to be a file 
.I filename 
with a corresponding
.SM SCCS 
file found in 
.BI ./SCCS/s. filename.
.LP
TeamWare automatically creates freezepoint files if you turn on autofreezepointing.
You can access autofreezepointing through Configuring. Choose Workspace > Properties >
Freezepointing tab.
.LP
.SH OPTIONS
.TP
.B \-V
Displays the version being run.
.LP
To start 
.BR twfreeze ,
type 
.B twfreeze
at a shell prompt. When 
.B twfreeze
starts, the Workspace field is initialized with
the value of the shell environment variable
.SM 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.
.LP
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.
.LP
The default name of the freezepoint file is 
.BR freezepoint.out .
If you want a different name, edit the Freezepoint field.
.LP
To create the freezepoint, choose the Create button.
.LP
A freezepoint file contains one line per source file and identifies
the current default delta for that source file.  Identification is
not done using 
.SM "SCCS SIDs," 
because they may be renumbered by Code Manager operations.
Instead, deltas are identified by 
.SM SCCS 
Mergeable IDs, 
.SM (SMIDs)
that do not
change even when the 
.SM SIDs 
are renumbered.  See 
.BR freezepointfile (4)
for more information.
.LP
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.
.LP
Choosing the Extract button causes a
series of \fBsccs get\fP 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 
.SM SMID 
on its line in the freezepoint file.
.LP
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.
.LP
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
.BR freezept (1)
to track down renamed files and positively identify the desired files and
extract the desired deltas.  See
.BR freezepointfile (4)
for more information.

.SH "SEE ALSO"
.IR "Sun WorkShop TeamWare User's Guide"
.LP
.sp 
.nf
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)