[docutils:feature-requests] #105 manpage: would like more informative document comments

This is a multi-part message in MIME format.
--===============4546512590996172818==
Content-Type: multipart/related; boundary="===============7022322897453677854=="

This is a multi-part message in MIME format.
--===============7022322897453677854==
Content-Type: multipart/alternative; boundary="===============7080152066157886695=="
MIME-Version: 1.0

--===============7080152066157886695==
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit

- **status**: open-fixed --> closed-fixed
- **Comment**:

The issue is fixed in Docutils 0.22 released 2025-07-29.
Thank you for reporting.




---

**[feature-requests:#105] manpage: would like more informative document comments**

**Status:** closed-fixed
**Group:** Default
**Labels:** manpage writer 
**Created:** Wed Mar 27, 2024 01:07 AM UTC by G. Branden Robinson
**Last Updated:** Thu May 16, 2024 02:39 PM UTC
**Owner:** engelbert gruber


*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/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.
--===============7080152066157886695==
MIME-Version: 1.0
Content-Type: text/html; charset="us-ascii"
Content-Transfer-Encoding: 7bit

<div class="markdown_content"><ul>
<li><strong>status</strong>: open-fixed --&gt; closed-fixed</li>
<li><strong>Comment</strong>:</li>
</ul>
<p>The issue is fixed in Docutils 0.22 released 2025-07-29.<br/>
Thank you for reporting.</p>
<hr/>
<p><strong><span><span>[feature-requests:#105]</span></span> manpage: would like more informative document comments</strong></p>
<p><strong>Status:</strong> closed-fixed<br/>
<strong>Group:</strong> Default<br/>
<strong>Labels:</strong> manpage writer <br/>
<strong>Created:</strong> Wed Mar 27, 2024 01:07 AM UTC by G. Branden Robinson<br/>
<strong>Last Updated:</strong> Thu May 16, 2024 02:39 PM UTC<br/>
<strong>Owner:</strong> engelbert gruber</p>
<p><em>man</em> documents generated by <em>rst2man</em>  have some indication that they were automatically generated but I would prefer to see more information along these lines.</p>
<p>Here's the status quo.</p>
<div class="codehilite"><pre><span></span><code><span class="p">.</span><span class="c">\" Man page generated from reStructuredText.</span>
<span class="p">.</span><span class="c">\" body of man page follows</span>
<span class="p">.</span><span class="c">\" Generated by docutils manpage writer.</span>
<span class="p">.</span>
</code></pre></div>

<p>In my opinion, the comments should be coalesced at the top of the document and include tool versioning information.</p>
<p>More like this:</p>
<div class="codehilite"><pre><span></span><code><span class="p">.</span><span class="c">\" Man page generated from reStructuredText by rst2man</span>
<span class="p">.</span><span class="c">\" from docutils 0.21rc1.</span>
</code></pre></div>

<hr/>
<p>Sent from sourceforge.net because [email protected] is subscribed to <a href="https://sourceforge.net/p/docutils/feature-requests/">https://sourceforge.net/p/docutils/feature-requests/</a></p>
<p>To unsubscribe from further messages, a project admin can change settings at <a href="https://sourceforge.net/p/docutils/admin/feature-requests/options.">https://sourceforge.net/p/docutils/admin/feature-requests/options.</a>  Or, if this is a mailing list, you can unsubscribe from the mailing list.</p></div>
--===============7080152066157886695==--

--===============7022322897453677854==--


--===============4546512590996172818==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline


--===============4546512590996172818==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline