[PATCH] man/man2/syscall.2: fix numbering for notes

[PATCH] man/man2/syscall.2: fix numbering for notes

[Thorsten Glaser]

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

Hi,

the table refers to numbered notes, but the notes just have
bullets. The attached patch fixes that.

bye,
//Thorsten (with $dayjob hat)
-- 
Thorsten Glaser
Linux / Unix Developer
Tel.: +49 160 91168501
E-Mail: tglaser@b1-systems.de

B1 Systems GmbH
Osterfeldstraße 7 / 85088 Vohburg / https://www.b1-systems.de/
GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt, HRB 3537

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-diff; name=0001-man-man2-syscall.2-fix-numbering-for-notes.patch, Size: 1776 bytes --]

From ff2e8c889d81bf696ded21cea2ab5e01b76900d5 Mon Sep 17 00:00:00 2001
From: Thorsten Glaser <tglaser@b1-systems.de>
Date: Mon, 2 Feb 2026 12:36:56 +0100
Subject: [PATCH] man/man2/syscall.2: fix numbering for notes

---
 man/man2/syscall.2 | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/man/man2/syscall.2 b/man/man2/syscall.2
index 54385cd..17e0eb5 100644
--- a/man/man2/syscall.2
+++ b/man/man2/syscall.2
@@ -197,7 +197,7 @@ xtensa	syscall	a2	a2	-	-
 .TE
 .P
 Notes:
-.IP \[bu] 3
+.IP 1) 3
 On a few architectures,
 a register is used as a boolean
 (0 indicating no error, and \-1 indicating an error) to signal that the
@@ -213,20 +213,20 @@ On powerpc64, the summary overflow bit
 in field 0 of the condition register
 .RI ( cr0 )
 is used.
-.IP \[bu]
+.IP 2)
 .I NR
 is the system call number.
-.IP \[bu]
+.IP 3)
 For s390 and s390x,
 .I NR
 (the system call number) may be passed directly with
 .I "svc\ NR"
 if it is less than 256.
-.IP \[bu]
+.IP 4)
 On SuperH additional trap numbers are supported for historic reasons, but
 .BR trapa #31
 is the recommended "unified" ABI.
-.IP \[bu]
+.IP 5)
 The x32 ABI shares syscall table with x86-64 ABI, but there are some
 nuances:
 .RS
@@ -266,7 +266,7 @@ but passes an 8-byte
 .I pos
 argument in a single register and not two, as is done in every other ABI.
 .RE
-.IP \[bu]
+.IP 6)
 Some architectures
 (namely, Alpha, IA-64, MIPS, SuperH, sparc/32, and sparc/64)
 use an additional register ("Retval2" in the above table)
@@ -324,7 +324,7 @@ xtensa	a6	a3	a4	a5	a8	a9	-
 .TE
 .P
 Notes:
-.IP \[bu] 3
+.IP 1) 3
 The mips/o32 system call convention passes
 arguments 5 through 8 on the user stack.
 .if t \{\
-- 
2.47.3

Re: [PATCH] man/man2/syscall.2: fix numbering for notes

[Alejandro Colomar]

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

Hi Thorsten,

On 2026-02-02T12:39:00+0100, Thorsten Glaser wrote:
> Hi,
> 
> the table refers to numbered notes, but the notes just have
> bullets. The attached patch fixes that.

Thanks!  I've applied the patch, and amended the commit to change the
format.  It's pushed already.

See man-pages(7):

	   Lists
	     There are different kinds of lists:

	     Tagged paragraphs
		...
	     Ordered lists
		...
	     Positional lists
		    Elements are preceded by a number (index) in square
		    brackets [4], [5].  These  represent  fields  in  a
		    set.  The first index will be:

		    0      When it represents fields of a C data struc‐
			   ture, to be consistent with arrays.
		    1      When  it  represents fields of a file, to be
			   consistent with tools like cut(1).

	     Alternatives list
		...
	     Bullet lists
		...
	     Numbered notes
		    Not  really  a list, but the syntax is identical to
		    "positional lists".

	     There should always be exactly 2 spaces between  the  list
	     symbol  and  the  elements.  This doesn’t apply to "tagged
	     paragraphs", which use the default indentation rules.

Have a lovely day!
Alex

> 
> bye,
> //Thorsten (with $dayjob hat)

:-)

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

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

Re: [PATCH] man/man2/syscall.2: fix numbering for notes

[Thorsten Glaser]

Hi Alex,

>Thanks!  I've applied the patch, and amended the commit to change the
>format.  It's pushed already.

Thanks.

>See man-pages(7):

Sure, if you have a “house style”, by all means. I didn’t see that one.

I tend to just “.Bl -enum” in mdoc(7) ☻ and I was a bit… left hanging
at the use of the legacy man(7) format in these manpages.

bye,
//Thorsten
-- 
Thorsten Glaser
Linux / Unix Developer
Tel.: +49 160 91168501
E-Mail: tglaser@b1-systems.de

B1 Systems GmbH
Osterfeldstraße 7 / 85088 Vohburg / https://www.b1-systems.de/
GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt, HRB 3537

Re: [PATCH] man/man2/syscall.2: fix numbering for notes

[Alejandro Colomar]

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

On 2026-02-02T14:43:19+0100, Alejandro Colomar wrote:
> Hi Thorsten,
> 
> On 2026-02-02T12:39:00+0100, Thorsten Glaser wrote:
> > Hi,
> > 
> > the table refers to numbered notes, but the notes just have
> > bullets. The attached patch fixes that.
> 
> Thanks!  I've applied the patch, and amended the commit to change the
> format.  It's pushed already.

BTW, sorry that I forgot to amend one line.  I pushed a fix-up.

Cheers,
Alex

> 
> See man-pages(7):
> 
> 	   Lists
> 	     There are different kinds of lists:
> 
> 	     Tagged paragraphs
> 		...
> 	     Ordered lists
> 		...
> 	     Positional lists
> 		    Elements are preceded by a number (index) in square
> 		    brackets [4], [5].  These  represent  fields  in  a
> 		    set.  The first index will be:
> 
> 		    0      When it represents fields of a C data struc‐
> 			   ture, to be consistent with arrays.
> 		    1      When  it  represents fields of a file, to be
> 			   consistent with tools like cut(1).
> 
> 	     Alternatives list
> 		...
> 	     Bullet lists
> 		...
> 	     Numbered notes
> 		    Not  really  a list, but the syntax is identical to
> 		    "positional lists".
> 
> 	     There should always be exactly 2 spaces between  the  list
> 	     symbol  and  the  elements.  This doesn’t apply to "tagged
> 	     paragraphs", which use the default indentation rules.
> 
> Have a lovely day!
> Alex
> 
> > 
> > bye,
> > //Thorsten (with $dayjob hat)
> 
> :-)
> 
> -- 
> <https://www.alejandro-colomar.es>



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

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