[csw-maintainers] /testing spamassassin, bind, dhcp, dnstop

[Sebastian Kayser]

Peter Bonivart wrote on 15.02.2010 22:03:
> On Mon, Feb 15, 2010 at 9:55 PM, Ihsan Dogan <ihsan at opencsw.org> wrote:
>> Am 26.01.10 22:27, schrieb Peter Bonivart:
>>
>>> - dnstop 20090128, a top-like utility for DNS servers.
>> I've tested it quickly on x86. Works fine, but the man page seems to broken.
> 
> Yes, the formatting is broken, it's just copied from the source.
> Anyone has any ideas how to get it into a proper man page?

AFAIR Solaris nroff can't handle some of the stuff that the ?roff on
Linux can handle. What I used to do is to file a request with upstream
to make the man page work on Solaris, format the man page on Linux, put
it into $(docdir)/$(GARNAME) and provide a stub man page which pointed
to this pre-formatted text file (see autossh [1] for an example). Ugly,
but it did the job for a workaround.

Dago recently pointed out that (besides fixing the man page) there is a
simpler approach. Pre-formatted man pages can supposedly be put into
/opt/csw/share/cat<section> and will simply be cat-ed for display (in
favor of man pages coming from /opt/csw/share/man<section> directories).

Sebastian

P.S.: If such non-formatable (on Solaris) man pages can be identified by
some unique characteristics this might be a good thing to implement as a
check for checkpkg.

[1]https://gar.svn.sf.net/svnroot/gar/csw/mgar/pkg/autossh/trunk/Makefile