[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translat

From: John Mandereau
Subject: Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation]
Date: Mon, 08 Jan 2007 01:45:40 +0100

Graham Percival wrote: 
> Thanks, these look good.  However, there are some problems with your 
> other updates:
> 1.  Wrapping paragraphs in texinfo is pointless, because texinfo ignores 
> whitespace.  Lines that are too long are annoying for people using 
> 80-character terminals, but other than that, there's no point in 
> spending time fussing over linewidths.

Well, I haven't spent much time on this: with Emacs, it's only a matter
of doing M-Q on odd-looking paragraphs.  Moreover, it's easier to read
short and well formatted lines, for both Info readers and docs editors.

> 2.  Don't use colons: to introduce examples.  See the README.txt in 
> Documentation/user/

You are right.  I wonder if the same rules should apply to French
translations; in French, I feel well introducing many examples with a
colon.  I should check good French style somewhere; Jean-Charles, what
do you know about this?

John Mandereau <address@hidden>

reply via email to

[Prev in Thread] Current Thread [Next in Thread]