[Midnightbsd-cvs] src: stat.1: sync with freebsd

[laffer1 at midnightbsd.org]

Log Message:
-----------
sync with freebsd

Modified Files:
--------------
    src/usr.bin/stat:
        stat.1 (r1.1.1.1 -> r1.2)

-------------- next part --------------
Index: stat.1
===================================================================
RCS file: /home/cvs/src/usr.bin/stat/stat.1,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L usr.bin/stat/stat.1 -L usr.bin/stat/stat.1 -u -r1.1.1.1 -r1.2
--- usr.bin/stat/stat.1
+++ usr.bin/stat/stat.1
@@ -34,9 +34,9 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/usr.bin/stat/stat.1,v 1.8 2005/06/14 11:50:53 ru Exp $
+.\" $FreeBSD: src/usr.bin/stat/stat.1,v 1.9 2007/04/27 18:23:32 brian Exp $
 .\"
-.Dd May 8, 2003
+.Dd April 27, 2007
 .Dt STAT 1
 .Os
 .Sh NAME
@@ -455,7 +455,7 @@
 1148 1015432481
 .Ed
 .Pp
-In order to get a list of the kind of files including files pointed to if the
+In order to get a list of file types including files pointed to if the
 file is a symbolic link, you could use the following format:
 .Bd -literal -offset indent
 $ stat -f "%N: %HT%SY" /tmp/*
@@ -497,6 +497,31 @@
 Apr 25 10:36:34 2002 /tmp/bar
 Apr 24 16:47:35 2002 /tmp/foo
 .Ed
+.Pp
+To display a file's modification time:
+.Bd -literal -offset indent
+\*[Gt] stat -f %m /tmp/foo
+1177697733
+.Ed
+.Pp
+To display the same modification time in a readable format:
+.Bd -literal -offset indent
+\*[Gt] stat -f %Sm /tmp/foo
+Apr 27 11:15:33 2007
+.Ed
+.Pp
+To display the same modification time in a readable and sortable format:
+.Bd -literal -offset indent
+\*[Gt] stat -f %Sm -t %Y%m%d%H%M%S /tmp/foo
+20070427111533
+.Ed
+.Pp
+To display the same in UTC:
+.Bd -literal -offset indent
+\*[Gt] sh
+$ TZ= stat -f %Sm -t %Y%m%d%H%M%S /tmp/foo
+20070427181533
+.Ed
 .Sh SEE ALSO
 .Xr file 1 ,
 .Xr ls 1 ,