Re: CG chapter 2, first draft

[John Mandereau]

Le mercredi 13 janvier 2010 à 12:20 +0000, Graham Percival a écrit :
> - I'm not positive, but I believe that we put punctuation outside @q{}
> brackets.  If you want to change this policy, we can discuss it, but
> please don't just go changing things inside the hu/ translation.

Indeed; Mark, different languages have different typographic rules, so
unless it doesn't affect the built docs (e.g. replacing ``foo'' ->
@qq{foo}) or you know what you're doing (including knowing the
typographic policy Dénes Harmath and other Hungarian translators chose),
please don't change the typography there.


> - are you certain you can have `quotes' in @node names?

Nothing forbids it in Texinfo manual, but the support of @-commands in
node names is extremely limited.


>   Also, please
> use @q{} in the @section name.
> ... actually, could we just sidestep the whole issue by removing the
> quotes entirely?  "@node Using lily-git" seems easy enough for me.

I agree, but if Mark wants to be picky, he could write 

@*section Using @command{lily-git}

Anyway, using "@command{lily-git}" rather than anything else in the
running text is highly recommended.


> - pushing to `blah blah': again, I'm not wild about the quotes.  Also,
> I'd suggest changing it to "Pushing to origin";

Why not "Pushing to @code{origin}"?

Best,
John

signature.asc
Description: Ceci est une partie de message numériquement signée