[bug-notifications] [pkgconfig 0001747]: manual page fails to pass through nroff(1)

[Mantis Bug Tracker]

The following issue has been REOPENED. 
====================================================================== 
http://opencsw.org/mantis/view.php?id=1747 
====================================================================== 
Reported By:                jeff
Assigned To:                dam
====================================================================== 
Project:                    pkgconfig
Issue ID:                   1747
Category:                   regular use
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     feedback
====================================================================== 
Date Submitted:             2006-08-16 22:24 CEST
Last Modified:              2009-04-19 21:50 CEST
====================================================================== 
Summary:                    manual page fails to pass through nroff(1)
Description: 
When you attempt to read the pkg-get(1) manual page using Sun\'s standard
nroff(1), there is no output.  This is due to the .DW and .DE macros at the
top of the source file.  if you eliminate these lines, the manual page will
then format properly.

Apparently, these custom macros are an attempt to work around some nutty
problem in groff(1).
====================================================================== 

---------------------------------------------------------------------- 
 (0003740) james (reporter) - 2006-08-17 04:38
 http://opencsw.org/mantis/view.php?id=1747#c3740 
---------------------------------------------------------------------- 
A workaround is to pre-format the page with groff and package in man/cat -
but if editing the page works do that.

See /opt/csw/man/cat1/groff.1.  Trust the groff writers to not understand
nroff :-)

Some people periodically purge (rm) man/cat or run catman -c so be
careful, chmod -w is a hint.  Machines are now so fast, have been for
years, I never cache in cat. 

---------------------------------------------------------------------- 
 (0003755) komadori (reporter) - 2006-08-19 22:22
 http://opencsw.org/mantis/view.php?id=1747#c3755 
---------------------------------------------------------------------- 
I have submitted a new package with the offending macros removed. 

---------------------------------------------------------------------- 
 (0005984) dam (manager) - 2009-04-19 21:50
 http://opencsw.org/mantis/view.php?id=1747#c5984 
---------------------------------------------------------------------- 
I wasn't aware of this issue when I released an updated package and
apparently the fix was not pushed upstream. 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2009-04-19 21:50 dam            Assigned To              komadori => dam     
2009-04-19 21:50 dam            Note Added: 0005984                          
2009-04-19 21:50 dam            Status                   closed => feedback  
2009-04-19 21:50 dam            Resolution               fixed => reopened   
======================================================================