--- sh.mdate 2003/04/04 16:36:01 1.13
+++ sh.mdate 2004/02/12 16:06:26 1.14
@@ -1,8 +1,7 @@
##
## mdate -- Pretty-print modification time of a file or dir
## Copyright (c) 1995-1997 Free Software Foundation, Inc.
-## Originally idea and basis code by Ulrich Drepper
-## Enhanced by Ralf S. Engelschall for shtool
+## Copyright (c) 1998-2004 Ralf S. Engelschall <rse@engelschall.com>
##
## This file is part of shtool and free software; you can redistribute
## it and/or modify it under the terms of the GNU General Public
@@ -150,3 +149,89 @@
}' "day=$day" "month=$month" "year=$year" \
"field=$opt_f" "order=$opt_o" "newline=$opt_n"
+shtool_exit 0
+
+##
+## manual page
+##
+
+=pod
+
+=head1 NAME
+
+B<shtool mdate> - B<GNU shtool> pretty-print last modification time
+
+=head1 SYNOPSIS
+
+B<shtool mdate>
+[B<-n>|B<--newline>]
+[B<-z>|B<--zero>]
+[B<-s>|B<--shorten>]
+[B<-d>|B<--digits>]
+[B<-f>|B<--field-sep> I<str>]
+[B<-o>|B<--order> I<spec>]
+I<path>
+
+=head1 DESCRIPTION
+
+This command pretty-prints the last modification time of a given file or
+directory I<path>, while still allowing one to specify the format of the
+date to display.
+
+=head1 OPTIONS
+
+The following command line options are available.
+
+=over 4
+
+=item B<-n>, B<--newline>
+
+By default, output is written to F<stdout> followed by a "newline"
+(ASCII character 0x0a). If option B<-n> is used, this newline character
+is omitted.
+
+=item B<-z>, B<--zero>
+
+Pads numeric day and numeric month with a leading zero. Default is to
+have variable width.
+
+=item B<-s>, B<--shorten>
+
+Shortens the name of the month to a english three character
+abbreviation. Default is full english name. This option is silently
+ignored when combined with B<-d>.
+
+=item B<-d>, B<--digits>
+
+Use digits for month. Default is to use a english name.
+
+=item B<-f>, B<--field-sep> I<str>
+
+Field separator string between the day month year tripple. Default is a
+single space character.
+
+=item B<-o>, B<--order> I<spec>
+
+Specifies order of the day month year elements within the tripple. Each
+element represented as a single character out of ``C<d>'', ``C<m>'' and
+``C<y>''. The default for I<spec> is ``C<dmy>''.
+
+=head1 EXAMPLE
+
+ # shell script
+ shtool mdate -n /
+ shtool mdate -f '/' -z -d -o ymd foo.txt
+ shtool mdate -f '-' -s foo.txt
+
+=head1 HISTORY
+
+The B<GNU shtool> B<mdate> command was originally written by
+Ulrich Drepper in 1995 and revised by Ralf S. Engelschall
+E<lt>rse@engelschall.comE<gt> in 1998 for inclusion into B<GNU shtool>.
+
+=head1 SEE ALSO
+
+shtool(1), date(1), ls(1).
+
+=cut
+
|
