Wed Sep 20 08:57:02 2017 UTC ()
whitespace fixes, use Xr.


(wiz)
diff -r1.39 -r1.40 src/usr.bin/stat/stat.1
cvs diff -r1.39 -r1.40 src/usr.bin/stat/stat.1 (expand / switch to unified diff)

--- src/usr.bin/stat/stat.1 2017/09/19 21:45:28 1.39
+++ src/usr.bin/stat/stat.1 2017/09/20 08:57:02 1.40
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: stat.1,v 1.39 2017/09/19 21:45:28 christos Exp $ 1.\" $NetBSD: stat.1,v 1.40 2017/09/20 08:57:02 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2002-2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2002-2011 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Andrew Brown and Jan Schaumann. 7.\" by Andrew Brown and Jan Schaumann.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -173,27 +173,27 @@ This is equivalent to specifying @@ -173,27 +173,27 @@ This is equivalent to specifying
173FMT="st_dev=%d st_ino=%i st_mode=%#p st_nlink=%l st_uid=%u st_gid=%g" 173FMT="st_dev=%d st_ino=%i st_mode=%#p st_nlink=%l st_uid=%u st_gid=%g"
174FMT="$FMT st_rdev=%r st_size=%z st_atime=%Sa st_mtime=%Sm st_ctime=%Sc" 174FMT="$FMT st_rdev=%r st_size=%z st_atime=%Sa st_mtime=%Sm st_ctime=%Sc"
175FMT="$FMT st_birthtime=%SB st_blksize=%k st_blocks=%b st_flags=%f" 175FMT="$FMT st_birthtime=%SB st_blksize=%k st_blocks=%b st_flags=%f"
176stat -t %s -f "$FMT" . 176stat -t %s -f "$FMT" .
177.Ed 177.Ed
178Note that if you use a timeformat that contains embedded whitespace or shell 178Note that if you use a timeformat that contains embedded whitespace or shell
179meta-characters you will need to include appropriate quoting so the 179meta-characters you will need to include appropriate quoting so the
180.Fl s 180.Fl s
181output remains valid. 181output remains valid.
182.It Fl t Ar timefmt 182.It Fl t Ar timefmt
183Display timestamps using the specified format. 183Display timestamps using the specified format.
184This format is 184This format is
185passed directly to 185passed directly to
186.Xr strftime 3  186.Xr strftime 3
187with the extension that %f prints nanoseconds if available. 187with the extension that %f prints nanoseconds if available.
188.It Fl v 188.It Fl v
189Turn off quiet mode. 189Turn off quiet mode.
190.It Fl x 190.It Fl x
191Display information in a more verbose way as known from some Linux 191Display information in a more verbose way as known from some Linux
192distributions. 192distributions.
193.El 193.El
194.Ss FORMATS 194.Ss FORMATS
195Format strings are similar to 195Format strings are similar to
196.Xr printf 3 196.Xr printf 3
197formats in that they start with 197formats in that they start with
198.Cm % , 198.Cm % ,
199are then followed by a sequence of formatting characters, and end in 199are then followed by a sequence of formatting characters, and end in
@@ -265,28 +265,29 @@ Floating point output only applies to ti @@ -265,28 +265,29 @@ Floating point output only applies to ti
265.Cm a , 265.Cm a ,
266.Cm m , 266.Cm m ,
267and 267and
268.Cm c 268.Cm c
269fields). 269fields).
270.Pp 270.Pp
271The special output specifier 271The special output specifier
272.Cm S 272.Cm S
273may be used to indicate that the output, if 273may be used to indicate that the output, if
274applicable, should be in string format. 274applicable, should be in string format.
275May be used in combination with 275May be used in combination with
276.Bl -tag -width Ds 276.Bl -tag -width Ds
277.It Cm amc 277.It Cm amc
278Display date in strftime(3) format 278Display date in
279with the extension that %f prints nanoseconds if available. 279.Xr strftime 3
 280format with the extension that %f prints nanoseconds if available.
280.It Cm dr 281.It Cm dr
281Display actual device name. 282Display actual device name.
282.It Cm gu 283.It Cm gu
283Display group or user name. 284Display group or user name.
284.It Cm p 285.It Cm p
285Display the mode of 286Display the mode of
286.Ar file 287.Ar file
287as in 288as in
288.Ic ls -lTd . 289.Ic ls -lTd .
289.It Cm N 290.It Cm N
290Displays the name of 291Displays the name of
291.Ar file . 292.Ar file .
292.It Cm T 293.It Cm T
@@ -402,27 +403,27 @@ Number of hard links to @@ -402,27 +403,27 @@ Number of hard links to
402.It Cm u , g 403.It Cm u , g
403User-id and group-id of 404User-id and group-id of
404.Ar file Ap s 405.Ar file Ap s
405owner 406owner
406.Pq Fa st_uid , st_gid . 407.Pq Fa st_uid , st_gid .
407.It Cm r 408.It Cm r
408Device number for character and block device special files 409Device number for character and block device special files
409.Pq Fa st_rdev . 410.Pq Fa st_rdev .
410.It Cm a , m , c , B 411.It Cm a , m , c , B
411The time 412The time
412.Ar file 413.Ar file
413was last accessed or modified, or when the inode was last changed, or 414was last accessed or modified, or when the inode was last changed, or
414the birth time of the inode 415the birth time of the inode
415.Pq Fa st_atime , st_mtime , st_ctime, st_birthtime . 416.Pq Fa st_atime , st_mtime , st_ctime , st_birthtime .
416.It Cm z 417.It Cm z
417The size of 418The size of
418.Ar file 419.Ar file
419in bytes 420in bytes
420.Pq Fa st_size . 421.Pq Fa st_size .
421.It Cm b 422.It Cm b
422Number of blocks allocated for 423Number of blocks allocated for
423.Ar file 424.Ar file
424.Pq Fa st_blocks . 425.Pq Fa st_blocks .
425.It Cm k 426.It Cm k
426Optimal file system I/O operation block size 427Optimal file system I/O operation block size
427.Pq Fa st_blksize . 428.Pq Fa st_blksize .
428.It Cm f 429.It Cm f