[PATCH 1/5] stdio.3, signal-safety.7: srcfix

[PATCH 1/5] stdio.3, signal-safety.7: srcfix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 7099 bytes --]

Prepare for `MR` macro migration.

Migrate table entries from using font selection escape sequences to font
alternation macros to set man page cross references.

This change was automatically driven by the following sed(1) script.

$ cat fix-man-page-refs-in-tbl-tables-2.sed
\# Rewrite man page cross references on tbl(1) rows that precede text
\# blocks to themselves use text blocks, and convert them to use man(7)
\# macros instead of troff(1) font selection escape sequences (which
\# cannot be done outside a text block).
/^\.\\"/b
/^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\
.BR \1 \2\
T}\3/

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
 man/man3/stdio.3         | 236 +++++++++++++++++++++++++++++----------
 man/man7/signal-safety.7 |  12 +-
 2 files changed, 186 insertions(+), 62 deletions(-)

diff --git a/man/man3/stdio.3 b/man/man3/stdio.3
index 6e534296f..728424c2c 100644
--- a/man/man3/stdio.3
+++ b/man/man3/stdio.3
@@ -162,181 +162,299 @@ .SS List of functions
 l l.
 Function	Description
 _
-\fBclearerr\fP(3)	T{
+T{
+.BR clearerr (3)
+T}	T{
 check and reset stream status
 T}
-\fBfclose\fP(3)	T{
+T{
+.BR fclose (3)
+T}	T{
 close a stream
 T}
-\fBfdopen\fP(3)	T{
+T{
+.BR fdopen (3)
+T}	T{
 stream open functions
 T}
-\fBfeof\fP(3)	T{
+T{
+.BR feof (3)
+T}	T{
 check and reset stream status
 T}
-\fBferror\fP(3)	T{
+T{
+.BR ferror (3)
+T}	T{
 check and reset stream status
 T}
-\fBfflush\fP(3)	T{
+T{
+.BR fflush (3)
+T}	T{
 flush a stream
 T}
-\fBfgetc\fP(3)	T{
+T{
+.BR fgetc (3)
+T}	T{
 get next character or word from input stream
 T}
-\fBfgetpos\fP(3)	T{
+T{
+.BR fgetpos (3)
+T}	T{
 reposition a stream
 T}
-\fBfgets\fP(3)	T{
+T{
+.BR fgets (3)
+T}	T{
 get a line from a stream
 T}
-\fBfileno\fP(3)	T{
+T{
+.BR fileno (3)
+T}	T{
 return the integer descriptor of the argument stream
 T}
-\fBfmemopen\fP(3)	T{
+T{
+.BR fmemopen (3)
+T}	T{
 open memory as stream
 T}
-\fBfopen\fP(3)	T{
+T{
+.BR fopen (3)
+T}	T{
 stream open functions
 T}
-\fBfopencookie\fP(3)	T{
+T{
+.BR fopencookie (3)
+T}	T{
 open a custom stream
 T}
-\fBfprintf\fP(3)	T{
+T{
+.BR fprintf (3)
+T}	T{
 formatted output conversion
 T}
-\fBfpurge\fP(3)	T{
+T{
+.BR fpurge (3)
+T}	T{
 flush a stream
 T}
-\fBfputc\fP(3)	T{
+T{
+.BR fputc (3)
+T}	T{
 output a character or word to a stream
 T}
-\fBfputs\fP(3)	T{
+T{
+.BR fputs (3)
+T}	T{
 output a line to a stream
 T}
-\fBfread\fP(3)	T{
+T{
+.BR fread (3)
+T}	T{
 binary stream input/output
 T}
-\fBfreopen\fP(3)	T{
+T{
+.BR freopen (3)
+T}	T{
 stream open functions
 T}
-\fBfscanf\fP(3)	T{
+T{
+.BR fscanf (3)
+T}	T{
 input format conversion
 T}
-\fBfseek\fP(3)	T{
+T{
+.BR fseek (3)
+T}	T{
 reposition a stream
 T}
-\fBfsetpos\fP(3)	T{
+T{
+.BR fsetpos (3)
+T}	T{
 reposition a stream
 T}
-\fBftell\fP(3)	T{
+T{
+.BR ftell (3)
+T}	T{
 reposition a stream
 T}
-\fBfwrite\fP(3)	T{
+T{
+.BR fwrite (3)
+T}	T{
 binary stream input/output
 T}
-\fBgetc\fP(3)	T{
+T{
+.BR getc (3)
+T}	T{
 get next character or word from input stream
 T}
-\fBgetchar\fP(3)	T{
+T{
+.BR getchar (3)
+T}	T{
 get next character or word from input stream
 T}
-\fBgets\fP(3)	T{
+T{
+.BR gets (3)
+T}	T{
 get a line from a stream
 T}
-\fBgetw\fP(3)	T{
+T{
+.BR getw (3)
+T}	T{
 get next character or word from input stream
 T}
-\fBmktemp\fP(3)	T{
+T{
+.BR mktemp (3)
+T}	T{
 make temporary filename (unique)
 T}
-\fBopen_memstream\fP(3)	T{
+T{
+.BR open_memstream (3)
+T}	T{
 open a dynamic memory buffer stream
 T}
-\fBopen_wmemstream\fP(3)	T{
+T{
+.BR open_wmemstream (3)
+T}	T{
 open a dynamic memory buffer stream
 T}
-\fBperror\fP(3)	T{
+T{
+.BR perror (3)
+T}	T{
 system error messages
 T}
-\fBprintf\fP(3)	T{
+T{
+.BR printf (3)
+T}	T{
 formatted output conversion
 T}
-\fBputc\fP(3)	T{
+T{
+.BR putc (3)
+T}	T{
 output a character or word to a stream
 T}
-\fBputchar\fP(3)	T{
+T{
+.BR putchar (3)
+T}	T{
 output a character or word to a stream
 T}
-\fBputs\fP(3)	T{
+T{
+.BR puts (3)
+T}	T{
 output a line to a stream
 T}
-\fBputw\fP(3)	T{
+T{
+.BR putw (3)
+T}	T{
 output a character or word to a stream
 T}
-\fBremove\fP(3)	T{
+T{
+.BR remove (3)
+T}	T{
 remove directory entry
 T}
-\fBrewind\fP(3)	T{
+T{
+.BR rewind (3)
+T}	T{
 reposition a stream
 T}
-\fBscanf\fP(3)	T{
+T{
+.BR scanf (3)
+T}	T{
 input format conversion
 T}
-\fBsetbuf\fP(3)	T{
+T{
+.BR setbuf (3)
+T}	T{
 stream buffering operations
 T}
-\fBsetbuffer\fP(3)	T{
+T{
+.BR setbuffer (3)
+T}	T{
 stream buffering operations
 T}
-\fBsetlinebuf\fP(3)	T{
+T{
+.BR setlinebuf (3)
+T}	T{
 stream buffering operations
 T}
-\fBsetvbuf\fP(3)	T{
+T{
+.BR setvbuf (3)
+T}	T{
 stream buffering operations
 T}
-\fBsprintf\fP(3)	T{
+T{
+.BR sprintf (3)
+T}	T{
 formatted output conversion
 T}
-\fBsscanf\fP(3)	T{
+T{
+.BR sscanf (3)
+T}	T{
 input format conversion
 T}
-\fBstrerror\fP(3)	T{
+T{
+.BR strerror (3)
+T}	T{
 system error messages
 T}
-\fBsys_errlist\fP(3)	T{
+T{
+.BR sys_errlist (3)
+T}	T{
 system error messages
 T}
-\fBsys_nerr\fP(3)	T{
+T{
+.BR sys_nerr (3)
+T}	T{
 system error messages
 T}
-\fBtempnam\fP(3)	T{
+T{
+.BR tempnam (3)
+T}	T{
 temporary file routines
 T}
-\fBtmpfile\fP(3)	T{
+T{
+.BR tmpfile (3)
+T}	T{
 temporary file routines
 T}
-\fBtmpnam\fP(3)	T{
+T{
+.BR tmpnam (3)
+T}	T{
 temporary file routines
 T}
-\fBungetc\fP(3)	T{
+T{
+.BR ungetc (3)
+T}	T{
 un-get character from input stream
 T}
-\fBvfprintf\fP(3)	T{
+T{
+.BR vfprintf (3)
+T}	T{
 formatted output conversion
 T}
-\fBvfscanf\fP(3)	T{
+T{
+.BR vfscanf (3)
+T}	T{
 input format conversion
 T}
-\fBvprintf\fP(3)	T{
+T{
+.BR vprintf (3)
+T}	T{
 formatted output conversion
 T}
-\fBvscanf\fP(3)	T{
+T{
+.BR vscanf (3)
+T}	T{
 input format conversion
 T}
-\fBvsprintf\fP(3)	T{
+T{
+.BR vsprintf (3)
+T}	T{
 formatted output conversion
 T}
-\fBvsscanf\fP(3)	T{
+T{
+.BR vsscanf (3)
+T}	T{
 input format conversion
 T}
 .TE
diff --git a/man/man7/signal-safety.7 b/man/man7/signal-safety.7
index cde19a575..440894529 100644
--- a/man/man7/signal-safety.7
+++ b/man/man7/signal-safety.7
@@ -95,7 +95,9 @@ .SH DESCRIPTION
 \fBcreat\fP(2)
 \fBdup\fP(2)
 \fBdup2\fP(2)
-\fBexecl\fP(3)	T{
+T{
+.BR execl (3)
+T}	T{
 Added in POSIX.1-2008; see notes below
 T}
 \fBexecle\fP(3)	See notes below
@@ -136,7 +138,9 @@ .SH DESCRIPTION
 \fBlink\fP(2)
 \fBlinkat\fP(2)	Added in POSIX.1-2008
 \fBlisten\fP(2)
-\fBlongjmp\fP(3)	T{
+T{
+.BR longjmp (3)
+T}	T{
 Added in POSIX.1-2008 TC2; see notes below
 T}
 \fBlseek\fP(2)
@@ -192,7 +196,9 @@ .SH DESCRIPTION
 \fBsigemptyset\fP(3)
 \fBsigfillset\fP(3)
 \fBsigismember\fP(3)
-\fBsiglongjmp\fP(3)	T{
+T{
+.BR siglongjmp (3)
+T}	T{
 Added in POSIX.1-2008 TC2; see notes below
 T}
 \fBsignal\fP(2)
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 2/5] syscalls.2, signal-safety.7, namespaces.7: srcfix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 1638 bytes --]

Explicitly set the width of certain table columns so that they don't
change or cause "can't break line" warnings from troff(1) when the rows
are converted to use text blocks.

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
 man/man2/syscalls.2      | 4 ++--
 man/man7/namespaces.7    | 4 ++--
 man/man7/signal-safety.7 | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/man/man2/syscalls.2 b/man/man2/syscalls.2
index c259901e7..89c4e7f10 100644
--- a/man/man2/syscalls.2
+++ b/man/man2/syscalls.2
@@ -139,8 +139,8 @@ .SS System call list
 .\" instructive about x86 specifics.
 .\"
 .TS
-Lb Lb Lb
-L2 L  Lx.
+Lb       Lb Lb
+Lw(26n)2 L  Lx.
 System call	Kernel	Notes
 _
 \fB_llseek\fP(2)	1.2
diff --git a/man/man7/namespaces.7 b/man/man7/namespaces.7
index 5cf054665..9f0fda553 100644
--- a/man/man7/namespaces.7
+++ b/man/man7/namespaces.7
@@ -30,8 +30,8 @@ .SS Namespace types
 The last column is a summary of the resources that are isolated by
 the namespace type.
 .TS
-lB lB lB lB
-l1 lB1 l1 l.
+lB lB  lB       lB
+l1 lB1 lw(21n)1 lx.
 Namespace	Flag	Page	Isolates
 Cgroup	CLONE_NEWCGROUP	\fBcgroup_namespaces\fP(7)	T{
 Cgroup root directory
diff --git a/man/man7/signal-safety.7 b/man/man7/signal-safety.7
index 440894529..36cbf8d6e 100644
--- a/man/man7/signal-safety.7
+++ b/man/man7/signal-safety.7
@@ -71,8 +71,8 @@ .SH DESCRIPTION
 the table details changes in the subsequent standards.
 .P
 .TS
-lb lb
-l l.
+lb      lb
+lw(24n) l.
 Function	Notes
 \fBabort\fP(3)	Added in POSIX.1-2001 TC1
 \fBaccept\fP(2)
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 3/5] namespaces.7: ffix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 695 bytes --]

Let the table columns breathe again.

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
---
 man/man7/namespaces.7 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man/man7/namespaces.7 b/man/man7/namespaces.7
index 9f0fda553..cf3436f09 100644
--- a/man/man7/namespaces.7
+++ b/man/man7/namespaces.7
@@ -30,8 +30,8 @@ .SS Namespace types
 The last column is a summary of the resources that are isolated by
 the namespace type.
 .TS
-lB lB  lB       lB
-l1 lB1 lw(21n)1 lx.
+lB lB lB      lB
+l  lB lw(21n) lx.
 Namespace	Flag	Page	Isolates
 Cgroup	CLONE_NEWCGROUP	\fBcgroup_namespaces\fP(7)	T{
 Cgroup root directory
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 8267 bytes --]

On Sat, Aug 31, 2024 at 01:20:27PM GMT, G. Branden Robinson wrote:
> Prepare for `MR` macro migration.
> 
> Migrate table entries from using font selection escape sequences to font
> alternation macros to set man page cross references.
> 
> This change was automatically driven by the following sed(1) script.
> 
> $ cat fix-man-page-refs-in-tbl-tables-2.sed
> \# Rewrite man page cross references on tbl(1) rows that precede text

Hi Branden,

I guess \# doesn't appear in your actual script.
What I usually do to avoid problems with git(1) is to indent everything.

> \# blocks to themselves use text blocks, and convert them to use man(7)
> \# macros instead of troff(1) font selection escape sequences (which
> \# cannot be done outside a text block).
> /^\.\\"/b
> /^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\
> .BR \1 \2\
> T}\3/
> 
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>

Patch applied.  Thanks!

Have a lovely night!
Alex
> ---
>  man/man3/stdio.3         | 236 +++++++++++++++++++++++++++++----------
>  man/man7/signal-safety.7 |  12 +-
>  2 files changed, 186 insertions(+), 62 deletions(-)
> 
> diff --git a/man/man3/stdio.3 b/man/man3/stdio.3
> index 6e534296f..728424c2c 100644
> --- a/man/man3/stdio.3
> +++ b/man/man3/stdio.3
> @@ -162,181 +162,299 @@ .SS List of functions
>  l l.
>  Function	Description
>  _
> -\fBclearerr\fP(3)	T{
> +T{
> +.BR clearerr (3)
> +T}	T{
>  check and reset stream status
>  T}
> -\fBfclose\fP(3)	T{
> +T{
> +.BR fclose (3)
> +T}	T{
>  close a stream
>  T}
> -\fBfdopen\fP(3)	T{
> +T{
> +.BR fdopen (3)
> +T}	T{
>  stream open functions
>  T}
> -\fBfeof\fP(3)	T{
> +T{
> +.BR feof (3)
> +T}	T{
>  check and reset stream status
>  T}
> -\fBferror\fP(3)	T{
> +T{
> +.BR ferror (3)
> +T}	T{
>  check and reset stream status
>  T}
> -\fBfflush\fP(3)	T{
> +T{
> +.BR fflush (3)
> +T}	T{
>  flush a stream
>  T}
> -\fBfgetc\fP(3)	T{
> +T{
> +.BR fgetc (3)
> +T}	T{
>  get next character or word from input stream
>  T}
> -\fBfgetpos\fP(3)	T{
> +T{
> +.BR fgetpos (3)
> +T}	T{
>  reposition a stream
>  T}
> -\fBfgets\fP(3)	T{
> +T{
> +.BR fgets (3)
> +T}	T{
>  get a line from a stream
>  T}
> -\fBfileno\fP(3)	T{
> +T{
> +.BR fileno (3)
> +T}	T{
>  return the integer descriptor of the argument stream
>  T}
> -\fBfmemopen\fP(3)	T{
> +T{
> +.BR fmemopen (3)
> +T}	T{
>  open memory as stream
>  T}
> -\fBfopen\fP(3)	T{
> +T{
> +.BR fopen (3)
> +T}	T{
>  stream open functions
>  T}
> -\fBfopencookie\fP(3)	T{
> +T{
> +.BR fopencookie (3)
> +T}	T{
>  open a custom stream
>  T}
> -\fBfprintf\fP(3)	T{
> +T{
> +.BR fprintf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBfpurge\fP(3)	T{
> +T{
> +.BR fpurge (3)
> +T}	T{
>  flush a stream
>  T}
> -\fBfputc\fP(3)	T{
> +T{
> +.BR fputc (3)
> +T}	T{
>  output a character or word to a stream
>  T}
> -\fBfputs\fP(3)	T{
> +T{
> +.BR fputs (3)
> +T}	T{
>  output a line to a stream
>  T}
> -\fBfread\fP(3)	T{
> +T{
> +.BR fread (3)
> +T}	T{
>  binary stream input/output
>  T}
> -\fBfreopen\fP(3)	T{
> +T{
> +.BR freopen (3)
> +T}	T{
>  stream open functions
>  T}
> -\fBfscanf\fP(3)	T{
> +T{
> +.BR fscanf (3)
> +T}	T{
>  input format conversion
>  T}
> -\fBfseek\fP(3)	T{
> +T{
> +.BR fseek (3)
> +T}	T{
>  reposition a stream
>  T}
> -\fBfsetpos\fP(3)	T{
> +T{
> +.BR fsetpos (3)
> +T}	T{
>  reposition a stream
>  T}
> -\fBftell\fP(3)	T{
> +T{
> +.BR ftell (3)
> +T}	T{
>  reposition a stream
>  T}
> -\fBfwrite\fP(3)	T{
> +T{
> +.BR fwrite (3)
> +T}	T{
>  binary stream input/output
>  T}
> -\fBgetc\fP(3)	T{
> +T{
> +.BR getc (3)
> +T}	T{
>  get next character or word from input stream
>  T}
> -\fBgetchar\fP(3)	T{
> +T{
> +.BR getchar (3)
> +T}	T{
>  get next character or word from input stream
>  T}
> -\fBgets\fP(3)	T{
> +T{
> +.BR gets (3)
> +T}	T{
>  get a line from a stream
>  T}
> -\fBgetw\fP(3)	T{
> +T{
> +.BR getw (3)
> +T}	T{
>  get next character or word from input stream
>  T}
> -\fBmktemp\fP(3)	T{
> +T{
> +.BR mktemp (3)
> +T}	T{
>  make temporary filename (unique)
>  T}
> -\fBopen_memstream\fP(3)	T{
> +T{
> +.BR open_memstream (3)
> +T}	T{
>  open a dynamic memory buffer stream
>  T}
> -\fBopen_wmemstream\fP(3)	T{
> +T{
> +.BR open_wmemstream (3)
> +T}	T{
>  open a dynamic memory buffer stream
>  T}
> -\fBperror\fP(3)	T{
> +T{
> +.BR perror (3)
> +T}	T{
>  system error messages
>  T}
> -\fBprintf\fP(3)	T{
> +T{
> +.BR printf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBputc\fP(3)	T{
> +T{
> +.BR putc (3)
> +T}	T{
>  output a character or word to a stream
>  T}
> -\fBputchar\fP(3)	T{
> +T{
> +.BR putchar (3)
> +T}	T{
>  output a character or word to a stream
>  T}
> -\fBputs\fP(3)	T{
> +T{
> +.BR puts (3)
> +T}	T{
>  output a line to a stream
>  T}
> -\fBputw\fP(3)	T{
> +T{
> +.BR putw (3)
> +T}	T{
>  output a character or word to a stream
>  T}
> -\fBremove\fP(3)	T{
> +T{
> +.BR remove (3)
> +T}	T{
>  remove directory entry
>  T}
> -\fBrewind\fP(3)	T{
> +T{
> +.BR rewind (3)
> +T}	T{
>  reposition a stream
>  T}
> -\fBscanf\fP(3)	T{
> +T{
> +.BR scanf (3)
> +T}	T{
>  input format conversion
>  T}
> -\fBsetbuf\fP(3)	T{
> +T{
> +.BR setbuf (3)
> +T}	T{
>  stream buffering operations
>  T}
> -\fBsetbuffer\fP(3)	T{
> +T{
> +.BR setbuffer (3)
> +T}	T{
>  stream buffering operations
>  T}
> -\fBsetlinebuf\fP(3)	T{
> +T{
> +.BR setlinebuf (3)
> +T}	T{
>  stream buffering operations
>  T}
> -\fBsetvbuf\fP(3)	T{
> +T{
> +.BR setvbuf (3)
> +T}	T{
>  stream buffering operations
>  T}
> -\fBsprintf\fP(3)	T{
> +T{
> +.BR sprintf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBsscanf\fP(3)	T{
> +T{
> +.BR sscanf (3)
> +T}	T{
>  input format conversion
>  T}
> -\fBstrerror\fP(3)	T{
> +T{
> +.BR strerror (3)
> +T}	T{
>  system error messages
>  T}
> -\fBsys_errlist\fP(3)	T{
> +T{
> +.BR sys_errlist (3)
> +T}	T{
>  system error messages
>  T}
> -\fBsys_nerr\fP(3)	T{
> +T{
> +.BR sys_nerr (3)
> +T}	T{
>  system error messages
>  T}
> -\fBtempnam\fP(3)	T{
> +T{
> +.BR tempnam (3)
> +T}	T{
>  temporary file routines
>  T}
> -\fBtmpfile\fP(3)	T{
> +T{
> +.BR tmpfile (3)
> +T}	T{
>  temporary file routines
>  T}
> -\fBtmpnam\fP(3)	T{
> +T{
> +.BR tmpnam (3)
> +T}	T{
>  temporary file routines
>  T}
> -\fBungetc\fP(3)	T{
> +T{
> +.BR ungetc (3)
> +T}	T{
>  un-get character from input stream
>  T}
> -\fBvfprintf\fP(3)	T{
> +T{
> +.BR vfprintf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBvfscanf\fP(3)	T{
> +T{
> +.BR vfscanf (3)
> +T}	T{
>  input format conversion
>  T}
> -\fBvprintf\fP(3)	T{
> +T{
> +.BR vprintf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBvscanf\fP(3)	T{
> +T{
> +.BR vscanf (3)
> +T}	T{
>  input format conversion
>  T}
> -\fBvsprintf\fP(3)	T{
> +T{
> +.BR vsprintf (3)
> +T}	T{
>  formatted output conversion
>  T}
> -\fBvsscanf\fP(3)	T{
> +T{
> +.BR vsscanf (3)
> +T}	T{
>  input format conversion
>  T}
>  .TE
> diff --git a/man/man7/signal-safety.7 b/man/man7/signal-safety.7
> index cde19a575..440894529 100644
> --- a/man/man7/signal-safety.7
> +++ b/man/man7/signal-safety.7
> @@ -95,7 +95,9 @@ .SH DESCRIPTION
>  \fBcreat\fP(2)
>  \fBdup\fP(2)
>  \fBdup2\fP(2)
> -\fBexecl\fP(3)	T{
> +T{
> +.BR execl (3)
> +T}	T{
>  Added in POSIX.1-2008; see notes below
>  T}
>  \fBexecle\fP(3)	See notes below
> @@ -136,7 +138,9 @@ .SH DESCRIPTION
>  \fBlink\fP(2)
>  \fBlinkat\fP(2)	Added in POSIX.1-2008
>  \fBlisten\fP(2)
> -\fBlongjmp\fP(3)	T{
> +T{
> +.BR longjmp (3)
> +T}	T{
>  Added in POSIX.1-2008 TC2; see notes below
>  T}
>  \fBlseek\fP(2)
> @@ -192,7 +196,9 @@ .SH DESCRIPTION
>  \fBsigemptyset\fP(3)
>  \fBsigfillset\fP(3)
>  \fBsigismember\fP(3)
> -\fBsiglongjmp\fP(3)	T{
> +T{
> +.BR siglongjmp (3)
> +T}	T{
>  Added in POSIX.1-2008 TC2; see notes below
>  T}
>  \fBsignal\fP(2)
> -- 
> 2.30.2
> 



-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 2/5] syscalls.2, signal-safety.7, namespaces.7: srcfix

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1932 bytes --]

Hi Branden,

On Sat, Aug 31, 2024 at 01:20:45PM GMT, G. Branden Robinson wrote:
> Explicitly set the width of certain table columns so that they don't
> change or cause "can't break line" warnings from troff(1) when the rows
> are converted to use text blocks.
> 
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
> ---
>  man/man2/syscalls.2      | 4 ++--
>  man/man7/namespaces.7    | 4 ++--
>  man/man7/signal-safety.7 | 4 ++--
>  3 files changed, 6 insertions(+), 6 deletions(-)
> 
> diff --git a/man/man2/syscalls.2 b/man/man2/syscalls.2
> index c259901e7..89c4e7f10 100644
> --- a/man/man2/syscalls.2
> +++ b/man/man2/syscalls.2
> @@ -139,8 +139,8 @@ .SS System call list
>  .\" instructive about x86 specifics.
>  .\"
>  .TS
> -Lb Lb Lb
> -L2 L  Lx.
> +Lb       Lb Lb
> +Lw(26n)2 L  Lx.

Ughh, I've applied it.

Cheers,
Alex

>  System call	Kernel	Notes
>  _
>  \fB_llseek\fP(2)	1.2
> diff --git a/man/man7/namespaces.7 b/man/man7/namespaces.7
> index 5cf054665..9f0fda553 100644
> --- a/man/man7/namespaces.7
> +++ b/man/man7/namespaces.7
> @@ -30,8 +30,8 @@ .SS Namespace types
>  The last column is a summary of the resources that are isolated by
>  the namespace type.
>  .TS
> -lB lB lB lB
> -l1 lB1 l1 l.
> +lB lB  lB       lB
> +l1 lB1 lw(21n)1 lx.
>  Namespace	Flag	Page	Isolates
>  Cgroup	CLONE_NEWCGROUP	\fBcgroup_namespaces\fP(7)	T{
>  Cgroup root directory
> diff --git a/man/man7/signal-safety.7 b/man/man7/signal-safety.7
> index 440894529..36cbf8d6e 100644
> --- a/man/man7/signal-safety.7
> +++ b/man/man7/signal-safety.7
> @@ -71,8 +71,8 @@ .SH DESCRIPTION
>  the table details changes in the subsequent standards.
>  .P
>  .TS
> -lb lb
> -l l.
> +lb      lb
> +lw(24n) l.
>  Function	Notes
>  \fBabort\fP(3)	Added in POSIX.1-2001 TC1
>  \fBaccept\fP(2)
> -- 
> 2.30.2
> 



-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 3/5] namespaces.7: ffix

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 907 bytes --]

On Sat, Aug 31, 2024 at 01:20:57PM GMT, G. Branden Robinson wrote:
> Let the table columns breathe again.
> 
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>

Patch applied.  Thanks!

Cheers,
Alex

> ---
>  man/man7/namespaces.7 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man/man7/namespaces.7 b/man/man7/namespaces.7
> index 9f0fda553..cf3436f09 100644
> --- a/man/man7/namespaces.7
> +++ b/man/man7/namespaces.7
> @@ -30,8 +30,8 @@ .SS Namespace types
>  The last column is a summary of the resources that are isolated by
>  the namespace type.
>  .TS
> -lB lB  lB       lB
> -l1 lB1 lw(21n)1 lx.
> +lB lB lB      lB
> +l  lB lw(21n) lx.
>  Namespace	Flag	Page	Isolates
>  Cgroup	CLONE_NEWCGROUP	\fBcgroup_namespaces\fP(7)	T{
>  Cgroup root directory
> -- 
> 2.30.2
> 



-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 2458 bytes --]

Hi Alex,

At 2024-08-31T22:43:04+0200, Alejandro Colomar wrote:
> On Sat, Aug 31, 2024 at 01:20:27PM GMT, G. Branden Robinson wrote:
[...]
> I guess \# doesn't appear in your actual script.  What I usually do to
> avoid problems with git(1) is to indent everything.

Reasonable in some circumstances, but I had a second problem--one of the
sed commands was very long, and I didn't to make an overlong line even
worse with indentation...

> > \# blocks to themselves use text blocks, and convert them to use man(7)
> > \# macros instead of troff(1) font selection escape sequences (which
> > \# cannot be done outside a text block).
> > /^\.\\"/b
> > /^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\

...thus.

> > diff --git a/man/man2/syscalls.2 b/man/man2/syscalls.2
> > index c259901e7..89c4e7f10 100644
> > --- a/man/man2/syscalls.2
> > +++ b/man/man2/syscalls.2
> > @@ -139,8 +139,8 @@ .SS System call list
> >  .\" instructive about x86 specifics.
> >  .\"
> >  .TS
> > -Lb Lb Lb
> > -L2 L  Lx.
> > +Lb       Lb Lb
> > +Lw(26n)2 L  Lx.
> 
> Ughh, I've applied it.

I expected you wouldn't like it, and, yes, it's ugly and not
future-proof,[1] but:

1.  It was really important to me to demonstrate that the large changes
    I was making diff-wise didn't regress the state of the rendered
    page.  Hence "dump-page.sh" and doing the cmp(1) comparison.

    When this page was converted to text blocks, the leftmost column
    shrank by (IIRC) 2 character cells.  I didn't want a corruption of
    text to hide amid that.

2.  The table format can be further changed after the (intrusive) `MR`
    migration; either restoring the previous or using the `x` column
    modifier in multiple columns, which I know GNU tbl supports and I
    think mandoc(1) does too.

3.  Indecision about what to do put a lag of a month in following up on
    my previous "migration preparation" attempt,[2][3] so I decided to
    just cut through the difficulty by applying the principle in the
    first point.

Regards,
Branden

[1] People who pray might want to pray that Linux system call names
    don't get _even longer_.

[2] https://lore.kernel.org/linux-man/20240727210927.d3iiwpbvkvtp2mzs@illithid/

[3] ...although subscribers to the bug-groff and/or groff-commit lists
    can make some pretty shrewd guesses about what accounts for _most_
    of the delay.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 4918 bytes --]

Hi Branden,

Any advances with git-send-email(1)?  I've added some more documentation
for it:

	commit 60660c87e8f75edd9f9d93666315f313dd3743db (HEAD -> contrib, alx/contrib)
	Author: Alejandro Colomar <alx@kernel.org>
	Date:   Sat Aug 31 23:38:20 2024 +0200

	    CONTRIBUTING.d/git: Recommend format.thread=true
	    
	    This generates patch sets as threads, with a Message-ID pre-set for the
	    first mail.
	    
	    Cc: "G. Branden Robinson" <branden@debian.org>
	    Signed-off-by: Alejandro Colomar <alx@kernel.org>

	diff --git a/CONTRIBUTING.d/git b/CONTRIBUTING.d/git
	index 4f1003a61..0029e7ee2 100644
	--- a/CONTRIBUTING.d/git
	+++ b/CONTRIBUTING.d/git
	@@ -1,38 +1,42 @@
	 Name
		Git - instructions for configuring git(1)
	 
	 Description
	    git-diff(1), gitattributes(5)
		To produce useful hunk contexts in manual pages, we need to hack
		git(1)'s idea of a function name, and also to tell git what is a
		manual page.
	 
		    $ git config --global diff.man.xfuncname '^\.S[SHsh] .*$';
		    $ echo '*.[0-9]* diff=man' >>~/.config/git/attributes;
	 
	    git-format-patch(1)
		Send patches to the right addresses.
	 
		    $ git config --local format.to 'Alejandro Colomar <alx@kernel.org>';
		    $ git config --local format.cc '<linux-man@vger.kernel.org>';
	 
	+       Generate patch sets as a thread.
	+
	+           $ git config --global format.thread true;
	+
	    git-send-email(1)
		If mutt(1) or neomutt(1) are configured in the system,
		git-send-email(1) can be configured to use any of them as a
		driver.  Recent versions of neomutt(1) can enable crypto with -C.
	 
		    $ git config --global \
			    sendemail.sendmailcmd 'neomutt -C -H - && true';
		or
		    $ git config --global sendemail.sendmailcmd 'mutt -H - && true';
	 
	 See also
		git-config(1)
		git-diff(1)
		git-format-patch(1)
		git-send-email(1)
		gitattributes(5)
		mutt(1)
		neomutt(1)
	 
		CONTRIBUTING.d/*


On Sat, Aug 31, 2024 at 04:23:21PM GMT, G. Branden Robinson wrote:
> Hi Alex,
> 
> At 2024-08-31T22:43:04+0200, Alejandro Colomar wrote:
> > On Sat, Aug 31, 2024 at 01:20:27PM GMT, G. Branden Robinson wrote:
> [...]
> > I guess \# doesn't appear in your actual script.  What I usually do to
> > avoid problems with git(1) is to indent everything.
> 
> Reasonable in some circumstances, but I had a second problem--one of the
> sed commands was very long, and I didn't to make an overlong line even
> worse with indentation...
> 
> > > \# blocks to themselves use text blocks, and convert them to use man(7)
> > > \# macros instead of troff(1) font selection escape sequences (which
> > > \# cannot be done outside a text block).
> > > /^\.\\"/b
> > > /^\\fB[^\\]*\\fP([0-9][a-z]*).*T{/s/\\fB\([^\\]*\)\\fP\(([0-9][a-z]*)\)\(.*\)/T{\
> 
> ...thus.

I prefer long lines than scripts that need to be fixed before running.

> 
> > > diff --git a/man/man2/syscalls.2 b/man/man2/syscalls.2
> > > index c259901e7..89c4e7f10 100644
> > > --- a/man/man2/syscalls.2
> > > +++ b/man/man2/syscalls.2
> > > @@ -139,8 +139,8 @@ .SS System call list
> > >  .\" instructive about x86 specifics.
> > >  .\"
> > >  .TS
> > > -Lb Lb Lb
> > > -L2 L  Lx.
> > > +Lb       Lb Lb
> > > +Lw(26n)2 L  Lx.
> > 
> > Ughh, I've applied it.
> 
> I expected you wouldn't like it, and, yes, it's ugly and not
> future-proof,[1] but:
> 
> 1.  It was really important to me to demonstrate that the large changes
>     I was making diff-wise didn't regress the state of the rendered
>     page.  Hence "dump-page.sh" and doing the cmp(1) comparison.
> 
>     When this page was converted to text blocks, the leftmost column
>     shrank by (IIRC) 2 character cells.  I didn't want a corruption of
>     text to hide amid that.
> 
> 2.  The table format can be further changed after the (intrusive) `MR`
>     migration; either restoring the previous or using the `x` column
>     modifier in multiple columns, which I know GNU tbl supports and I
>     think mandoc(1) does too.
> 
> 3.  Indecision about what to do put a lag of a month in following up on
>     my previous "migration preparation" attempt,[2][3] so I decided to
>     just cut through the difficulty by applying the principle in the
>     first point.

Sounds reasonable.  I've applied patches 1, 2, and 3.  I haven't applied
4 and 5.  Please resend, as smaller patches if possible.

Cheers,
Alex

> 
> Regards,
> Branden
> 
> [1] People who pray might want to pray that Linux system call names
>     don't get _even longer_.
> 
> [2] https://lore.kernel.org/linux-man/20240727210927.d3iiwpbvkvtp2mzs@illithid/
> 
> [3] ...although subscribers to the bug-groff and/or groff-commit lists
>     can make some pretty shrewd guesses about what accounts for _most_
>     of the delay.



-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 153 bytes --]

At 2024-08-31T23:43:01+0200, Alejandro Colomar wrote:
> Any advances with git-send-email(1)?

No--I'm still stuck on neomutt 20201127.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 638 bytes --]

Hi Branden,

On Sat, Aug 31, 2024 at 05:17:59PM GMT, G. Branden Robinson wrote:
> At 2024-08-31T23:43:01+0200, Alejandro Colomar wrote:
> > Any advances with git-send-email(1)?
> 
> No--I'm still stuck on neomutt 20201127.

I think that if you use --thread with git-format-patch(1), (or configure
it via the change I showed), you'll be able to use neomutt(1) as you're
doing now.  The generated patches should contain pre-set In-Reply-To
headers which refer to the first patch, which will have a pre-set
Message-ID.  Please check.

Cheers,
Alex

> 
> Regards,
> Branden



-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/5] stdio.3, signal-safety.7: srcfix

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 848 bytes --]

Hi Alex,

At 2024-09-01T00:27:38+0200, Alejandro Colomar wrote:
> On Sat, Aug 31, 2024 at 05:17:59PM GMT, G. Branden Robinson wrote:
> > At 2024-08-31T23:43:01+0200, Alejandro Colomar wrote:
> > > Any advances with git-send-email(1)?
> > 
> > No--I'm still stuck on neomutt 20201127.
> 
> I think that if you use --thread with git-format-patch(1),
[...]
> you'll be able to use neomutt(1) as you're doing now.  The generated
> patches should contain pre-set In-Reply-To headers which refer to the
> first patch, which will have a pre-set Message-ID.  Please check.

I will try this with my next set.  With a handful of manual edits to
some oddball cases, I've gotten to this point:

$ wc -l ready.MR straggling.MR
 17136 ready.MR
     0 straggling.MR
 17136 total

That means no more of \fBthese\fP(1).

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]