[bug-notifications] [groff 0002200]: pdfroff manual page will not format

[Mantis Bug Tracker]

The following issue has been CLOSED 
====================================================================== 
http://www.opencsw.org/bugtrack/view.php?id=2200 
====================================================================== 
Reported By:                jeff
Assigned To:                james
====================================================================== 
Project:                    groff
Issue ID:                   2200
Category:                   regular use
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     closed
Resolution:                 open
Fixed in Version:           
====================================================================== 
Date Submitted:             2007-04-07 17:52 CEST
Last Modified:              2009-03-19 21:40 CET
====================================================================== 
Summary:                    pdfroff manual page will not format
Description: 
Attempts to nroff the /opt/csw/man /man1/pdfroff.1 file produce the
following output:

------------------------------------------------------------
User Commands                                   PDFROFF(1)

NAME
     pdfroff - create PDF documents using groff \\$*

SYNOPSIS

Groff Version 1.19.2Last change: 18 May 2005
------------------------------------------------------------

That\'s it!  I haven\'t looked closely, but the macros in this
file must be interfering with the man macros.  Also notice that the last
line in the output runs together.  This is probably another artifact of the
bad internal macros.
--
Jeff
====================================================================== 

---------------------------------------------------------------------- 
 (0004484) james (manager) - 2007-04-08 04:46
 http://www.opencsw.org/bugtrack/view.php?id=2200#c4484 
---------------------------------------------------------------------- 
Trust the the groff writer to not be able to write troff macros.  The
problem is the man pages are designed for groff and not troff as is used by
the man command.  My workaround for the pacakge is to pre-format the pages
in man/cat, this page slipped through unformatted.

To format your own copy:

# sed -e \'/.TH/a\\
.ll 65n\' /opt/csw/share/man/man1/pdfroff.1 | \\
groff -T ascii -m man | \\
sed -e \'s/[^m]*m//g\' -e \'s/~/ /g\' >
/opt/csw/share/man/cat1/pdfroff.1

The first escaped line break is important to sed, the other are just
normal line wraps.


Don\'t get too excited as pdfroff produces double copy of the output.  I
recommend using GS\'s ps2pdf, which is what the script does anyway:

$ groff -m man /opt/csw/share/man/man1/pdfroff.1 | \\
ps2pdf /dev/fd/0 > pdfroff.pdf 

---------------------------------------------------------------------- 
 (0004485) james (manager) - 2007-04-08 05:08
 http://www.opencsw.org/bugtrack/view.php?id=2200#c4485 
---------------------------------------------------------------------- 
Finish the job with:

# installf -R / CSWgroff /opt/csw/share/man/cat1/pdfroff.1

then the formatted file will belong to CSWgroff and be removed on update.

edited on: 04-08 05:08 

---------------------------------------------------------------------- 
 (0005679) james (manager) - 2009-03-19 21:40
 http://www.opencsw.org/bugtrack/view.php?id=2200#c5679 
---------------------------------------------------------------------- 
Closing, new package released with preformatted pdfroff man page in man/cat
which is best I can do simply. 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2009-03-19 21:40 james          Note Added: 0005679                          
2009-03-19 21:40 james          Status                   assigned => closed  
======================================================================