On Sun, Jul 30, 2006 at 03:09:33PM -0700, Robin Lee Powell wrote:
> The man macros do not include .SH Name at the top, which means that
> we get errors like:
> mandb: warning: /usr/man/man3/mooix-long.scm.3: whatis parse for
> mooix-long.scm(3) failed
Good point, but I never intended stx2any to include all man page
specific form automatically. It would probably be nice to have .SH NAME
in the template, but that would seriously cripple the usability of the
man output for anything _else_ than man pages.
I admit, though, that maybe it should be made clearer in the
documentation that you have to put "! NAME" and a properly formatted
name line in the source. At the moment, all the documentation says (on
the man page of stx2any) is:
man produces man macro output. This output is usable as a man
page directly (of course, you should adhere to the ordi-
nary man page conventions), or can be fed to troff / groff
for formatting to e.g. postscript.
Here "ordinary man page conventions" refers to normal man section
headers, providing metadata such as the man section number and so on. I
can clarify this in the next release. For an example of writing man
pages with stx2any, please see the source for its own man page at
/usr/share/doc/stx2any/stx2any.txt.gz.
Panu
--
personal contact: [EMAIL PROTECTED], +35841 5323835
technical contact: [EMAIL PROTECTED], http://www.iki.fi/atehwa/
PGP fingerprint: 0EA5 9D33 6590 FFD4 921C 5A5F BE85 08F1 3169 70EC
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
