[docutils:bugs] #458 Two issues regarding manpage writer and .TH

Thank you for forwarding the bug reports.

The "--date" command line argument (and "datestamp" configuration value) "Include a time/datestamp in the document footer." (https://docutils.sourceforge.io/docs/user/config.html#datestamp). They are generic Docutils options that should not be used with the
"manpage" writer.
The "date" value for the `.th` macro fetched from the "Date" field of the [docinfo](https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#bibliographic-fields). See the test input "standalone_rst_manpage.txt" for an example.

Regarding the second bug: will omitting the fifth argument of `.TH` work with all troff/manpage processors?


---

** [bugs:#458] Two issues regarding manpage writer and .TH**

**Status:** open
**Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev
**Last Updated:** Mon Sep 05, 2022 11:13 AM UTC
**Owner:** nobody


Dear docutils developers,

I received two bug reports in Debian regarding the content of .TH macro in man pages:

First bug — https://bugs.debian.org/1016527 — asks that the value of `--date` argument be used for the third argument of `.TH`, instead of putting it on a separate line (Generated on: YYYY-MM-DD).

Second bug — https://bugs.debian.org/1018737 — asks that docutils not set fifth argument of `.TH` to empty string, but omit it completely and rely on the default value.

Please see those bugs for more detailed descriptions (and some discussion, in the first bug).


---

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.