Menu
▾
▴
docutils-develop
|
From: Dmitry S. <man...@us...> - 2022-09-05 11:13:24
|
--- ** [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 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. |
|
From: Günter M. <mi...@us...> - 2022-09-05 16:20:33
|
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 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. |
|
From: Dmitry S. <man...@us...> - 2022-09-05 17:42:50
|
> Regarding the second bug: will omitting the fifth argument of `.TH` work with all troff/manpage processors? I asked the original reporter. He answered: > AFAIK, it will work. The behavior may differ, in that groff(1) and > mandoc(1) produce a default text, while others may not produce any text > at all, but it should work. --- ** [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 04:20 PM 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 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. |
|
From: Günter M. <mi...@us...> - 2022-09-07 13:52:39
|
- **labels**: --> manpage writer --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Mon Sep 05, 2022 05:42 PM 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 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. |
|
From: engelbert g. <gr...@us...> - 2022-10-07 08:57:07
|
mqDmitry > AFAIK, it will work. The behavior may differ, in that groff(1) and > mandoc(1) produce a default text, while others may not produce any text > at all, but it should work. I sometime test layout groff and try with mandoc what are the "others" ? --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Wed Sep 07, 2022 12:08 PM 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 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. |
|
From: Dmitry S. <man...@us...> - 2022-10-10 15:14:50
|
Pandoc seems to have its own manpage reader: https://github.com/jgm/pandoc/blob/master/src/Text/Pandoc/Readers/Man.hs. --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Fri Oct 07, 2022 08:57 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 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. |
|
From: engelbert g. <gr...@us...> - 2022-11-02 16:29:44
|
the values in the roff header .TH ~~~ .TH title section date source manual ~~~ are taken from title and the docinfo ~~~ :Date: 2009-06-22 :Version: 0.0.1 :Manual section: 1 :Manual group: text processing ~~~ the Version is put into "source" ... don't know why I did this ? No one ever complained. So there should be a "Manual source" instead. "Manual manual" sounds ... silly doesn't it so it is "Manual group" --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Mon Oct 10, 2022 03:14 PM 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 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. |
|
From: engelbert g. <gr...@us...> - 2022-11-02 17:11:26
|
Revision 9200 Does not output empty "manual" in ``.TH`` or the docinfo[Manual group] --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Wed Nov 02, 2022 04:29 PM 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 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. |
|
From: Adam T. <aa-...@us...> - 2022-11-02 23:30:26
|
@grubert 9 tests are now failing in `test_manpage.py` -- I think the test expectations need to be updated. A --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Wed Nov 02, 2022 05:11 PM 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 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. |
|
From: engelbert g. <gr...@us...> - 2022-11-03 10:01:34
|
sorry , fixed --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Wed Nov 02, 2022 11:30 PM 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 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. |
|
From: Günter M. <mi...@us...> - 2023-04-20 16:47:49
|
Is there still work to do or can we set this issue to "open-fixed" and close it once 0.20 is out? --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Thu Nov 03, 2022 10:01 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 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. |
|
From: engelbert g. <gr...@us...> - 2023-04-20 18:03:36
|
set to open-fixed commandline --date is not usable, but docinfo-date is used noone complained about the value of source or answered so I will leave it there On Thu, 20 Apr 2023 at 18:47, "Günter Milde" <mi...@us...> wrote: > Is there still work to do or can we set this issue to "open-fixed" and > close it once 0.20 is out? > ------------------------------ > > * [bugs:#458] <https://sourceforge.net/p/docutils/bugs/458/> Two issues > regarding manpage writer and .TH* > > *Status:* open > *Labels:* manpage writer > *Created:* Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev > *Last Updated:* Thu Nov 03, 2022 10:01 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 you indicated interest in > https://sourceforge.net/p/docutils/bugs/458/ > > To unsubscribe from further messages, please visit > https://sourceforge.net/auth/subscriptions/ > --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Thu Apr 20, 2023 04:47 PM 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 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. |
|
From: Dmitry S. <man...@us...> - 2023-04-20 19:47:00
|
One of the original bugs in Debian is fixed now. Regarding the other bug, I have [forwarded][1] your response to the original reporter, but he has not replied. So yes, I think you can close this bug. [1]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1016527#22 --- ** [bugs:#458] Two issues regarding manpage writer and .TH** **Status:** open **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Thu Apr 20, 2023 04:47 PM 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 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. |
|
From: engelbert g. <gr...@us...> - 2023-08-04 10:01:06
|
- **status**: open --> closed-fixed --- **[bugs:#458] Two issues regarding manpage writer and .TH** **Status:** closed-fixed **Labels:** manpage writer **Created:** Mon Sep 05, 2022 11:13 AM UTC by Dmitry Shachnev **Last Updated:** Thu Apr 20, 2023 07:47 PM 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 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. |
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X