tags 600002 fixed-upstream
thanks
On Tue, Oct 12, 2010 at 01:05:35PM -0400, David Prévot wrote:
> According to man(1), *bold text* is meant to be “type[d] exactly as
> shown”. Even if these “conventions apply to the SYNOPSIS section[, it]
> can be used as a guide in other sections”.
>
> So here is a patch against your current Bazaar repository, in order to
> respect this guideline for a few remaining comma (note that you already
> respected it in other parts of manual pages).
Thanks for your attention to detail! I've applied your changes
upstream, with a few general classes of modifications, summarised below:
> -.if !'po4a'hide' .B \-d, \-\-debug
> +.if !'po4a'hide' .B \-d\fP, \fB\-\-debug
I prefer to use the .BR alternating macro for this.
> -.RB \|[\|,.\|.\|.\|]\| ,
> +.RB \|[\|,.\|.\|.\|]\|,
There's no point in using .RB if there's no bold text on the line, so
".RB " can just be removed.
> -.BI \-M\ path ,\ \-\-manpath= path
> +.BI \-M\ path \fR,\fB\ \-\-manpath= path
Strictly speaking, the space shouldn't be bold either :-), so I moved
"\fB" after "\ ".
> Note that I volunteer to gracefully unfuzzy existing translation if you
> consider correcting this issue
It wasn't too onerous to unfuzzy translations (especially not for the
French translation ;-)), so I did so.
> (even if it sounds like nip-ticking issue, I find it interesting that
> man-db applies this kind of advice for manual page writing, as an
> example of good practice).
I don't mind this sort of nitpicking. As you say, man-db should
exemplify good practice for manual pages. (I'd use the mdoc macros if I
could, since I consider them much better practice in general, except
that nobody's made them work nicely with po4a yet!)
Sun Jan 23 17:01:51 GMT 2011 Colin Watson <cjwat...@debian.org>
* man/man1/apropos.man1 (OPTIONS), man/man1/lexgrog.man1 (OPTIONS),
man/man1/man.man1 (OPTIONS), man/man1/manconv.man1 (OPTIONS),
man/man1/manpath.man1 (OPTIONS), man/man1/whatis.man1 (OPTIONS),
man/man1/zsoelim.man1 (OPTIONS), man/man8/accessdb.man8 (OPTIONS),
man/man8/catman.man8 (OPTIONS), man/man8/mandb.man8 (OPTIONS):
Print commas in roman rather than bold. Based on a patch from
David Prévot (Debian bug #600002).
* man/po4a/po/man-db-manpages.pot, man/po4a/po/*.po: Update.
Manually unfuzzy translations.
Thanks,
--
Colin Watson [cjwat...@debian.org]
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
