man: convert to reStructuredText
I'm mostly opening this as an RFC to gather feedback. For now only one man page has been converted.
Signed-off-by: Simon Ser contact@emersion.fr
Merge request reports
Activity
Been meaning to do this since forever; thanks for doing it!
If you convert them all (please do!), can I suggest an initial commit to put everything in place in meson but with an empty list, then one commit per page converted, and a final commit removing the leftover xml?
You can already put my
Acked-by: Eric Engestrom <eric@engestrom.ch>
on all of those, and if you tag me on the MR I'll happily review each conversion
added docs label
Don't get me wrong, I like man pages and would like to keep them if possible. I'd just prefer to avoid duplicating docs between the website, inline docs and man pages.
I suppose all of this doesn't really affect this MR though. We'll want to write website docs in rst anyway, we'll be able to easily convert the man pages if necessary and/or move them to inline doc comments.
Edited by Simon Ser(I just realized I forgot to reply to this.)
My point was that it would be good to generate both the man pages and website docs from inline docs, not to have yet another source of documentation.
But you're right that this is orthogonal to this MR, I just mentioned it because you might be interested in that as well :)
added 42 commits
-
13206faf...fc479e13 - 41 commits from branch
mesa:master
- 3c933c1b - man: convert to reStructuredText
-
13206faf...fc479e13 - 41 commits from branch
added 4 commits
-
ffba4d76...9a7afcf1 - 3 commits from branch
mesa:master
- 05b0a955 - man: convert to reStructuredText
-
ffba4d76...9a7afcf1 - 3 commits from branch