[docutils:bugs] Re: #477 Generated man page leads to groff warning "TE macro called with TW register undefined"
"Günter Milde" via Docutils-develop <[email protected]>
| Newsgroups | gmane.text.docutils.devel |
|---|---|
| Message-ID | </p/docutils/bugs/477/[email protected]> |
> I would just include it unconditionally, because that would not
> increase the complexity level of docutils codebase.
If noone is ever looking at the generated "troff" source, this is fine.
Otherwise, the complexity may be better "hidden" in the manpage writer.
(For comparison, the "latex" writer uses an elaborated framework for adding
preamble code (loading packages...) only if actually required in the document
in order to keep the "noise level" in the generated *.tex file smaller.)
---
**[bugs:#477] Generated man page leads to groff warning "TE macro called with TW register undefined"**
**Status:** open
**Labels:** manpage writer
**Created:** Sun Nov 12, 2023 06:15 PM UTC by Dmitry Shachnev
**Last Updated:** Tue Nov 14, 2023 09:19 AM UTC
**Owner:** engelbert gruber
In Debian, we have a `lintian` tool which runs various checks on the built packages. Among other things, it makes sure that man pages explicitly require all preprocessors that they need.
I have received a [bug](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1053355) about an error reported by that tool. It looks like that if a document contains a table, `rst2man` generates macros `.TS` and `.TE` which are recognized by [tbl](https://manpages.debian.org/testing/groff-base/tbl.1.en.html) preprocessor, but does not generate a dependency on it.
Here is a minimal reproducing example:
```
$ cat table.rst
.. list-table::
* - Foo
- Bar
$ rst2man table.rst | MANROFFSEQ='' man -l -Z - >/dev/null
an.tmac:<standard input>:43: warning: tbl preprocessor failed, or it or soelim was not run; table(s) likely not rendered (TE macro called with TW register undefined)
```
According to [this email](https://lists.debian.org/debian-devel/2023/08/msg00220.html), to fix this error, `rst2man` should add this line on top of the generated man page:
'\" t
Cc @branden — I think you are interested in all manpage-related issues.
---
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.