Thread (45 messages) 45 messages, 4 authors, 2025-08-07

Re: [PATCH 04/10] fspick.2: document 'new' mount api

From: Alejandro Colomar <alx@kernel.org>
Date: 2025-08-06 07:48:41

Hi Aleksa,

On Wed, Aug 06, 2025 at 12:46:46PM +1000, Aleksa Sarai wrote:
quoted
quoted
+.TP
+.B EFAULT
+.I pathname
+is NULL or a pointer to a location outside the calling process's accessible
+address space.
In a lot of places, please use semantic newlines.  See man-pages(7).
In this particular case, where would you want a newline inserted? I
do somewhat understand wanting a newline after commas, but I don't see
which clause you would want to be split. Something like this?

.B EFAULT
.I pathname
is NULL
or a pointer
to a location outside the calling process's accessible address space?
I would have done

	.TP
	.B EFAULT
	.I pathname
	is NULL
	or a pointer to a location
	outside the calling process's accessible address space.

Your version isn't bad either.


Have a lovely day!
Alex

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

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help