user manual Misc.pl


Introduction
============

[...]


Misc.pl standard options
========================

All options/switches are case-insensitive, they may be written upper or lower
case. Options and option arguments are separated by an "=" character.

abbreviations for switch argument types used in the descriptions:
 B := boolean
 F := floating point/scientific
 N := integer
 S := string
 X := varying type
 []   optional switch arguments

 -debug[=N]    print debug protocol to STDERR (sometimes STDOUT). Keep temporary
               files. Switch argument N specifies a debug depth value,
               default 1.
 -format=S     user-defined format scheme
 -log[=S]      redirect STDOUT and STDERR to LOG file
               S          log file path, default path worked out
                          automatically from built-in directives.
 -v[erbose]    print extended progress report to STDOUT.


Misc.pl -ATime, Misc.pl -ATimeSec, Misc.pl -ATimeSecDiff
========================================================

Determine the last access time of a file. `Misc.pl -ATime returns a formatted
time string, `Misc.pl -ATimeSec returns an epoch time, `Misc.pl -ATimeSecDiff
returns the number of seconds from now.

COMMAND LINE SYNTAX
 Misc.pl -ATime [options] <file>
 Misc.pl -ATimeSec [options] <file>
 Misc.pl -ATimeSecDiff [options] <file>

arguments:
 file          target file

options:
 -format=S     user-defined time format scheme for program mode
               `Misc.pl -ATime. The format syntax conforms to that of the C
               function strftime(), default format string
               "%Y-%m-%d %H:%M:%S %z(%Z)", as defined in
               $MainLib::StrRegexp::TimeStrDft.


Misc.pl -FTime, Misc.pl -FTimeSec, Misc.pl -FTimeSecDiff
========================================================

Determine the modification time of a file. `Misc.pl -FTime returns a formatted
time string, `Misc.pl -FTimeSec returns an epoch time, `Misc.pl -FTimeSecDiff
returns the number of seconds from now.

COMMAND LINE SYNTAX
 Misc.pl -FTime [options] <file>
 Misc.pl -FTimeSec [options] <file>
 Misc.pl -FTimeSecDiff [options] <file>

arguments:
 file          target file

options:
 -format=S     user-defined time format scheme for program mode
               `Misc.pl -FTime. The format syntax conforms to that of the C
               function strftime(), default format string
               "%Y-%m-%d %H:%M:%S %z(%Z)", as defined in
               $MainLib::StrRegexp::TimeStrDft.
