.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "SHTOOL-MDATE.TMP 1" .TH SHTOOL-MDATE.TMP 1 "shtool 2.0.8" "18-Jul-2008" "GNU Portable Shell Tool" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" shtool\-mdate \- GNU shtool pretty\-print last modification time .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBshtool mdate\fR [\fB\-n\fR|\fB\-\-newline\fR] [\fB\-z\fR|\fB\-\-zero\fR] [\fB\-s\fR|\fB\-\-shorten\fR] [\fB\-d\fR|\fB\-\-digits\fR] [\fB\-f\fR|\fB\-\-field\-sep\fR \fIstr\fR] [\fB\-o\fR|\fB\-\-order\fR \fIspec\fR] \&\fIpath\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" This command pretty-prints the last modification time of a given file or directory \fIpath\fR, while still allowing one to specify the format of the date to display. .SH "OPTIONS" .IX Header "OPTIONS" The following command line options are available. .IP "\fB\-n\fR, \fB\-\-newline\fR" 4 .IX Item "-n, --newline" By default, output is written to \fIstdout\fR followed by a \*(L"newline\*(R" (\s-1ASCII\s0 character 0x0a). If option \fB\-n\fR is used, this newline character is omitted. .IP "\fB\-z\fR, \fB\-\-zero\fR" 4 .IX Item "-z, --zero" Pads numeric day and numeric month with a leading zero. Default is to have variable width. .IP "\fB\-s\fR, \fB\-\-shorten\fR" 4 .IX Item "-s, --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 \fB\-d\fR. .IP "\fB\-d\fR, \fB\-\-digits\fR" 4 .IX Item "-d, --digits" Use digits for month. Default is to use a english name. .IP "\fB\-f\fR, \fB\-\-field\-sep\fR \fIstr\fR" 4 .IX Item "-f, --field-sep str" Field separator string between the day month year tripple. Default is a single space character. .IP "\fB\-o\fR, \fB\-\-order\fR \fIspec\fR" 4 .IX Item "-o, --order spec" Specifies order of the day month year elements within the tripple. Each element represented as a single character out of ``\f(CW\*(C`d\*(C'\fR'', ``\f(CW\*(C`m\*(C'\fR'' and ``\f(CW\*(C`y\*(C'\fR''. The default for \fIspec\fR is ``\f(CW\*(C`dmy\*(C'\fR''. .SH "EXAMPLE" .IX Header "EXAMPLE" .Vb 4 \& # shell script \& shtool mdate \-n / \& shtool mdate \-f \*(Aq/\*(Aq \-z \-d \-o ymd foo.txt \& shtool mdate \-f \*(Aq\-\*(Aq \-s foo.txt .Ve .SH "HISTORY" .IX Header "HISTORY" The \fB\s-1GNU\s0 shtool\fR \fBmdate\fR command was originally written by Ulrich Drepper in 1995 and revised by Ralf S. Engelschall in 1998 for inclusion into \fB\s-1GNU\s0 shtool\fR. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBshtool\fR\|(1), \fBdate\fR\|(1), \fBls\fR\|(1).