From: François Pinard Date: Tue, 19 Feb 2008 05:11:42 +0000 (-0500) Subject: Manual: English corrections X-Git-Tag: v3.7-beta1~28 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5e76509aa3e4ecdf059bab546678dc677a7e5a8c;p=recode Manual: English corrections --- diff --git a/THANKS b/THANKS index a9422a6..c66cbce 100644 --- a/THANKS +++ b/THANKS @@ -172,6 +172,8 @@ Povl H. Pedersen pope@netguide.dk Primož Peterlin primoz.peterlin@biofiz.mf.uni-lj.si http://sizif.mf.uni-lj.si/~peterlin/ Réjean Payette rejean.payette@rtsq.qc.ca +Reuben Thomas rrt@sc3d.org + http://rrt.sc3d.org/ Ricard Torres torres@upf.es Richard Plasun plasun@iue.tuwien.ac.at Richard Stallman rms@gnu.org diff --git a/doc/ChangeLog b/doc/ChangeLog index a3633a0..ff027a9 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-02-19 François Pinard + + * recode.texi: English corrections. + Reported by Reuben Thomas. + 2008-02-16 François Pinard * mdate-sh, texinfo.tex: Modified by Automake 1.10. diff --git a/doc/recode.info b/doc/recode.info index dc35cdc..3f96c01 100644 --- a/doc/recode.info +++ b/doc/recode.info @@ -29,7 +29,7 @@ translation approved by the Foundation.  Indirect: recode.info-1: 1138 -recode.info-2: 244475 +recode.info-2: 244436  Tag Table: (Indirect) @@ -75,54 +75,54 @@ Node: UTF-16108566 Node: count-characters109716 Node: dump-with-names110389 Node: libiconv112942 -Node: Tabular124526 -Node: ASCII misc146792 -Node: ASCII147158 -Node: ISO 8859147979 -Node: ASCII-BS150278 -Node: flat152117 -Node: IBM and MS152790 -Node: EBCDIC153363 -Node: IBM-PC155477 -Ref: IBM-PC-Footnote-1157599 -Node: Icon-QNX157757 -Node: CDC158184 -Node: Display Code159888 -Ref: Display Code-Footnote-1162172 -Node: CDC-NOS162377 -Node: Bang-Bang164341 -Node: Micros166272 -Node: Apple-Mac166657 -Node: AtariST168713 -Node: Miscellaneous169703 -Node: HTML170440 -Node: LaTeX176468 -Node: Texinfo177244 -Node: Vietnamese178024 -Node: African179004 -Node: Others180360 -Node: Texte181818 -Ref: Texte-Footnote-1186373 -Ref: Texte-Footnote-2186453 -Ref: Texte-Footnote-3186928 -Node: Mule187025 -Ref: Mule-Footnote-1188812 -Node: Surfaces189331 -Ref: Surfaces-Footnote-1192319 -Node: Permutations192425 -Node: End lines193270 -Node: MIME195477 -Node: Dump196668 -Node: Test200862 -Node: Internals203342 -Node: Main flow204581 -Node: New charsets207701 -Node: New surfaces212244 -Node: Design212972 -Ref: Design-Footnote-1222198 -Node: Concept Index222302 -Node: Option Index237045 -Node: Library Index239898 -Node: Charset and Surface Index244475 +Node: Tabular124499 +Node: ASCII misc146765 +Node: ASCII147131 +Node: ISO 8859147951 +Node: ASCII-BS150249 +Node: flat152088 +Node: IBM and MS152761 +Node: EBCDIC153334 +Node: IBM-PC155448 +Ref: IBM-PC-Footnote-1157570 +Node: Icon-QNX157729 +Node: CDC158156 +Node: Display Code159860 +Ref: Display Code-Footnote-1162144 +Node: CDC-NOS162349 +Node: Bang-Bang164313 +Node: Micros166244 +Node: Apple-Mac166629 +Node: AtariST168685 +Node: Miscellaneous169675 +Node: HTML170412 +Node: LaTeX176440 +Node: Texinfo177216 +Node: Vietnamese177996 +Node: African178976 +Node: Others180332 +Node: Texte181790 +Ref: Texte-Footnote-1186345 +Ref: Texte-Footnote-2186425 +Ref: Texte-Footnote-3186900 +Node: Mule186997 +Ref: Mule-Footnote-1188784 +Node: Surfaces189303 +Ref: Surfaces-Footnote-1192291 +Node: Permutations192397 +Node: End lines193242 +Node: MIME195449 +Node: Dump196640 +Node: Test200834 +Node: Internals203314 +Node: Main flow204553 +Node: New charsets207673 +Node: New surfaces212216 +Node: Design212944 +Ref: Design-Footnote-1222159 +Node: Concept Index222263 +Node: Option Index237006 +Node: Library Index239859 +Node: Charset and Surface Index244436  End Tag Table diff --git a/doc/recode.info-1 b/doc/recode.info-1 index 67dc2a2..ec2b333 100644 --- a/doc/recode.info-1 +++ b/doc/recode.info-1 @@ -2907,10 +2907,6 @@ for what is the genuine charset name. `ISO-2022-KR' `csISO2022KR' and `ISO2022KR' are aliases for this charset. - `CHAR' - - `WCHAR_T' -  File: recode.info, Node: Tabular, Next: ASCII misc, Prev: libiconv, Up: Top @@ -3628,7 +3624,7 @@ File: recode.info, Node: ASCII, Next: ISO 8859, Prev: ASCII misc, Up: ASCII =============== This charset is available in `recode' under the name `ASCII'. In fact, -it's true name is `ANSI_X3.4-1968' as per RFC 1345, accepted aliases +its true name is `ANSI_X3.4-1968' as per RFC 1345, accepted aliases being `ANSI_X3.4-1986', `ASCII', `IBM367', `ISO646-US', `ISO_646.irv:1991', `US-ASCII', `cp367', `iso-ir-6' and `us'. The shortest way of specifying it in `recode' is `us'. @@ -3681,8 +3677,8 @@ Lasko , a long while ago: proposed). The ISO Latin Alphabet 1 is available as a charset in `recode' under -the name `Latin-1'. In fact, it's true name is `ISO_8859-1:1987' as -per RFC 1345, accepted aliases being `CP819', `IBM819', `ISO-8859-1', +the name `Latin-1'. In fact, its true name is `ISO_8859-1:1987' as per +RFC 1345, accepted aliases being `CP819', `IBM819', `ISO-8859-1', `ISO_8859-1', `iso-ir-100', `l1' and `Latin-1'. The shortest way of specifying it in `recode' is `l1'. @@ -3881,7 +3877,7 @@ the fuzziness will have to be explained and settle down one day. ---------- Footnotes ---------- (1) On DOS/Windows, stock shells do not know that apostrophes quote -special characters like `|', so one need to use double quotes instead +special characters like `|', so one needs to use double quotes instead of apostrophes.  @@ -5211,17 +5207,16 @@ File: recode.info, Node: Design, Prev: New surfaces, Up: Internals re-encodings are involved, as it happens in true life, synchronising the input buffer back to where it should have stopped, when the output buffer becomes full, is a difficult - problem. Oh, we could make it simpler at the expense of loosing + problem. Oh, we could make it simpler at the expense of losing space or speed: by inserting markers between each input character and counting them at the output end; by processing only one character in a time through the whole sequence; by repeatedly attempting to recode various subsets of the input buffer, binary searching on their length until the output just fits. The - overhead of such solutions looks fully prohibitive to me, and the - gain very minimal. I do not see a real advantage, nowadays, - imposing a fixed length to an output buffer. It makes things so - much simpler and efficient to just let the output buffer size - float a bit. + overhead of such solutions looks prohibitive to me, and the gain + very minimal. I do not see a real advantage, nowadays, imposing a + fixed length to an output buffer. It makes things so much simpler + and efficient to just let the output buffer size float a bit. Of course, if the above problem was solved, the `iconv' library should be easily emulated, given that `recode' has similar @@ -5241,7 +5236,7 @@ File: recode.info, Node: Design, Prev: New surfaces, Up: Internals past experience, I think it is unduly hard to fully implement this scheme. It would be awkward that we do contortions for the sole purpose of implementing exactly its specification, without real, - fairly sounded reasons (other then the fact some people once + properly grounded reasons (other then the fact some people once thought it was worth standardising). It is much better to immediately aim for the refinement we need, without uselessly forcing us into the dubious detour `iconv' represents. @@ -5259,7 +5254,7 @@ File: recode.info, Node: Design, Prev: New surfaces, Up: Internals limitations. In the long run, we should not have to explain to our users that some recodings may not be made available just because they do not fit the simple model we had in mind when we - did it. Instead, we should try to stay opened to the difficulties + did it. Instead, we should try to stay open to the difficulties of real life. There is still a lot of complex needs for Asian people, say, that `recode' does not currently address, while it should. Not only the doors should stay open, but we should force diff --git a/doc/recode.info-2 b/doc/recode.info-2 index e4b1092..2301a37 100644 Binary files a/doc/recode.info-2 and b/doc/recode.info-2 differ diff --git a/doc/recode.texi b/doc/recode.texi index 095102f..ec27563 100644 --- a/doc/recode.texi +++ b/doc/recode.texi @@ -3131,7 +3131,7 @@ implemented in some future version, however. @tindex iso-ir-6 @tindex us This charset is available in @code{recode} under the name @code{ASCII}. -In fact, it's true name is @code{ANSI_X3.4-1968} as per @w{RFC 1345}, +In fact, its true name is @code{ANSI_X3.4-1968} as per @w{RFC 1345}, accepted aliases being @code{ANSI_X3.4-1986}, @code{ASCII}, @code{IBM367}, @code{ISO646-US}, @code{ISO_646.irv:1991}, @code{US-ASCII}, @code{cp367}, @code{iso-ir-6} and @code{us}. The @@ -3187,7 +3187,7 @@ Latin-Hebrew alphabet (right half Hebrew + symbols - proposed). @tindex Latin-1 The ISO Latin Alphabet 1 is available as a charset in @code{recode} under -the name @code{Latin-1}. In fact, it's true name is @code{ISO_8859-1:1987} +the name @code{Latin-1}. In fact, its true name is @code{ISO_8859-1:1987} as per @w{RFC 1345}, accepted aliases being @code{CP819}, @code{IBM819}, @code{ISO-8859-1}, @code{ISO_8859-1}, @code{iso-ir-100}, @code{l1} and @code{Latin-1}. The shortest way of specifying it in @code{recode} @@ -3381,7 +3381,7 @@ recode pc/..l2 < @var{input} > @var{output} @w{RFC 1345} brings into @code{recode} 44 @samp{IBM} charsets or code pages, and also 8 other code pages. You can get a list of these all these by executing:@footnote{On DOS/Windows, stock shells do not know that apostrophes -quote special characters like @kbd{|}, so one need to use double quotes +quote special characters like @kbd{|}, so one needs to use double quotes instead of apostrophes.} @example @@ -4868,11 +4868,11 @@ When long sequences of decodings, stepwise recodings, and re-encodings are involved, as it happens in true life, synchronising the input buffer back to where it should have stopped, when the output buffer becomes full, is a difficult problem. Oh, we could make it simpler at the expense of -loosing space or speed: by inserting markers between each input character +losing space or speed: by inserting markers between each input character and counting them at the output end; by processing only one character in a time through the whole sequence; by repeatedly attempting to recode various subsets of the input buffer, binary searching on their length until the -output just fits. The overhead of such solutions looks fully prohibitive +output just fits. The overhead of such solutions looks prohibitive to me, and the gain very minimal. I do not see a real advantage, nowadays, imposing a fixed length to an output buffer. It makes things so much simpler and efficient to just let the output buffer size float a bit. @@ -4893,7 +4893,7 @@ always has to wrap @code{iconv} into something more refined, extending it for real cases. From past experience, I think it is unduly hard to fully implement this scheme. It would be awkward that we do contortions for the sole purpose of implementing exactly its specification, without real, -fairly sounded reasons (other then the fact some people once thought it +properly grounded reasons (other then the fact some people once thought it was worth standardising). It is much better to immediately aim for the refinement we need, without uselessly forcing us into the dubious detour @code{iconv} represents. @@ -4910,7 +4910,7 @@ the @code{recode} library, whatever its form, would not like to have such arbitrary limitations. In the long run, we should not have to explain to our users that some recodings may not be made available just because they do not fit the simple model we had in mind when we did it. Instead, -we should try to stay opened to the difficulties of real life. There is +we should try to stay open to the difficulties of real life. There is still a lot of complex needs for Asian people, say, that @code{recode} does not currently address, while it should. Not only the doors should stay open, but we should force them wider! diff --git a/doc/stamp-vti b/doc/stamp-vti index 7fb7db0..9d4fa9d 100644 --- a/doc/stamp-vti +++ b/doc/stamp-vti @@ -1,4 +1,4 @@ -@set UPDATED 18 February 2008 +@set UPDATED 19 February 2008 @set UPDATED-MONTH February 2008 @set EDITION 3.6 @set VERSION 3.6 diff --git a/doc/version.texi b/doc/version.texi index 7fb7db0..9d4fa9d 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -1,4 +1,4 @@ -@set UPDATED 18 February 2008 +@set UPDATED 19 February 2008 @set UPDATED-MONTH February 2008 @set EDITION 3.6 @set VERSION 3.6