All of lore.kernel.org
 help / color / mirror / Atom feed
From: Alejandro Colomar <alx@kernel.org>
To: Thorsten Glaser <tglaser@b1-systems.de>
Cc: linux-man@vger.kernel.org
Subject: Re: [PATCH] man/man2/syscall.2: fix numbering for notes
Date: Mon, 2 Feb 2026 14:43:16 +0100	[thread overview]
Message-ID: <aYCnGFboK-95B8AY@devuan> (raw)
In-Reply-To: <7b1b7c56-ad07-40b7-5387-08a4b60e3078@b1-systems.de>

[-- 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 --]

  reply	other threads:[~2026-02-02 13:43 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-02-02 11:39 [PATCH] man/man2/syscall.2: fix numbering for notes Thorsten Glaser
2026-02-02 13:43 ` Alejandro Colomar [this message]
2026-02-02 13:48   ` Thorsten Glaser
2026-02-02 14:01   ` Alejandro Colomar

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=aYCnGFboK-95B8AY@devuan \
    --to=alx@kernel.org \
    --cc=linux-man@vger.kernel.org \
    --cc=tglaser@b1-systems.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.