Package: groff
Version: 1.18.1.1-12
Severity: normal
When packaging fdm¹, lintian told me about a warning in one of the
program's manpages:
[snip]
fdm: manpage-has-errors-from-man usr/share/man/man5/fdm.conf.5.gz Unknown
keyword `-ragged' in .Bd macro (#590)
[snap]
I can reproduce this using both 'man' and 'groff':
[snip]
% man -l fdm-1.1/fdm.conf.5 > /dev/null
mdoc warning: Unknown keyword `-ragged' in .Bd macro (#590)
% groff -mdoc fdm-1.1/fdm.conf.5 > /dev/null
mdoc warning: Unknown keyword `-ragged' in .Bd macro (#590)
[snap]
Here is the offending part of fdm.conf.5²:
[snip]
Once defined, a macro may be used in any place a string or number is expected.
Macros may be embedded in strings by surrounding their name (after the $ or %)
with {}s, like so:
.Bd -ragged -offset indent
"abc ${mymacro} %{anothermacro} def"
.Ed
[snap]
I don't see why this is throwing a warning, as '-ragged' for '.Bd' is
documented in groff_mdoc(7):
[snip]
.Bd Begin display. The '.Bd' display must be ended with the '.Ed'
macro. It has the following syntax:
.Bd {-literal | -filled | -unfilled | -ragged | -centered}
[-offset <string>] [-file <file name>] [-compact]
-ragged Fill, but do not adjust the right margin (only
left-justify).
[snap]
Any ideas/clues/fixes?
Regards, Frank
¹ <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=419048>
² <http://ft.bewatermyfriend.org/tmp/fdm.conf.5>
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (990, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.19.2-suspend2+ipw2200 (PREEMPT)
Locale: LANG=C, [EMAIL PROTECTED] (charmap=ISO-8859-15)
Shell: /bin/sh linked to /bin/dash
Versions of packages groff depends on:
ii groff-base 1.18.1.1-12 GNU troff text-formatting system (
ii libc6 2.3.6.ds1-13 GNU C Library: Shared libraries
ii libgcc1 1:4.1.1-21 GCC support library
ii libice6 1:1.0.3-2 X11 Inter-Client Exchange library
ii libsm6 1:1.0.1-3 X11 Session Management library
ii libstdc++6 4.1.1-21 The GNU Standard C++ Library v3
ii libx11-6 2:1.0.3-7 X11 client-side library
ii libxaw7 1:1.0.2-4 X11 Athena Widget library
ii libxext6 1:1.0.1-2 X11 miscellaneous extension librar
ii libxmu6 1:1.0.2-2 X11 miscellaneous utility library
ii libxpm4 1:3.5.5-2 X11 pixmap library
ii libxt6 1:1.0.2-2 X11 toolkit intrinsics library
Versions of packages groff recommends:
ii gs 8.54.dfsg.1-5 Transitional package
ii gs-gpl [gs] 8.54.dfsg.1-5 The GPL Ghostscript PostScript int
ii imagemagick 7:6.2.4.5.dfsg1-0.14 Image manipulation programs
ii libpaper1 1.1.21 Library for handling paper charact
pn netpbm <none> (no description available)
pn psutils <none> (no description available)
-- no debconf information
