make -column lists pretty again;

specifically, rewrite them to permit some markup in the column headers,
and use "Ta" instead of literal tabs; mandoc does not currently match groff
100%, but a mandoc fix may be some time off, and we've gone enough releases
with poorly formatting column lists.

in some cases i have rewritten the lists as -tag, where -column made
little sense.

3 files changed, 77 insertions, 77 deletions

diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3
index bcfc68a1063..01307ba9fa7 100644
--- a/lib/libc/stdio/printf.3
+++ b/lib/libc/stdio/printf.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: printf.3,v 1.58 2010/03/26 19:30:41 jmc Exp $
+.\"	$OpenBSD: printf.3,v 1.59 2011/09/03 22:59:07 jmc Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)printf.3	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: March 26 2010 $
+.Dd $Mdocdate: September 3 2011 $
 .Dt PRINTF 3
 .Os
 .Sh NAME
@@ -320,7 +320,7 @@ or
 .Cm X
 conversion:
 .Bl -column "(deprecated)" "signed char" "unsigned long long" "long long *"
-.It Sy Modifier Ta "d, i" Ta "o, u, x, X" Ta n
+.It Sy Modifier Ta Sy "d, i" Ta Sy "o, u, x, X" Ta Sy n
 .It hh Ta "signed char" Ta "unsigned char" Ta "signed char *"
 .It h Ta short Ta "unsigned short" Ta "short *"
 .It "l (ell)" Ta long Ta "unsigned long" Ta "long *"
@@ -368,7 +368,7 @@ or
 .Cm G
 conversion:
 .Bl -column "Modifier" "e, E, f, F, g, G"
-.It Sy Modifier Ta "e, E, f, F, g, G"
+.It Sy Modifier Ta Sy "e, E, f, F, g, G"
 .It "l (ell)" Ta double (ignored: same behavior as without it)
 .It L Ta "long double"
 .El
@@ -379,7 +379,7 @@ or
 .Cm s
 conversion:
 .Bl -column "Modifier" "wint_t" "wchar_t *"
-.It Sy Modifier Ta c Ta s
+.It Sy Modifier Ta Sy c Ta Sy s
 .It "l (ell)" Ta wint_t Ta "wchar_t *"
 .El
 .It
diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3
index 27fe4eefdde..431078712ae 100644
--- a/lib/libc/stdio/stdio.3
+++ b/lib/libc/stdio/stdio.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: stdio.3,v 1.20 2010/01/03 14:31:01 schwarze Exp $
+.\"	$OpenBSD: stdio.3,v 1.21 2011/09/03 22:59:07 jmc Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: January 3 2010 $
+.Dd $Mdocdate: September 3 2011 $
 .Dt STDIO 3
 .Os
 .Sh NAME
@@ -211,72 +211,72 @@ and
 exist and will be used if the macro
 definitions are explicitly removed.
 .Sh LIST OF FUNCTIONS
-.Bl -column "Description"
-.It Sy Function	Description
-.It asprintf	formatted output conversion with allocation
-.It clearerr	check and reset stream status
-.It fclose	close a stream
-.It fdopen	stream open functions
-.It feof	check and reset stream status
-.It ferror	check and reset stream status
-.It fflush	flush a stream
-.It fgetc	get next character or word from input stream
-.It fgetln	get a line from a stream
-.It fgetpos	reposition a stream
-.It fgets	get a line from a stream
-.It fileno	get a stream's underlying file descriptor
-.It fopen	stream open functions
-.It fprintf	formatted output conversion
-.It fpurge	flush a stream
-.It fputc	output a character or word to a stream
-.It fputs	output a line to a stream
-.It fread	binary stream input/output
-.It freopen	stream open functions
-.It fropen	open a stream
-.It fscanf	input format conversion
-.It fseek	reposition a stream
-.It fsetpos	reposition a stream
-.It ftell	reposition a stream
-.It funopen	open a stream
-.It fwopen	open a stream
-.It fwrite	binary stream input/output
-.It getc	get next character or word from input stream
-.It getchar	get next character or word from input stream
-.It gets	get a line from a stream
-.It getw	get next character or word from input stream
-.It mkstemp	create unique temporary file
-.It mktemp	create unique temporary file
-.It perror	system error messages
-.It printf	formatted output conversion
-.It putc	output a character or word to a stream
-.It putchar	output a character or word to a stream
-.It puts	output a line to a stream
-.It putw	output a character or word to a stream
-.It remove	remove directory entry
-.It rewind	reposition a stream
-.It scanf	input format conversion
-.It setbuf	stream buffering operations
-.It setbuffer	stream buffering operations
-.It setlinebuf	stream buffering operations
-.It setvbuf	stream buffering operations
-.It snprintf	formatted output conversion
-.It sprintf	formatted output conversion
-.It sscanf	input format conversion
-.It strerror	system error messages
-.It sys_errlist	system error messages
-.It sys_nerr	system error messages
-.It tempnam	temporary file routines
-.It tmpfile	temporary file routines
-.It tmpnam	temporary file routines
-.It ungetc	un-get character from input stream
-.It vasprintf	formatted output conversion with allocation
-.It vfprintf	formatted output conversion
-.It vfscanf	input format conversion
-.It vprintf	formatted output conversion
-.It vscanf	input format conversion
-.It vsnprintf	formatted output conversion
-.It vsprintf	formatted output conversion
-.It vsscanf	input format conversion
+.Bl -column "sys_errlist" "Description"
+.It Sy Function Ta Sy Description
+.It asprintf Ta "formatted output conversion with allocation"
+.It clearerr Ta "check and reset stream status"
+.It fclose Ta "close a stream"
+.It fdopen Ta "stream open functions"
+.It feof Ta "check and reset stream status"
+.It ferror Ta "check and reset stream status"
+.It fflush Ta "flush a stream"
+.It fgetc Ta "get next character or word from input stream"
+.It fgetln Ta "get a line from a stream"
+.It fgetpos Ta "reposition a stream"
+.It fgets Ta "get a line from a stream"
+.It fileno Ta "get a stream's underlying file descriptor"
+.It fopen Ta "stream open functions"
+.It fprintf Ta "formatted output conversion"
+.It fpurge Ta "flush a stream"
+.It fputc Ta "output a character or word to a stream"
+.It fputs Ta "output a line to a stream"
+.It fread Ta "binary stream input/output"
+.It freopen Ta "stream open functions"
+.It fropen Ta "open a stream"
+.It fscanf Ta "input format conversion"
+.It fseek Ta "reposition a stream"
+.It fsetpos Ta "reposition a stream"
+.It ftell Ta "reposition a stream"
+.It funopen Ta "open a stream"
+.It fwopen Ta "open a stream"
+.It fwrite Ta "binary stream input/output"
+.It getc Ta "get next character or word from input stream"
+.It getchar Ta "get next character or word from input stream"
+.It gets Ta "get a line from a stream"
+.It getw Ta "get next character or word from input stream"
+.It mkstemp Ta "create unique temporary file"
+.It mktemp Ta "create unique temporary file"
+.It perror Ta "system error messages"
+.It printf Ta "formatted output conversion"
+.It putc Ta "output a character or word to a stream"
+.It putchar Ta "output a character or word to a stream"
+.It puts Ta "output a line to a stream"
+.It putw Ta "output a character or word to a stream"
+.It remove Ta "remove directory entry"
+.It rewind Ta "reposition a stream"
+.It scanf Ta "input format conversion"
+.It setbuf Ta "stream buffering operations"
+.It setbuffer Ta "stream buffering operations"
+.It setlinebuf Ta "stream buffering operations"
+.It setvbuf Ta "stream buffering operations"
+.It snprintf Ta "formatted output conversion"
+.It sprintf Ta "formatted output conversion"
+.It sscanf Ta "input format conversion"
+.It strerror Ta "system error messages"
+.It sys_errlist Ta "system error messages"
+.It sys_nerr Ta "system error messages"
+.It tempnam Ta "temporary file routines"
+.It tmpfile Ta "temporary file routines"
+.It tmpnam Ta "temporary file routines"
+.It ungetc Ta "un-get character from input stream"
+.It vasprintf Ta "formatted output conversion with allocation"
+.It vfprintf Ta "formatted output conversion"
+.It vfscanf Ta "input format conversion"
+.It vprintf Ta "formatted output conversion"
+.It vscanf Ta "input format conversion"
+.It vsnprintf Ta "formatted output conversion"
+.It vsprintf Ta "formatted output conversion"
+.It vsscanf Ta "input format conversion"
 .El
 .Sh SEE ALSO
 .Xr close 2 ,
diff --git a/lib/libc/stdio/wprintf.3 b/lib/libc/stdio/wprintf.3
index 966ef7eb97b..b395f8526b0 100644
--- a/lib/libc/stdio/wprintf.3
+++ b/lib/libc/stdio/wprintf.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: wprintf.3,v 1.2 2011/05/16 16:43:36 jmc Exp $
+.\"	$OpenBSD: wprintf.3,v 1.3 2011/09/03 22:59:07 jmc Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)printf.3	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: May 16 2011 $
+.Dd $Mdocdate: September 3 2011 $
 .Dt WPRINTF 3
 .Os
 .Sh NAME
@@ -253,7 +253,7 @@ or
 .Cm X
 conversion:
 .Bl -column "q (deprecated)" "signed char" "unsigned long long" "long long *"
-.It Sy Modifier Ta "d, i" Ta "o, u, x, X" Ta n
+.It Sy Modifier Ta Sy "d, i" Ta Sy "o, u, x, X" Ta Sy n
 .It hh Ta "signed char" Ta "unsigned char" Ta "signed char *"
 .It h Ta short Ta "unsigned short" Ta "short *"
 .It "l (ell)" Ta long Ta "unsigned long" Ta "long *"
@@ -295,7 +295,7 @@ or
 .Cm G
 conversion:
 .Bl -column "Modifier" "a, A, e, E, f, F, g, G"
-.It Sy Modifier Ta Cm a , A , e , E , f , F , g , G
+.It Sy Modifier Ta Cm "a,A,e,E,f,F,g,G"
 .It Cm L Ta Vt "long double"
 .El
 .Pp