[docutils:bugs] #480 manpage: would like more informative document comments
engelbert gruber via Docutils-develop <[email protected]>
| Newsgroups | gmane.text.docutils.devel |
|---|---|
| Message-ID | </p/docutils/bugs/480/de1ff2dbc55c066bad7f67c0196b0760f747d58d.bugs@docutils.p.sourceforge.net> |
... 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 --- **[bugs:#480] manpage: would like more informative document comments** **Status:** open **Created:** Wed Mar 27, 2024 01:07 AM UTC by G. Branden Robinson **Last Updated:** Wed Mar 27, 2024 01:07 AM UTC **Owner:** nobody *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. ~~~ --- Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/bugs/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.