Document::LogFile - LogFile file manager.

 use Document::LogFile;
 $obj = Document::LogFile->new ($filespecobj);
 $obj = Document::LogFile->new ($filename)
 $okay = $obj->log ($string);

 UNIVERSAL

This Class manages .log files contained within a Document directory. Every time something changes or of interest happens, a message may be written to .log.

 use Document::LogFile;
 my $baz       = Document::LogFile->new ($filespecobj);
 my $baz       = Document::LogFile->new ($pathname);
 my $waslogged = $baz->log ( Arf! Arf! );

 None.

 None.

$obj = Document::LogFile->new ($filespecobj)

$obj = Document::LogFile->new ($filename)

Create an object to allow communications with a log file object of a Document directory defined by $filename or $filespecobj. If there is currently no file in it named .log, create one and emit a log creation message to it.

Objects of this Class may be used as inputs to the Fault::Logger class.

All of the path information comes either from a preparsed filename in $filespecobj, a File::Spec::DatedPage object, or a string containing a pathname to the target Document directory.

[Can we get by with a File::Spec::Dated object?]

$okay = $obj->log ($string)

Write a time-stamped message into the .log file of the form:

       20021207223010 $string\n

and return true if we succeeded in doing so.

 None.

 None.

 See TODO.

Fault::ErrorHandler, DMA::ISODate, File::Spec::DatedPage

Dale Amon <amon@vnl.com>