Re: [docbook-apps] manpage/docbook.xsl generated code broken for nroff

[Ralph Böhme]

Hi,

Am 08.02.2009 um 09:27 schrieb Michael(tm) Smith:

Ralph Bö嚠me <ra...@rsrc.de>, 2009-02-03 22:34 +0100:

Am 03.02.2009 um 22:16 schrieb Bob Stayton:

I don't have a system with plain nroff to test this on, so I'm not clear on

what exactly the problem is or how to fix it.

If you like I could provide you shell access to a Opensolaris 11/08 machine.

That would help me. We have open bugs on this that are assigned to
me, and I am hoping to get some fixes made and checked in
relatively soon, and then do a 1.75.0 release after that.

OK. Please send me your ssh pubkey. Login will be then:
`ssh -p 20024 msm...@85.183.11.35`


gonna be working on this and your TZ.

That host is generally not up 24x7 so if you can please tell me at what times you're

Do you know if the issue is the use of macro

that don't work with plain nroff?

names longer than two characters, or the use of built-in groff instructions

times.

The latter. Running `checknr` (a nroff syntax checker) bails out numerous

I hadn't know about that tool.

too. ;o) And it doesn't know the man macros.

Well, I'm not sure if it will be useful in the end: it bails out on `checknr /usr/share/man/man1/ls.1`

If it is the former, then it could be
easily fixed by renaming defined macros, but if it is the latter,
then it will be harder.


turn it on.

If you manage to get a new 'define.macros' working, you could submit it for inclusion and we could add it to the stylesheet with an option parameter to

SH-xref, SH, SS. See:

I got one working by completly removing the 4 mentioned macros: toupper, <http://netatalk.cvs.sourceforge.net/viewvc/netatalk/netatalk-docs/manual/man.xsl?revision=1.3&view=markup >

So, what I'll probably end up doing is to create a new parameter
named "man.custom.macros.enabled" (or something) and have it set
to on by default. Setting it to off will cause the custom macros
to not be used.

Regards
-Ralph

What was worrying me is if the generated *roff code relies on and uses these macros ? I.e. if I just remove them via a custom XSLT stylesheet or if you provide a parameter to turn it off, will the the generated *roff code use this macros defitions for its output ? Or are these just re-definitions ?

smime.p7s
Description: S/MIME cryptographic signature