Menu
▾
▴
#105 manpage: would like more informative document comments
open-fixed
5
2024-05-16
2024-03-27
No
man documents generated by rst2man have some indication that they were automatically generated but I would prefer to see more information along these lines.
Here's the status quo.
.\" Man page generated from reStructuredText.
.\" body of man page follows
.\" Generated by docutils manpage writer.
.
In my opinion, the comments should be coalesced at the top of the document and include tool versioning information.
More like this:
.\" Man page generated from reStructuredText by rst2man
.\" from docutils 0.21rc1.
... maybe
docutils was command line tools : rst2something
but is also used as a library ... so it might not be rst2man, maybe a sphinx pipeline
but how do i know this
but you are correct , this would be interesting
Ticket moved from /p/docutils/bugs/480/