[COMMIT] Eliminate a few problems in man/internals/internals.texi

APPROVE COMMIT NOTE: This patch has been committed. 2007-05-15 Aidan Kehoe <kehoea(a)parhasard.net&gt; * internals/internals.texi: Replace an inaccurate description of the read syntax of a Kanji character with one using the recently-added Unicode escapes. Also update the size of an Ichar; they're now 21-bit integers, not 19-bit integers. Index: internals/internals.texi =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/internals/internals.texi,v retrieving revision 1.79 diff -u -r1.79 internals.texi --- internals/internals.texi 2007/04/30 16:22:35 1.79 +++ internals/internals.texi 2007/05/15 10:21:28 ＠＠ -7526,22 +7526,12 ＠＠ converts to a char that represents the lowercase letter b. ＠example -?^[$(B#&^[(B +?\u5357 ＠end example -(where ＠samp{^[} actually is an ＠samp{ESC} character) converts to a -particular Kanji character when using an ISO2022-based coding system for -input. (To decode this goo: ＠samp{ESC} begins an escape sequence; -＠samp{ESC $ (} is a class of escape sequences meaning ``switch to a -94x94 character set''; ＠samp{ESC $ ( B} means ``switch to Japanese -Kanji''; ＠samp{#} and ＠samp{&} collectively index into a 94-by-94 array -of characters [subtract 33 from the ASCII value of each character to get -the corresponding index]; ＠samp{ESC (} is a class of escape sequences -meaning ``switch to a 94 character set''; ＠samp{ESC (B} means ``switch -to US ASCII''. It is a coincidence that the letter ＠samp{B} is used to -denote both Japanese Kanji and US ASCII. If the first ＠samp{B} were -replaced with an ＠samp{A}, you'd be requesting a Chinese Hanzi character -from the GB2312 character set.) +converts to a Han character meaning ``south, southwards''; depending on +how your XEmacs is configured, it will be assigned to either a Japanese +or Chinese character set (possibly even a Korean one). ＠example "foobar" ＠＠ -9890,7 +9880,7 ＠＠ 8-bit integer with possible values from 0 - 255. 0 - 127 are the standard ASCII characters, while 128 - 255 are the characters from the ISO-8859-1 character set. If we have compiled with MULE support, an -Ichar is a 19-bit integer, with the various bits having meanings +Ichar is a 21-bit integer, with the various bits having meanings according to a complex scheme that will be detailed later. The characters numbered 0 - 255 still have the same meanings as for the non-MULE case, though. ＠＠ -9930,9 +9920,9 ＠＠ Astute readers may notice that the text in a buffer is represented as an array of ＠emph{bytes}, while (at least in the MULE case) an Ichar is -a 19-bit integer, which clearly cannot fit in a byte. This means (of +a 21-bit integer, which clearly cannot fit in a byte. This means (of course) that the text in a buffer uses a different representation from -an Ichar: specifically, the 19-bit Ichar becomes a series of one to +an Ichar: specifically, the 21-bit Ichar becomes a series of one to four bytes. The conversion between these two representations is complex and will be described later. ＠＠ -10977,7 +10967,7 ＠＠ arguments that need to be in Unicode format. (mswindows-unicode is a coding system of type UTF-16) -＠item ms-windows-multi-byte +＠item mswindows-multi-byte this is used for representing text passed to MS Windows API calls with arguments that need to be in multi-byte format. Note that there are very few if any examples of such calls. ＠＠ -10995,17 +10985,19 ＠＠ used for text sent to or read from a text terminal in the absence of a more specific coding system (calls to window-system specific APIs should use the appropriate window-specific coding system if it makes sense to -do so.) +do so.) Like others here, this is a coding system alias. ＠item file-name used when specifying the names of files in the absence of a more -specific encoding, such as ms-windows-tstr. +specific encoding, such as ms-windows-tstr. This is a coding system +alias -- what it's an alias of is determined at startup. ＠item native the most general coding system for specifying text passed to system calls. This generally translates to whatever coding system is specified by the current locale. This should only be used when none of the coding -systems mentioned above are appropriate. +systems mentioned above are appropriate. This is a coding system +alias -- what it's an alias of is determined at startup. ＠end table ＠subheading Proper Display of Multilingual Text ＠＠ -11274,7 +11266,7 ＠＠ There are two internal encodings for characters in XEmacs/Mule. One is called ＠dfn{string encoding} and is an 8-bit encoding that is used for representing characters in a buffer or string. It uses 1 to 4 bytes per -character. The other is called ＠dfn{character encoding} and is a 19-bit +character. The other is called ＠dfn{character encoding} and is a 21-bit encoding that is used for representing characters individually in a variable. -- When I was in the scouts, the leader told me to pitch a tent. I couldn't find any pitch, so I used creosote. _______________________________________________ XEmacs-Patches mailing list XEmacs-Patches(a)xemacs.org http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-patches