


TWFREEZE(1)               User Commands               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.

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.




SunOS 5.5        Last change: 01 September 1996                 1






TWFREEZE(1)               User Commands               TWFREEZE(1)



     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 TeamWare User's Guide
     freezept(1), freezepointfile(4),  bringover(1),  resolve(1),
     sccs(1)





















SunOS 5.5        Last change: 01 September 1996                 2



