[bug-notifications] [groff 0004280]: /opt/csw/share/groff/1.20.1/tmac/doc.tmac:3375: bad character definition

[Mantis Bug Tracker]

A NOTE has been added to this issue. 
====================================================================== 
http://www.opencsw.org/mantis/view.php?id=4280 
====================================================================== 
Reported By:                skayser
Assigned To:                james
====================================================================== 
Project:                    groff
Issue ID:                   4280
Category:                   regular use
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     assigned
====================================================================== 
Date Submitted:             2010-02-16 19:22 CET
Last Modified:              2010-02-16 21:05 CET
====================================================================== 
Summary:                    /opt/csw/share/groff/1.20.1/tmac/doc.tmac:3375: bad
character definition
Description: 
Tested on build10x. When trying to format the autossh man page with gnroff,
gnroff throws a warning:

$ gnroff -man autossh.1 > /dev/null
/opt/csw/share/groff/1.20.1/tmac/doc.tmac:3375: bad character definition

The first part of the formatted man page (everything before the first .Sh)
looks a bit garbled, although I don't know whether that's because of the
above warning.

R] .if 0nl]   .    setup-header
...
UNTITLED                             LOCAL                           
UNTITLED
...
$] .tm Usage: .Sh section_name ...
(http://www.opencsw.org/mantis/view.php?id=0.c])

I have attached the man page so that you can reproduce the warning message
if necessary (and maybe shed some light on the garbled output). WRT to the
warning message there is also a related bug report over at Gentoo:
http://bugs.gentoo.org/263524.
====================================================================== 

---------------------------------------------------------------------- 
 (0007453) james (manager) - 2010-02-16 21:05
 http://www.opencsw.org/mantis/view.php?id=4280#c7453 
---------------------------------------------------------------------- 
The offending command is .Dd.  It's not a standard man page, "man -s 5
man", should start .TH not .Dd. As it's short it would be easier to rewrite
than debug why .Dd is failing. Even with the error it does format but you
might try the following:

sed -e '/.TH/a\
.ll 65n' autossh.1 | groff -te -T ascii -m man | sed -e 's/[^m]*m//g' -e
's/~/ /g' > catman

There are bare escapees in the line which you won't see in this report. 
If you look at the out put you'll see the chars than need to convert the
terminal
control to text - I expect that is a groff flag for this if I looked
carefully!