[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>
- Docs check-translation, John Mandereau, 2007/01/03
- Re: Docs check-translation, Graham Percival, 2007/01/03
- Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], John Mandereau, 2007/01/04
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], John Mandereau, 2007/01/07
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], Graham Percival, 2007/01/07
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation],
John Mandereau <=
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], Jean-Charles, 2007/01/08
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], Graham Percival, 2007/01/08
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], Han-Wen Nienhuys, 2007/01/08
- Re: Backporting doc changes to stable/2.10 [was: Re: Docs check-translation], John Mandereau, 2007/01/09