Manual: omitted charsets. THANKS adjusted
authorFrançois Pinard <pinard@iro.umontreal.ca>
Fri, 14 Mar 2008 22:48:13 +0000 (18:48 -0400)
committerFrançois Pinard <pinard@iro.umontreal.ca>
Fri, 14 Mar 2008 22:48:13 +0000 (18:48 -0400)
THANKS
doc/ChangeLog
doc/recode.info
doc/recode.texi
src/ChangeLog

diff --git a/THANKS b/THANKS
index 55aa2a85e9a96d5222262882ffe20d56365150c3..cfbf0e0864e156646f9ea77d76ea7d2a72ed9cd8 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -17,6 +17,7 @@ Alexandre Oliva               oliva@dcc.unicamp.br
                        http://www.dcc.unicamp.br/~oliva
 Andreas Dietrich       quasi@mathematik.uni-marburg.de
 Andreas Frick          afr@aifb.uni-karlsruhe.de
+Andreas Kunert         akunert@main-rheiner.de
 Andreas Mueller                afm@othello.ch
                        http://www.othello.ch
 Andreas Schwab         schwab@suse.de
@@ -185,7 +186,9 @@ Noèl Köthe                noel@debian.org
 Olivier Lecarme                Olivier.Lecarme@unice.fr
 Olivier Tharan         olive@laria.u-picardie.fr
                        http://www.laria.u-picardie.fr/~olive/
+Pascal Gourdel         gourdel@univ-paris1.fr
 Patrick Andries                pandries@iti.qc.ca
+Pavel Forsite          forsite@spamtest.ru
 Pawel Krawczyk         kravietz@ceti.pl
                        http://ceti.pl/~kravietz/
 Per Andersson          perand@stacken.kth.se
index cac0c65ad10464875ea8be29cd6d71e8072c5149..77c13132f16fa5e4987cc8b917b2695e94877b68 100644 (file)
@@ -1,3 +1,8 @@
+2008-03-14  François Pinard  <pinard@iro.umontreal.ca>
+
+       * recode.texi: More about omitted charsets.
+       Reported by Pascal Gourdel.
+
 2008-03-13  François Pinard  <pinard@iro.umontreal.ca>
 
        * recode.texi: Clarify include files and configuration matters.
index 1bf881caea085ca293e90cfd76fd470878d3979d..ebda37229cd2a359bfce738cc47b4791984725b6 100644 (file)
@@ -182,9 +182,13 @@ resort to many other email conversions, yet more rarely than the
 frequent cases above.
 
      It _seems_ like this should be doable using Recode.  However, when
-     I try something like `grecode mac macfile.txt' I get nothing
+     I try something like `recode mac macfile.txt' I get nothing
      out--no error, no output, nothing.
 
+   *Note_* For the following discussion to be true, you should have
+something like `export LANG=fr_FR.ISO-8859-1' in your environment, the
+important bit here being the specification of an preferred charset.
+
    Presuming you are using some recent version of Recode, the command:
 
      recode mac macfile.txt
@@ -652,10 +656,13 @@ BEFORE charset.(2)
 
    When a charset name is omitted or left empty, the value of the
 `DEFAULT_CHARSET' variable in the environment is used instead.  If this
-variable is not defined, the Recode library uses the current locale's
-encoding.  On POSIX compliant systems, this depends on the first
-non-empty value among the environment variables LC_ALL, LC_CTYPE, LANG,
-and can be determined through the command `locale charmap'.
+variable is not defined, the Recode library (from version 3.6 and up)
+uses the current locale's encoding.  On POSIX compliant systems, this
+depends on the first non-empty value among the environment variables
+LC_ALL, LC_CTYPE, LANG, and can be determined through the command
+`locale charmap'.  If the current locale's encoding may not be
+resolved, then Recode presumes `ASCII' (or, for Recode 3.6 only:
+`CHAR').
 
    If the charset name is omitted but followed by surfaces, the surfaces
 then qualify the usual or default charset.  For example, the request
@@ -5457,7 +5464,8 @@ by Recode, and their aliases.
 * Apple-Mac:                             Apple-Mac.           (line   6)
 * arabic:                                Tabular.             (line 464)
 * arabic7:                               Tabular.             (line  74)
-* ASCII:                                 Tabular.             (line  69)
+* ASCII <1>:                             Tabular.             (line  69)
+* ASCII:                                 Requests.            (line 104)
 * ASCII, an alias for the ANSI_X3.4-1968 charset: ASCII.      (line   6)
 * ASCII-BS, and its aliases:             ASCII-BS.            (line   6)
 * ASMO-708:                              Tabular.             (line 464)
@@ -5475,6 +5483,7 @@ by Recode, and their aliases.
 * BS_viewdata, aliases and source:       Tabular.             (line  82)
 * ca:                                    Tabular.             (line 118)
 * CDC-NOS, and its aliases:              CDC-NOS.             (line   6)
+* CHAR:                                  Requests.            (line 104)
 * cl:                                    End lines.           (line  37)
 * cn:                                    Tabular.             (line 211)
 * combined-UCS-2:                        UCS-2.               (line  34)
@@ -6114,95 +6123,95 @@ by Recode, and their aliases.
 Tag Table:
 Node: Top\7f1148
 Node: Tutorial\7f5608
-Node: Introduction\7f9836
-Node: Charset overview\7f14070
-Node: Surface overview\7f15875
-Node: Contributing\7f17343
-Ref: Contributing-Footnote-1\7f19577
-Node: Invoking recode\7f19711
-Node: Synopsis\7f20666
-Ref: Synopsis-Footnote-1\7f23106
-Node: Requests\7f23403
-Ref: Requests-Footnote-1\7f29293
-Ref: Requests-Footnote-2\7f29360
-Ref: Requests-Footnote-3\7f29538
-Node: Listings\7f29997
-Ref: Listings-Footnote-1\7f41280
-Node: Recoding\7f41603
-Node: Reversibility\7f44424
-Ref: Reversibility-Footnote-1\7f52879
-Node: Sequencing\7f53016
-Node: Mixed\7f55460
-Node: Emacs\7f58828
-Node: Debugging\7f59862
-Node: Library\7f64132
-Node: Outer level\7f67092
-Node: Request level\7f72441
-Node: Task level\7f83433
-Node: Charset level\7f94063
-Node: Errors\7f94905
-Ref: Errors-Footnote-1\7f99751
-Ref: Errors-Footnote-2\7f99865
-Node: Universal\7f100226
-Ref: Universal-Footnote-1\7f103338
-Ref: Universal-Footnote-2\7f103404
-Node: UCS-2\7f103617
-Node: UCS-4\7f106143
-Node: UTF-7\7f106683
-Node: UTF-8\7f107278
-Node: UTF-16\7f111583
-Node: count-characters\7f112731
-Node: dump-with-names\7f113402
-Node: iconv\7f115951
-Node: Tabular\7f119382
-Node: ASCII misc\7f141595
-Node: ASCII\7f141961
-Node: ISO 8859\7f142777
-Node: ASCII-BS\7f145071
-Node: flat\7f146908
-Node: IBM and MS\7f147579
-Node: EBCDIC\7f148123
-Node: IBM-PC\7f150219
-Ref: IBM-PC-Footnote-1\7f152333
-Node: Icon-QNX\7f152492
-Node: CDC\7f152917
-Node: Display Code\7f154598
-Ref: Display Code-Footnote-1\7f156879
-Node: CDC-NOS\7f157084
-Node: Bang-Bang\7f159046
-Node: Micros\7f160975
-Node: Apple-Mac\7f161358
-Node: AtariST\7f163392
-Node: Miscellaneous\7f164378
-Node: HTML\7f165297
-Node: LaTeX\7f171286
-Node: Texinfo\7f172060
-Node: Vietnamese\7f172832
-Node: African\7f173808
-Node: Others\7f175158
-Node: Java\7f176611
-Node: Texte\7f177278
-Ref: Texte-Footnote-1\7f181826
-Ref: Texte-Footnote-2\7f181906
-Ref: Texte-Footnote-3\7f182381
-Node: Mule\7f182478
-Ref: Mule-Footnote-1\7f184259
-Node: Surfaces\7f184778
-Ref: Surfaces-Footnote-1\7f188197
-Node: Permutations\7f188301
-Node: End lines\7f189142
-Node: MIME\7f191343
-Node: Dump\7f192530
-Node: Test\7f196700
-Node: Internals\7f199178
-Node: Main flow\7f200406
-Node: New charsets\7f203509
-Node: New surfaces\7f208047
-Node: Design\7f208773
-Ref: Design-Footnote-1\7f217939
-Node: Concept Index\7f218043
-Node: Option Index\7f233516
-Node: Library Index\7f236369
-Node: Charset and Surface Index\7f240944
+Node: Introduction\7f10043
+Node: Charset overview\7f14277
+Node: Surface overview\7f16082
+Node: Contributing\7f17550
+Ref: Contributing-Footnote-1\7f19784
+Node: Invoking recode\7f19918
+Node: Synopsis\7f20873
+Ref: Synopsis-Footnote-1\7f23313
+Node: Requests\7f23610
+Ref: Requests-Footnote-1\7f29645
+Ref: Requests-Footnote-2\7f29712
+Ref: Requests-Footnote-3\7f29890
+Node: Listings\7f30349
+Ref: Listings-Footnote-1\7f41632
+Node: Recoding\7f41955
+Node: Reversibility\7f44776
+Ref: Reversibility-Footnote-1\7f53231
+Node: Sequencing\7f53368
+Node: Mixed\7f55812
+Node: Emacs\7f59180
+Node: Debugging\7f60214
+Node: Library\7f64484
+Node: Outer level\7f67444
+Node: Request level\7f72793
+Node: Task level\7f83785
+Node: Charset level\7f94415
+Node: Errors\7f95257
+Ref: Errors-Footnote-1\7f100103
+Ref: Errors-Footnote-2\7f100217
+Node: Universal\7f100578
+Ref: Universal-Footnote-1\7f103690
+Ref: Universal-Footnote-2\7f103756
+Node: UCS-2\7f103969
+Node: UCS-4\7f106495
+Node: UTF-7\7f107035
+Node: UTF-8\7f107630
+Node: UTF-16\7f111935
+Node: count-characters\7f113083
+Node: dump-with-names\7f113754
+Node: iconv\7f116303
+Node: Tabular\7f119734
+Node: ASCII misc\7f141947
+Node: ASCII\7f142313
+Node: ISO 8859\7f143129
+Node: ASCII-BS\7f145423
+Node: flat\7f147260
+Node: IBM and MS\7f147931
+Node: EBCDIC\7f148475
+Node: IBM-PC\7f150571
+Ref: IBM-PC-Footnote-1\7f152685
+Node: Icon-QNX\7f152844
+Node: CDC\7f153269
+Node: Display Code\7f154950
+Ref: Display Code-Footnote-1\7f157231
+Node: CDC-NOS\7f157436
+Node: Bang-Bang\7f159398
+Node: Micros\7f161327
+Node: Apple-Mac\7f161710
+Node: AtariST\7f163744
+Node: Miscellaneous\7f164730
+Node: HTML\7f165649
+Node: LaTeX\7f171638
+Node: Texinfo\7f172412
+Node: Vietnamese\7f173184
+Node: African\7f174160
+Node: Others\7f175510
+Node: Java\7f176963
+Node: Texte\7f177630
+Ref: Texte-Footnote-1\7f182178
+Ref: Texte-Footnote-2\7f182258
+Ref: Texte-Footnote-3\7f182733
+Node: Mule\7f182830
+Ref: Mule-Footnote-1\7f184611
+Node: Surfaces\7f185130
+Ref: Surfaces-Footnote-1\7f188549
+Node: Permutations\7f188653
+Node: End lines\7f189494
+Node: MIME\7f191695
+Node: Dump\7f192882
+Node: Test\7f197052
+Node: Internals\7f199530
+Node: Main flow\7f200758
+Node: New charsets\7f203861
+Node: New surfaces\7f208399
+Node: Design\7f209125
+Ref: Design-Footnote-1\7f218291
+Node: Concept Index\7f218395
+Node: Option Index\7f233868
+Node: Library Index\7f236721
+Node: Charset and Surface Index\7f241296
 \1f
 End Tag Table
index c410293aacac421be4b58846b99959e032c3a308..48ce6151fb0edca86f19ba8c44903cdefa19acd6 100644 (file)
@@ -231,10 +231,14 @@ other email conversions, yet more rarely than the frequent cases above.
 
 @quotation
 It @emph{seems} like this should be doable using Recode.  However,
-when I try something like @samp{grecode mac macfile.txt} I get nothing
+when I try something like @samp{recode mac macfile.txt} I get nothing
 out---no error, no output, nothing.
 @end quotation
 
+@strong{Note:} For the following discussion to be true, you should have
+something like @samp{export LANG=fr_FR.ISO-8859-1} in your environment,
+the important bit here being the specification of an preferred charset.
+
 Presuming you are using some recent version of Recode, the command:
 
 @example
@@ -758,12 +762,17 @@ not very useful, as the recoding reduces to a mere copy in that case.}
 @cindex default charset
 @cindex charset, default
 @vindex DEFAULT_CHARSET
+@tindex ASCII
+@tindex CHAR
 When a charset name is omitted or left empty, the value of the
-@code{DEFAULT_CHARSET} variable in the environment is used instead.  If this
-variable is not defined, the Recode library uses the current locale's
-encoding.  On POSIX compliant systems, this depends on the first non-empty
-value among the environment variables LC_ALL, LC_CTYPE, LANG, and can be
-determined through the command @samp{locale charmap}.
+@code{DEFAULT_CHARSET} variable in the environment is used instead.
+If this variable is not defined, the Recode library (from version
+3.6 and up) uses the current locale's encoding.  On POSIX compliant
+systems, this depends on the first non-empty value among the environment
+variables LC_ALL, LC_CTYPE, LANG, and can be determined through the
+command @samp{locale charmap}.  If the current locale's encoding may not
+be resolved, then Recode presumes @code{ASCII} (or, for Recode
+3.6 only: @code{CHAR}).
 
 If the charset name is omitted but followed by surfaces, the surfaces
 then qualify the usual or default charset.  For example, the request
index b5ffa922e5b681bbf99aa1ffec77931a56fc0ad5..3ca2770980a19d2dd554c6c7a22b34217890cdae 100644 (file)
        Solve an old bug about loosing a few characters every 2048.
        * iconv.c (wrapped_transform): Rewritten.
        (transform_with_iconv): Simplified, use only one iconv_t.
-       Reported by Alexander Kurz, Andrew Green, Daniel Pfeiffer,
-       David Necas, Éric Bischoff, Frederik Fouvry, Guillaume Rumeau,
-       Jean-Christophe Guillain, John Gorman, Luc Maisonobe,
-       Marcin Owsiany, Martin Trautmann, Mikko Harjula, Peter Much,
-       Petr Pajas, Régis Martin, Stephen Walkauskas, Urban Mueller
-       dand Volker Wysk.
+       Reported by Alexander Kurz, Andreas Kunert, Andrew Green, Daniel
+       Pfeiffer, David Necas, Éric Bischoff, Frederik Fouvry, Guillaume
+       Rumeau, Jean-Christophe Guillain, John Gorman, Luc Maisonobe,
+       Marcin Owsiany, Martin Trautmann, Mikko Harjula, Pavel Forsite,
+       Peter Much, Petr Pajas, Régis Martin, Stephen Walkauskas,
+       Urban Mueller and Volker Wysk.
 
        * Makefile.am (EXTRA_DIST): Add stamp-strip.