On Mon, Nov 19, 2007 at 10:23:36AM +0600, Ivan Shmakov wrote:
Colin Watson <cjwatson@debian.org> writes:> (Unfortunately, you might have to parse groff's warning text in order > to ignore particular cases.) I'm not familiar with Groff at all... Does it allow later `.de' to override the former?..
Yes, it does. This behavior is consistent with that of strings, which are treated identically internally. I tested it as well. :-) It doesn't warn with -ww.
Looks more like a comment from the generator:305 Sections, no Front\-Cover Texts and no Back\-Cover Texts. A copy 306 of the license can be found under 307 \fB/usr/share/common\-licenses/FDL\fP. 308 ...\" created by instant / docbook\-to\-man, Wed 13 Dec 2000, 17:30
The generator is broken. This should be .\" Otherwise, it looks like a comment directly after a macro called "..".
> .UR used to be what you used to mark up URLs; man(7) recommended it > until not that long ago. What to use instead?
man(7) recommends .URL instead. This is a groff-only feature; man(7) has some substitute code that works on all processors, yet still uses the groff features on groff.
>> W: dirmngr: manpage-has-errors-from-man usr/share/man/man1/dirmngr.1.gz 245: warning: `#'' not defined244 Lines starting with a 245 '#'246 are comments.
' is the groff no-break control character (compare with . which does not suppress breaks), and so you need to put \& at the beginning of this line: \&'#'
>> W: dirmngr: manpage-has-errors-from-man usr/share/man/man1/dirmngr-client.1.gz 86: warning: `-vv'' not defined85 verbose commands to \fBdirmngr\fR, such as 86 '-vv'87 .
Should be \&'-vv'
1490 .TP 5 1491 .B const char * \fIfmt 1492 is the format of the \fBprintf\fP-like message to write. 1493 .TP 5 1494 ... 1495 are the variables to apply to the \fIfmt\fP format. More like an Attempt to render ellipsis.
Should be \&...Basically, any time you have a dot or a single-quote at the beginning of a line, it needs \& in front of it, unless you're using it as a control character. Putting \& in the middle of a line before one of those characters doesn't hurt either. The only time this isn't the case is if you've changed one of the control characters, which almost never happens (and you would know if you did).
-- brian m. carlson / brian with sandals: Houston, Texas, US +1 713 440 7475 | http://crustytoothpaste.ath.cx/~bmc | My opinion only a typesetting engine: http://crustytoothpaste.ath.cx/~bmc/code/thwack OpenPGP: RSA v4 4096b 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
Attachment:
signature.asc
Description: Digital signature