Menu
▾
▴
[ docbook-Bugs-2013441 ] man pages broken on Solaris
|
From: SourceForge.net <no...@so...> - 2009-02-07 08:07:45
|
Bugs item #2013441, was opened at 2008-07-08 21:28 Message generated for change (Comment added) made by xmldoc You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=373747&aid=2013441&group_id=21935 Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: XSL Group: output: manpages Status: Open Resolution: None Priority: 7 Private: No Submitted By: Oliver Kiddle (opk) Assigned to: Michael(tm) Smith (xmldoc) Summary: man pages broken on Solaris Initial Comment: Between 1.73.2 and 1.74.0, the manpages have ceased to work on Solaris or even on a slightly old Linux installation. I'm using Solaris 10 and SuSE ES9 which has groff 1.17.2. On Solaris, I get only the header and footer lines. Removing the toupper and SH-xref macros basically fixes it but I still get FC and F[] surrounding some items that were marked <literal> or <email> in the Docbook source. The FC/F[] problem also occurs with the old Linux machine. On a recent Debian Linux machine (groff 1.18.1), the man page looks fine. No formatting is applied to the <literal> elements and the e-mail address no longer has angle brackets around it as with 1.73.2. ---------------------------------------------------------------------- >Comment By: Michael(tm) Smith (xmldoc) Date: 2009-02-07 17:07 Message: I really do need to get this fixed. I'll try to get the changes made next week, and get them checked in. I think I will need to add a new parameter named "man.custom.macros.enabled" (or something), with it set to True by default. Setting it to False would cause the custom macros to not be included in output, and normal requests/escapes to be used in the output (instead of the custom macros). I would really like to have access to a Solaris machine that I can test on. I think Sourceforge used to provide shell access to a number of different build machines, with a variety of OSes, including a Solaris machine. Not sure if they still do. I'll check. Anyway, once I do get this fixed, we'll do a new release, 1.75.0. ---------------------------------------------------------------------- Comment By: Mauritz Jeanson (mzjn) Date: 2009-02-07 03:54 Message: My understanding is that "classic" nroff, not groff, is used on Solaris. The following might help in resolving the bug. According to Troff User's Manual, troff/nroff macro names may be one or two characters long. groff does not have this restriction. This could explain the trouble with the toupper and SH-xref macros. In the define.macros template, SH and SS are redefined using the .de1 request. This request appears to be available in groff only. See also this patch: https://sourceforge.net/tracker/index.php?func=detail&aid=2573075&group_id=21935&atid=373749 ---------------------------------------------------------------------- Comment By: Michael(tm) Smith (xmldoc) Date: 2008-07-08 21:33 Message: Logged In: YES user_id=118135 Originator: NO > Between 1.73.2 and 1.74.0, the manpages have ceased to work on Solaris or > even on a slightly old Linux installation. I'm using Solaris 10 and SuSE > ES9 which has groff 1.17.2. Well, that's not good... I will try to get this fixed as soon as possible. But for now, the workaround is to just use 1.73.2 --Mike ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=373747&aid=2013441&group_id=21935 |