

GET (1)                        9/14/81                         GET (1)


NAME 
       get - get generation from TCS file

SYNOPSIS 
       get [-h][-rM.N] historyfile [resultfile]

DESCRIPTION 
       Get  retrieves  earlier versions of text from "historyfile"  as
       computed by DELTA. 
       
       The possible flags are:
       
                 (none)  -  The  latest  version  of   the   file   is
                 retrieved. 
                 
                 -h  -  Print  out  the history information associated
                 with the versions.  The dates, times,  and  user  IDs
                 will  be  retrieved,  along  with  the comments added
                 while performing the DELTAs. 
                 
                 -rM.N - Retrieve the specified version M.N  into  the
                 "result" file. 
       
       The  retrieved  version  will  be  put  in the "result" file if
       specified,  otherwise  it  is  sent  to  the  standard  output.
       History information is always sent to the terminal. 

FILES 
       None

SEE ALSO 
       ADMIN, DELTA. 
       "The  Source  Code  Control  System", by Marc J. Rochkind, ____IEEE
       ____________Transactions  __on  ________Software  ___________Engineering,  Vol.  Se-1,  No.   4,
       December 1975. 

EXAMPLES
       get program.tcs program
            Retrieve  the  latest  version  of  the  program stored on
            "program.tcs", placing it on the file "program". 

       get -h program.tcs
            Print out the history  of  changes  made  to  the  program
            stored on "program.tcs". 

       get -r1.13.2 tcsfile
            Print  (on  standard  output) the version number 1.13.2 of
            the text stored in "tcsfile". 

       Text is stored in TCS format by calling "admin",  and  versions
       are created by using the tool "delta". 

DIAGNOSTICS 
       Usage: get [-h][-rM.N] historyfile [resultfile]
                 Correct   calling  format  is  provided  when  called
                 without arguments. 


                                 -1-


GET (1)                        9/14/81                         GET (1)


                 
       Unexpected EOF on history-info scan. 
       The source file does not contain the code which  identifies  it
                 as  a  TCS history file.  The code may be entered via
                 the ADMIN command. 
                 
       Unexpected EOF on history-data scan. 
                 The file format has been  tampered  with  and  is  no
                 longer recognizable.  Refer to a guru for repair. 
                 
       - missing from keyletter
                 First   argument   is  expected  to  qualify  whether
                 versions and/or histories are to be extracted. 
                 
       Illegal keyletter
                 Only 'h' and 'r' are valid keys. 
                 
       Nonexistant revision level requested. 
                 The version number specified is not contained in  the
                 history.   Try "get -h file.tcs" to view the versions
                 available. 
                 
       Invalid history file
                 The history  file  specifies  impossible  line-number
                 correlations.    Either  out-of-sequence  changes  or
                 line numbers in descending order. 
                 
       Cannot locate TCS history file. 
                 Could not find file supplied for historyfile. 
                 
AUTHORS 
       An Algorithm for Differential File Comparison by  J.W.Hunt  and
       M.D.McIlroy  (BTL  Computing  Science  Technical  Report  #41).
       Original code by Wil Baden;  converted  from  MORTRAN  by  Dave
       Murray.   Modifications  and  conversion  to  BTL-SCCS style by
       Neil Groundwater at Analytic Disciplines Inc. 

BUGS/DEFICIENCIES 




















                                 -2-

