From 1bbc1e359f177a07bfc5bc83ce6deb5ddbd6905f Mon Sep 17 00:00:00 2001 From: =?utf8?q?Fran=C3=A7ois=20Pinard?= Date: Tue, 11 Mar 2008 00:30:01 -0400 Subject: [PATCH] THANKS adjusted, and doc details --- THANKS | 2 + doc/ChangeLog | 7 +- doc/recode.info | 202 +++++++++++++++++++++++++----------------------- doc/recode.texi | 4 +- 4 files changed, 115 insertions(+), 100 deletions(-) diff --git a/THANKS b/THANKS index 5595729..39099d0 100644 --- a/THANKS +++ b/THANKS @@ -191,6 +191,7 @@ Peter Poeml poeml@cmdline.net http://www.poeml.de/ Peter Turcan peter.turcan@minerva-is.sk Petr Pajas pajas@ufal.ms.mff.cuni.cz + http://pajas.matfyz.cz Phyllis Frankl phyllis@morph.poly.edu http://ebbets.poly.edu/~pfrankl Pierre Gaumond gaumondp@ere.umontreal.ca @@ -216,6 +217,7 @@ Saverio Pangoli saverio@mystere.sci.sns.it Sebastian Huebner cyco@baud.de http://www.baud.de/cyco/ Scott Schwartz schwartz@bio.cse.psu.edu +Simon Cozens simon@cozens.net Slaven Rezic eserte@cs.tu-berlin.de http://user.cs.tu-berlin.de/~eserte Stefan Albertz Stefan.Albertz@rus.uni-stuttgart.de diff --git a/doc/ChangeLog b/doc/ChangeLog index 8786746..b84a56b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-03-10 François Pinard + + * recode.texi (Task level): Use name, not file, in example. + Reported by Simon Cozens. + 2008-03-08 François Pinard * recode.texi: Better document iconv processing. @@ -181,7 +186,7 @@ * recode.texi: Show program_name in the examples for the library usage, and document its purpose. - Reported by Kristian Köhntopp and Pawel Krawczyk. + Reported by Kristian Köhntopp, Pawel Krawczyk and Simon Cozens. 1999-11-27 François Pinard diff --git a/doc/recode.info b/doc/recode.info index ffd754e..fd9b2f5 100644 --- a/doc/recode.info +++ b/doc/recode.info @@ -562,9 +562,9 @@ lower case), digits, hyphens, underlines, periods, colons or round parentheses. The complete syntax for a valid REQUEST allows for unusual things, -which might surprise at first. (Do not pay too much attention to these -facilities on first reading.) For example, REQUEST may also contain -intermediate charsets, like in the following example: +which might be surprising at first. (Do not pay too much attention to +these facilities on first reading.) For example, REQUEST may also +contain intermediate charsets, like in the following example: BEFORE..INTERIM1..INTERIM2..AFTER @@ -1878,8 +1878,8 @@ a bit differently. recode_scan_request (request, "ibmpc..latin1"); task = recode_new_task (request); - task->input.file = ""; - task->output.file = ""; + task->input.name = ""; + task->output.name = ""; success = recode_perform_task (task); recode_delete_task (task); @@ -4309,11 +4309,19 @@ File: recode.info, Node: Surfaces, Next: Internals, Prev: Miscellaneous, Up: 13 All about surfaces ********************* -The "trivial surface" consists of using a fixed number of bits (often -eight) for each character, the bits together hold the integer value of -the index for the character in its charset table. There are many kinds -of surfaces, beyond the trivial one, all having the purpose of -increasing selected qualities for the storage or transmission. For +A "surface" is the varnish added over a charset so it fits in actual +bits and bytes. How end of lines are exactly encoded is not really +pertinent to the charset, and so, there is surface for end of lines. +`Base64' is also a surface, as we may encode any charset in it. Other +examples would DES enciphering, or gzip compression (even if Recode +does not offer them currently): these are ways to give a real life to +theoretical charsets. + + The "trivial surface" consists of using a fixed number of bits +(often eight) for each character, the bits together hold the integer +value of the index for the character in its charset table. There are +many kinds of surfaces, beyond the trivial one, all having the purpose +of increasing selected qualities for the storage or transmission. For example, surfaces might increase the resistance to channel limits (`Base64'), the transmission speed (`gzip'), the information privacy (`DES'), the conformance to operating system conventions (`CR-LF'), the @@ -5148,7 +5156,7 @@ Concept Index * stdbool.h header: Outer level. (line 31) * strict operation: Reversibility. (line 48) * string and comments conversion: Mixed. (line 39) -* structural surfaces: Surfaces. (line 36) +* structural surfaces: Surfaces. (line 44) * subsets in charsets: Listings. (line 222) * super-charsets: Mule. (line 6) * supported programming languages: Listings. (line 26) @@ -5157,12 +5165,12 @@ Concept Index * surface, what it is: Introduction. (line 31) * surfaces, aliases: Requests. (line 80) * surfaces, commutativity: Requests. (line 57) -* surfaces, implementation in Recode: Surfaces. (line 26) +* surfaces, implementation in Recode: Surfaces. (line 34) * surfaces, implied: Requests. (line 69) * surfaces, overview: Surface overview. (line 6) -* surfaces, structural: Surfaces. (line 36) +* surfaces, structural: Surfaces. (line 44) * surfaces, syntax: Requests. (line 52) -* surfaces, trees: Surfaces. (line 36) +* surfaces, trees: Surfaces. (line 44) * system detected problem, error message: Errors. (line 71) * task execution: Task level. (line 215) * task level functions: Task level. (line 6) @@ -5170,7 +5178,7 @@ Concept Index * Texinfo files: Texinfo. (line 6) * threshold for error reporting: Errors. (line 91) * time stamps of files: Recoding. (line 26) -* trivial surface: Surfaces. (line 6) +* trivial surface: Surfaces. (line 14) * tutorial: Tutorial. (line 6) * unavailable conversions: Charset overview. (line 33) * Unicode: UCS-2. (line 6) @@ -5494,7 +5502,7 @@ by Recode, and their aliases. * d1: Dump. (line 45) * d2: Dump. (line 52) * d4: Dump. (line 59) -* data, a special charset: Surfaces. (line 26) +* data, a special charset: Surfaces. (line 34) * data, not with charsets: Charset overview. (line 33) * de: Tabular. (line 142) * dec: Tabular. (line 138) @@ -5996,7 +6004,7 @@ by Recode, and their aliases. * TF-7: UTF-7. (line 12) * TF-8: UTF-8. (line 83) * ti: Texinfo. (line 6) -* tree, a special charset: Surfaces. (line 26) +* tree, a special charset: Surfaces. (line 34) * txte: Texte. (line 6) * u2: UCS-2. (line 30) * u4: UCS-4. (line 10) @@ -6059,85 +6067,85 @@ Node: Invoking recode19678 Node: Synopsis20633 Ref: Synopsis-Footnote-123073 Node: Requests23370 -Ref: Requests-Footnote-129255 -Ref: Requests-Footnote-229322 -Ref: Requests-Footnote-329500 -Node: Listings29959 -Ref: Listings-Footnote-141108 -Node: Recoding41431 -Node: Reversibility44252 -Ref: Reversibility-Footnote-152707 -Node: Sequencing52844 -Node: Mixed55288 -Node: Emacs58656 -Node: Debugging59690 -Node: Library63960 -Node: Outer level65314 -Node: Request level71424 -Node: Task level81891 -Node: Charset level92313 -Node: Errors93155 -Ref: Errors-Footnote-198001 -Ref: Errors-Footnote-298115 -Node: Universal98476 -Ref: Universal-Footnote-1101588 -Ref: Universal-Footnote-2101654 -Node: UCS-2101867 -Node: UCS-4104393 -Node: UTF-7104933 -Node: UTF-8105528 -Node: UTF-16109833 -Node: count-characters110981 -Node: dump-with-names111652 -Node: iconv114201 -Node: Tabular117632 -Node: ASCII misc139845 -Node: ASCII140211 -Node: ISO 8859141027 -Node: ASCII-BS143321 -Node: flat145158 -Node: IBM and MS145829 -Node: EBCDIC146373 -Node: IBM-PC148469 -Ref: IBM-PC-Footnote-1150583 -Node: Icon-QNX150742 -Node: CDC151167 -Node: Display Code152848 -Ref: Display Code-Footnote-1155129 -Node: CDC-NOS155334 -Node: Bang-Bang157296 -Node: Micros159225 -Node: Apple-Mac159608 -Node: AtariST161642 -Node: Miscellaneous162628 -Node: HTML163361 -Node: LaTeX169350 -Node: Texinfo170124 -Node: Vietnamese170896 -Node: African171872 -Node: Others173222 -Node: Texte174676 -Ref: Texte-Footnote-1179226 -Ref: Texte-Footnote-2179306 -Ref: Texte-Footnote-3179781 -Node: Mule179878 -Ref: Mule-Footnote-1181659 -Node: Surfaces182178 -Ref: Surfaces-Footnote-1185156 -Node: Permutations185260 -Node: End lines186101 -Node: MIME188302 -Node: Dump189489 -Node: Test193659 -Node: Internals196137 -Node: Main flow197365 -Node: New charsets200468 -Node: New surfaces205006 -Node: Design205732 -Ref: Design-Footnote-1214898 -Node: Concept Index215002 -Node: Option Index229745 -Node: Library Index232598 -Node: Charset and Surface Index237173 +Ref: Requests-Footnote-129260 +Ref: Requests-Footnote-229327 +Ref: Requests-Footnote-329505 +Node: Listings29964 +Ref: Listings-Footnote-141113 +Node: Recoding41436 +Node: Reversibility44257 +Ref: Reversibility-Footnote-152712 +Node: Sequencing52849 +Node: Mixed55293 +Node: Emacs58661 +Node: Debugging59695 +Node: Library63965 +Node: Outer level65319 +Node: Request level71429 +Node: Task level81896 +Node: Charset level92318 +Node: Errors93160 +Ref: Errors-Footnote-198006 +Ref: Errors-Footnote-298120 +Node: Universal98481 +Ref: Universal-Footnote-1101593 +Ref: Universal-Footnote-2101659 +Node: UCS-2101872 +Node: UCS-4104398 +Node: UTF-7104938 +Node: UTF-8105533 +Node: UTF-16109838 +Node: count-characters110986 +Node: dump-with-names111657 +Node: iconv114206 +Node: Tabular117637 +Node: ASCII misc139850 +Node: ASCII140216 +Node: ISO 8859141032 +Node: ASCII-BS143326 +Node: flat145163 +Node: IBM and MS145834 +Node: EBCDIC146378 +Node: IBM-PC148474 +Ref: IBM-PC-Footnote-1150588 +Node: Icon-QNX150747 +Node: CDC151172 +Node: Display Code152853 +Ref: Display Code-Footnote-1155134 +Node: CDC-NOS155339 +Node: Bang-Bang157301 +Node: Micros159230 +Node: Apple-Mac159613 +Node: AtariST161647 +Node: Miscellaneous162633 +Node: HTML163366 +Node: LaTeX169355 +Node: Texinfo170129 +Node: Vietnamese170901 +Node: African171877 +Node: Others173227 +Node: Texte174681 +Ref: Texte-Footnote-1179231 +Ref: Texte-Footnote-2179311 +Ref: Texte-Footnote-3179786 +Node: Mule179883 +Ref: Mule-Footnote-1181664 +Node: Surfaces182183 +Ref: Surfaces-Footnote-1185602 +Node: Permutations185706 +Node: End lines186547 +Node: MIME188748 +Node: Dump189935 +Node: Test194105 +Node: Internals196583 +Node: Main flow197811 +Node: New charsets200914 +Node: New surfaces205452 +Node: Design206178 +Ref: Design-Footnote-1215344 +Node: Concept Index215448 +Node: Option Index230191 +Node: Library Index233044 +Node: Charset and Surface Index237619  End Tag Table diff --git a/doc/recode.texi b/doc/recode.texi index e16ca1b..0464332 100644 --- a/doc/recode.texi +++ b/doc/recode.texi @@ -2190,8 +2190,8 @@ main (int argc, char *const *argv) recode_scan_request (request, "ibmpc..latin1"); task = recode_new_task (request); - task->input.file = ""; - task->output.file = ""; + task->input.name = ""; + task->output.name = ""; success = recode_perform_task (task); recode_delete_task (task); -- 2.40.0