_________________________________________________________________



NAME

     log  - logging functions.

_________________________________________________________________


     log option ?arg arg ...?

          The log command allows the user to create and write  to
          log  files.   Only  one log file can be open at a time.
          The log file is formatted as follows.  The first  field
          is  the logical time at which the logged event is writ-
          ten or the real time if not logical time system  object
          was  given  to  the logger.  The second field is set by
          the caller when the log file  is  open  (see  log  open
          below).   Finally, the logged arguments the user passes
          to log write are written, one per field.  Each field is
          separated  from  the  previous  by  a  tab.   The valid
          options are:

     log open fileId tag ?lts?
          This command initializes the log file. fileId is a file
          previously  created  with  the tcl open command, tag is
          the user defined tag for the log file, and lts  is  the
          name  of the logical time system to be used in logging.
          If lts is omitted, real system time is used instead.

     log write ?arg? ?arg...?
          Write the specified args out to the log file, if one is
          open.  Each arg will be separated by tabs.

     log close
          Closes the current log file.

     void Tcm_Log (char *str)
          This function writes the string  str  out  to  the  log
          file, if one is open.


AUTHOR

     Brian Smith (bsmith@cs.berkeley.edu)
     Steve Yen (syen@cs.berkeley.edu)

     modified in 1994 by
     Gordon Chaffee (chaffee@bugs-bunny.cs.berkeleu.edu)
     Ketan Patel (kpatel@cs.berkeley.edu)