Re: [RFC PATCH liburing] man: Convert manpages to markdown
Gabriel Krisman Bertazi <[email protected]>
| Newsgroups | org.kernel.vger.io-uring |
|---|---|
| Message-ID | <[email protected]> |
Ammar Faizi <[email protected]> writes: > On 6/19/26 6:05 AM, Gabriel Krisman Bertazi wrote: >> This has been discussed for a while due to the ongoing pain of writing >> groff. Now that we just had a release, convert the manpages to markdown >> and add infrastructure to generate back the groff automatically during >> compilation. > > Wow, big changes: > > 399 files changed, 11719 insertions(+), 18975 deletions(-) > > Yeah, I agree that writing in GNU roff is more painful than writing in > markdown. Interesting patch. Yeah, this is gonna be shitty to review. The conversion was done mostly automatically though, you can review Makefile for that. I'll split it up into manageable chunks. > > Can we also word-wrap the markdown files? It's easier to read them in > raw if they're word-wrapped as well. Let me see if I can get the right pandoc incantation. -- Gabriel Krisman Bertazi