Re: [patch], stat(2): One table too wide for line length; use text blocks
From: Michael Kerrisk (man-pages) <hidden>
Date: 2012-05-06 21:10:34
Hello Bjarni, On Mon, May 7, 2012 at 8:06 AM, Bjarni Ingi Gislason [off-list ref] 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
quoted hunk
--- 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