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

Re: How and when to control hyphenation (was: [PATCH 05/10] fsconfig.2: document 'new' mount api)

From: Askar Safin <hidden>
Date: 2025-08-06 14:30:12

 ---- On Wed, 06 Aug 2025 15:45:46 +0400  Alejandro Colomar [off-list ref] wrote --- 
I personally never use it, unless I read the page and find some line
break ugly.  And *never* use it in manual page references (BR), with the
rationale being that we'll eventually replace them with MR, which does
that for us.
Aaaaaaah! I hate all these quirks. I hate all these roff quirks, mentioned in this thread.

It seems we did not get manpages for "new" mount API earlier, because Brauner gave up on roff.
He said: "Years of writing groff have made me tired" here: https://github.com/brauner/man-pages-md .

So I propose to convert manpages to some other format. For example, to reStructuredText.
This is what kernel uses. This will help attract kernel developers. So, please, convert.
At least mans in man2. reStructuredText can be converted to roff: https://docutils.sourceforge.io/docs/user/manpage.html .

--
Askar Safin
https://types.pl/@safinaskar
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help