This object handles a log of everything which happens in a
processing script. The log is in a convenient HTML format
and includes an index to major processing steps and to
processing errors.
The much simpler Util::NoLog class will output
to stdout and stderr, for times when a log object has not
yet been created.
Note that the constructor creates new log files, so
only one Log object should be used throughout a given processing
script.
Constructor
- new(filename_object, jobpar_object)
Create a new set of HTML log pages and write their headers.
If there are exsiting files with the same name, rename then by
appending ".old" to their names. This is sometimes useful when debugging.
Accessors
Methods
- entry(message)
Make an entry in the job log.
- milestone(message)
Mark a major event in the job log and index.
- writeEvent()
- secToHMS()
- timestamp()
- event()
- error(control, message)
Signal an error.
- file(file)
Dump the contents of a file to the log.
- text(text)
Dump the contents of a string to the log.
The string will be enclosed in <PRE> tags, so this
is most appropriate for multi-line text.
Special Methods
- DESTROY()
Object destructor method.
Close up the logs.