----------------------------
revision 1.6
date: 2003/02/21 11:26:50;  author: alban;  state: Exp;  lines: +2 -2
corrected typo in pod
----------------------------
revision 1.5
date: 2003/02/21 09:23:24;  author: alban;  state: Exp;  lines: +17 -1
added gpl licensing
----------------------------
revision 1.4
date: 2003/02/21 06:43:33;  author: alban;  state: Exp;  lines: +129 -24
. Introduced $user_given_caller_level and set_caller_level()
. stack_trace() now takes a level parameter (and barf() and pbarf()
  now use it when calling stack_trace() )
----------------------------
revision 1.3
date: 2003/02/08 13:34:18;  author: alban;  state: Exp;  lines: +526 -154
. Overhauled Log::Monkey package variables, which are now:
  . use_stack_traces
  . program_dollar_zero
  . program_basename
  . linehdr_format
  . use_line_headers
  . logfile
  along with their environment variables and associated set subroutines
. Changed set subroutines so that they don't change their associated
  package variable if there are problems with the input parameter
. Changed timestamp() so that it can return a date, a time, or both
. Added line header formats.  They are of the form:
    %0     program name, full path
    %P     program name, basename of path
    %d     date  "YYYY-mm-dd"
    %H     host
    %h     host (dotless)
    %p     process id
    %t     time  "HH:MM:SS"
  The default header line format is:  "%d %t %h %P[%p]: "
  linehdr() now does the parsing of these format specifiers.
. Added multiline prefix capability to aloggit()
. Internal newlines in parameters are now deleted in loggit()
. Changed name of trace() to stack_trace()
. Updated pod
----------------------------
revision 1.2
date: 2003/02/02 00:41:27;  author: alban;  state: Exp;  lines: +262 -53
. Lots of mods :-)
----------------------------
revision 1.1
date: 2002/05/15 21:04:16;  author: alban;  state: Exp;
Initial revision
=============================================================================