[Docutils-develop] [docutils:bugs] #480 manpage: would like more informative document comments

[engelbert g. <gr...@us...>]

... 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 doc...@li... 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.