[csw-maintainers] [gfile 0004578]: man page not formatted correctly

[Sebastian Kayser]

* Sebastian Kayser <skayser at opencsw.org> wrote:
> * Dagobert Michelsen <dam at opencsw.org> wrote:
> > Am 19.10.2010 um 10:35 schrieb Maciej (Matchek) Blizinski:
> > >Here's a bug that was recently filed against gfile:
> > >
> > >No dia 19 de Outubro de 2010 02:37, Mantis Bug Tracker
> > ><noreply at opencsw.org> escreveu:
> > >>
> > >>The following issue has been SUBMITTED.
> > >>=
> > >>=====================================================================
> > >>https://www.opencsw.org/mantis/view.php?id=4578
> > >(...)
> > >>=
> > >>=====================================================================
> > >>Project:                    gfile
> > >(...)
> > >>=
> > >>=====================================================================
> > >>Summary:                    man page not formatted correctly
> > >>Description:
> > >>man gfile
> > >>shows a scrambled man page
> > >>=
> > >>=====================================================================
> > >
> > >In this case, "scrambled" means lost formatting: the whole manpage is
> > >a monolithic, rectangular block of text.  Here's an example:
> > >
> > >http://paste.pocoo.org/show/277304/
> > >
> > >Is it a known problem with man pages?  Are there any solutions or  
> > >workarounds?
> > 
> > There are macros in there incompatible with the Solaris nroff
> > implementation. It happens from time to time:
> >   https://www.opencsw.org/mantis/view.php?id=1055
> > Try
> >   gnroff -man <manpage>
> > and shipping the page in catX/ for the easiest solution or read and
> > understand how nroff macros are programmed (recommended by James :-)
> > and fix the manpage (IIRC pretty hard...)
> >   http://oreilly.com/openbook/utp/
> > 
> > I vaguely remember we talked about the malformed manpage when I
> > built GNU file initially but hesitated to release it for this
> > reason and you did say that you resolved the issue, but I can't
> > find the discussion ATM... Maybe on IRC?
> 
> There's some more information on possible man page hickups in
> 
>   https://www.opencsw.org/mantis/view.php?id=4280

And - for the sake of completeness - here [1], guess it wouldn't hurt to
put this information on the wiki. I had the same 'unformatted block of
text' with autossh and ship a preformatted man page just like Dago
pointed out [2].

Sebastian

[1]http://lists.opencsw.org/pipermail/maintainers/2010-February/011398.html
[2]https://gar.svn.sf.net/svnroot/gar/csw/mgar/pkg/autossh/trunk/Makefile