."
." Copyright (c) 1991 by Sun Microsystems, Inc.
."
." @(#)history.4	1.5	92/01/31 SMI
."
.TH HISTORY (4) "01 December 1992"
.SH NAME
history \- Workspace command and file-change log
.SH SYNOPSIS
.B Codemgr_wsdata/history
.LP
.SH DESCRIPTION
TeamWare commands are logged in the text file 
.BR Codemgr_wsdata/history. TeamWare was formerly known as CodeManager. 
Commands that effect a single workspace are logged only in that workspace;
interworkspace transactions are logged in both the source and destination
workspaces.  Note that although command entries are logged in both the source
and destination workspaces, the list of changed files is entered only in the
destination directory.
.LP
You can view the contents of this file to track or reconstruct changes that
have been made to a workspace over time.  The following portion of a history
file was generated during a Bringover Update transaction; entries are described
below.  Note that this entry is taken from the history file in the child,
the corresponding entry in the parent is identical except that file status
messages are not included.
.IP
.nf
COMMAND bringover -w /home/sponge3/larryh/ws/man_pages -p
	/home/sponge3/larryh/ws/manpages man trans/man 
 update: man/Makefile
 update: man/man4/access_control.4
 create: man/man4/notification.4
 create: man/man1/codemgr.1
 rename from: man/man1/def.dir.flg.1
        to: man/man1/def.dir.flp.1
 update: man/man1/def.dir.flp.1
 create: man/man1/codemgrtool.1
 rename from: man/man1/fileresolve.1
        to: deleted_files/man/man1/fileresolve.1
 update children's name history:
	deleted_files/man/man1/fileresolve.1
 rename from: man/man1/resolve_tty.1
         to: deleted_files/man/man1/resolve_tty.1
 update: deleted_files/man/man1/resolve_tty.1
 create: trans/man/man1/codemgr_acquire.1
 create: trans/man/man1/codemgr_prepare.1
CWD /tmp_mnt/home/sponge3/larryh/temp
CMD bringover -w /home/sponge3/larryh/ws/man_pages -p
	/home/sponge3/larryh/ws/manpages man trans/man 
HOST croak
USER larryh
PARENT_WORKSPACE  (/home/sponge3/larryh/ws/manpages)
(sponge:/export/home/sponge3/larryh/ws/man_pages)
CHILD_WORKSPACE  (/home/sponge3/larryh/ws/man_pages)
(sponge:/export/home/sponge3/larryh/ws/man_pages)
START (Mon Jul 13 13:31:16 1992 PDT) (Mon Jul 13 20:31:16 1992 GMT)
END (Mon Jul 13 13:32:08 1992 PDT) (Mon Jul 13 20:32:08 1992 GMT)
STATUS 0
.fi
.LP
The following key words are used in the 
.B history 
file.
.TP 15
COMMAND
The command-line issued for the operation.  File status messages as displayed
by the command are included only in the destination workspace
.B history 
file.
.TP
CWD
The name of the current working directory when the command was executed.
.TP
CMD
Reiteration of the command-line issued for the operation.
.TP
HOST
The name of the system from which the command was executed.
.TP
USER
The login name of the user who executed the command.
.TP
PARENT_WORKSPACE
The path name of the parent workspace specified in two formats: host-specific
and 
.IR machine:pathname .
.TP
CHILD_WORKSPACE
The path name of the child workspace specified in two formats: host-specific
and 
.IR machine:pathname .
.TP
START
The time the command started execution, both locally and as measured by Greenwich Mean Time (GMT).
.TP
END
The time the command completed execution, both locally and as measured by Greenwich Mean Time (GMT).
.TP
STATUS
Exit status of the command: 0 = Normal completion, 1 = Error condition.
.SH "SEE ALSO"
.I TeamWare User's Guide
.sp 0
.BR bringover (1),
.BR def.dir.flp (1),
.BR fileresolve (1),
.BR putback (1),
.BR resolve (1),
.BR twmerge (1),
.BR ws_undo (1),
.BR workspace (1),
.BR access_control (4),
.BR args (4),
.BR children (4),
.BR conflicts (4),
.BR locks (4),
.BR nametable (4),
.BR notification (4),
.BR parent (4),
.BR putback.cmt (4)
