.BG
.VE $Header: /usr/s/current/s/.help/RCS/diary,v 1.2 83/12/30 19:27:42 rab Exp $
.FN diary
.TL
diary: Keep Diary of S Commands
.CS
diary(on, file)
.PP
.AG on
if TRUE(the default), diary-keeping is turned on.
.AG file
optional file name for diary entries, default is file
"diary".
.PP
Each line that the user types while diary-keeping is active is entered
into the diary file.  Each line that comes from a source file or from
a macro is also entered, preceded by the comment character and
indented to tell the level of source file nesting.  Thus, the diary
file can be used as a source file for re-execution of previously
entered lines.
(Lines that caused errors will also be present in the diary
file, so some editing may be necessary.)
.PP
Each time the diary keeping is turned on, a comment line is entered into the
diary file giving the current date and time.  Also, note that user-typed comments
are entered into the diary file.
.SH SEE ALSO
`sink' and `stamp'.
.EX
diary    # turn on diary file
diary(FALSE)    # turn off diary file
.KW basic*
.KW macros
.KW error
.KW session
.KW document
.WR
