* [patch], stat(2): One table too wide for line length; use text blocks
@ 2012-05-06 20:06 Bjarni Ingi Gislason
[not found] ` <20120506200619.GA1037-2945IVfuVpf1P9xLtpHBDw@public.gmane.org>
0 siblings, 1 reply; 2+ messages in thread
From: Bjarni Ingi Gislason @ 2012-05-06 20:06 UTC (permalink / raw)
To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w; +Cc: linux-man-u79uwXL29TY76Z2rM5mHXA
Package: man-pages
Version: 3.40
Severity: minor
Tags: patch
From "groff -ww" (or "man --warnings=w ..."):
warning: around line 442: table wider than line width
GNU man uses line length of 78.
Use text blocks. Two spaces between sentences or better: start
each sentence in a new line.
Patch:
--- stat.2 2012-04-26 22:58:36.000000000 +0000
+++ stat.2.new 2012-05-06 02:10:05.000000000 +0000
@@ -239,10 +239,10 @@
FIFO (named pipe)?
.TP
.BR S_ISLNK (m)
-symbolic link? (Not in POSIX.1-1996.)
+symbolic link? (Not in POSIX.1-1996.)
.TP
.BR S_ISSOCK (m)
-socket? (Not in POSIX.1-1996.)
+socket? (Not in POSIX.1-1996.)
.RE
.PP
The following flags are defined for the
@@ -438,16 +438,18 @@
l l l l l.
hex name ls octal description
f000 S_IFMT 170000 mask for file type
-0000 000000 SCO out-of-service inode; BSD unknown
- type; SVID-v2 and XPG2 have both
- 0 and 0100000 for ordinary file
+0000 000000 T{
+SCO out-of-service inode; BSD unknown type; SVID-v2 and XPG2
+have both 0 and 0100000 for ordinary file
+T}
1000 S_IFIFO p| 010000 FIFO (named pipe)
2000 S_IFCHR c 020000 character special (V7)
3000 S_IFMPC 030000 multiplexed character special (V7)
4000 S_IFDIR d/ 040000 directory (V7)
-5000 S_IFNAM 050000 XENIX named special file
- with two subtypes, distinguished by
- \fIst_rdev\fP values 1, 2
+5000 S_IFNAM 050000 T{
+XENIX named special file with two subtypes, distinguished by
+\fIst_rdev\fP values 1, 2
+T}
0001 S_INSEM s 000001 XENIX semaphore subtype of IFNAM
0002 S_INSHD m 000002 XENIX shared data subtype of IFNAM
6000 S_IFBLK b 060000 block special (V7)
@@ -456,26 +458,33 @@
9000 S_IFCMP 110000 VxFS compressed
9000 S_IFNWK n 110000 network special (HP-UX)
a000 S_IFLNK l@ 120000 symbolic link (BSD)
-b000 S_IFSHAD 130000 Solaris shadow inode for ACL
- (not seen by userspace)
+b000 S_IFSHAD 130000 T{
+Solaris shadow inode for ACL (not seen by userspace)
+T}
c000 S_IFSOCK s= 140000 socket (BSD; also "S_IFSOC" on VxFS)
d000 S_IFDOOR D> 150000 Solaris door
e000 S_IFWHT w% 160000 BSD whiteout (not used for inode)
-0200 S_ISVTX 001000 sticky bit: save swapped text even
- after use (V7)
- reserved (SVID-v2)
- On nondirectories: don't cache this
- file (SunOS)
- On directories: restricted deletion
- flag (SVID-v4.2)
-0400 S_ISGID 002000 set-group-ID on execution (V7)
- for directories: use BSD semantics for
- propagation of GID
-0400 S_ENFMT 002000 System V file locking enforcement (shared
- with S_ISGID)
+0200 S_ISVTX 001000 T{
+sticky bit: save swapped text even after use (V7)
+.br
+reserved (SVID-v2)
+.br
+On nondirectories: don't cache this file (SunOS)
+.br
+On directories: restricted deletion flag (SVID-v4.2)
+T}
+0400 S_ISGID 002000 T{
+set-group-ID on execution (V7)
+.br
+for directories: use BSD semantics for propagation of GID
+T}
+0400 S_ENFMT 002000 T{
+System V file locking enforcement (shared with S_ISGID)
+T}
0800 S_ISUID 004000 set-user-ID on execution (V7)
-0800 S_CDF 004000 directory is a context dependent
- file (HP-UX)
+0800 S_CDF 004000 T{
+directory is a context dependent file (HP-UX)
+T}
.TE
A sticky command appeared in Version 32V AT&T UNIX.
--
Bjarni I. Gislason
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [patch], stat(2): One table too wide for line length; use text blocks
[not found] ` <20120506200619.GA1037-2945IVfuVpf1P9xLtpHBDw@public.gmane.org>
@ 2012-05-06 21:10 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 2+ messages in thread
From: Michael Kerrisk (man-pages) @ 2012-05-06 21:10 UTC (permalink / raw)
To: Bjarni Ingi Gislason; +Cc: linux-man-u79uwXL29TY76Z2rM5mHXA
Hello Bjarni,
On Mon, May 7, 2012 at 8:06 AM, Bjarni Ingi Gislason <bjarniig-2945IVfuVpc@public.gmane.orgs> wrote:
> Package: man-pages
> Version: 3.40
> Severity: minor
> Tags: patch
>
> From "groff -ww" (or "man --warnings=w ..."):
>
> warning: around line 442: table wider than line width
>
> GNU man uses line length of 78.
>
> Use text blocks. Two spaces between sentences or better: start
> each sentence in a new line.
>
> Patch:
I applied, with the addition of
.ad l
.ad j
around the table.
Thanks!
Michael
> --- stat.2 2012-04-26 22:58:36.000000000 +0000
> +++ stat.2.new 2012-05-06 02:10:05.000000000 +0000
> @@ -239,10 +239,10 @@
> FIFO (named pipe)?
> .TP
> .BR S_ISLNK (m)
> -symbolic link? (Not in POSIX.1-1996.)
> +symbolic link? (Not in POSIX.1-1996.)
> .TP
> .BR S_ISSOCK (m)
> -socket? (Not in POSIX.1-1996.)
> +socket? (Not in POSIX.1-1996.)
> .RE
> .PP
> The following flags are defined for the
> @@ -438,16 +438,18 @@
> l l l l l.
> hex name ls octal description
> f000 S_IFMT 170000 mask for file type
> -0000 000000 SCO out-of-service inode; BSD unknown
> - type; SVID-v2 and XPG2 have both
> - 0 and 0100000 for ordinary file
> +0000 000000 T{
> +SCO out-of-service inode; BSD unknown type; SVID-v2 and XPG2
> +have both 0 and 0100000 for ordinary file
> +T}
> 1000 S_IFIFO p| 010000 FIFO (named pipe)
> 2000 S_IFCHR c 020000 character special (V7)
> 3000 S_IFMPC 030000 multiplexed character special (V7)
> 4000 S_IFDIR d/ 040000 directory (V7)
> -5000 S_IFNAM 050000 XENIX named special file
> - with two subtypes, distinguished by
> - \fIst_rdev\fP values 1, 2
> +5000 S_IFNAM 050000 T{
> +XENIX named special file with two subtypes, distinguished by
> +\fIst_rdev\fP values 1, 2
> +T}
> 0001 S_INSEM s 000001 XENIX semaphore subtype of IFNAM
> 0002 S_INSHD m 000002 XENIX shared data subtype of IFNAM
> 6000 S_IFBLK b 060000 block special (V7)
> @@ -456,26 +458,33 @@
> 9000 S_IFCMP 110000 VxFS compressed
> 9000 S_IFNWK n 110000 network special (HP-UX)
> a000 S_IFLNK l@ 120000 symbolic link (BSD)
> -b000 S_IFSHAD 130000 Solaris shadow inode for ACL
> - (not seen by userspace)
> +b000 S_IFSHAD 130000 T{
> +Solaris shadow inode for ACL (not seen by userspace)
> +T}
> c000 S_IFSOCK s= 140000 socket (BSD; also "S_IFSOC" on VxFS)
> d000 S_IFDOOR D> 150000 Solaris door
> e000 S_IFWHT w% 160000 BSD whiteout (not used for inode)
> -0200 S_ISVTX 001000 sticky bit: save swapped text even
> - after use (V7)
> - reserved (SVID-v2)
> - On nondirectories: don't cache this
> - file (SunOS)
> - On directories: restricted deletion
> - flag (SVID-v4.2)
> -0400 S_ISGID 002000 set-group-ID on execution (V7)
> - for directories: use BSD semantics for
> - propagation of GID
> -0400 S_ENFMT 002000 System V file locking enforcement (shared
> - with S_ISGID)
> +0200 S_ISVTX 001000 T{
> +sticky bit: save swapped text even after use (V7)
> +.br
> +reserved (SVID-v2)
> +.br
> +On nondirectories: don't cache this file (SunOS)
> +.br
> +On directories: restricted deletion flag (SVID-v4.2)
> +T}
> +0400 S_ISGID 002000 T{
> +set-group-ID on execution (V7)
> +.br
> +for directories: use BSD semantics for propagation of GID
> +T}
> +0400 S_ENFMT 002000 T{
> +System V file locking enforcement (shared with S_ISGID)
> +T}
> 0800 S_ISUID 004000 set-user-ID on execution (V7)
> -0800 S_CDF 004000 directory is a context dependent
> - file (HP-UX)
> +0800 S_CDF 004000 T{
> +directory is a context dependent file (HP-UX)
> +T}
> .TE
>
> A sticky command appeared in Version 32V AT&T UNIX.
>
> --
> Bjarni I. Gislason
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2012-05-06 21:10 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2012-05-06 20:06 [patch], stat(2): One table too wide for line length; use text blocks Bjarni Ingi Gislason
[not found] ` <20120506200619.GA1037-2945IVfuVpf1P9xLtpHBDw@public.gmane.org>
2012-05-06 21:10 ` Michael Kerrisk (man-pages)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox