>>>>> "Tim" == Tim Jenness <[EMAIL PROTECTED]> writes:
Tim> Agreed. The localtime() docs suffer from a 'read the C manual' problem at
Tim> the moment....
Well, as long as "deleting a file" is spelled u-n-l-i-n-k,
we might as well have the output of localtime() be consistent with
the C function of the same name under Unix.
But yes, the manuals should be completely self-contained and not
require examining some C doc.
I disagree with keeping the same name as a Unix function, but having a
radically different calling sequence or return value. If you want a
new interface, *name* a new interface.
--
Randal L. Schwartz - Stonehenge Consulting Services, Inc. - +1 503 777 0095
<[EMAIL PROTECTED]> <URL:http://www.stonehenge.com/merlyn/>
Perl/Unix/security consulting, Technical writing, Comedy, etc. etc.
See PerlTraining.Stonehenge.com for onsite and open-enrollment Perl training!
