USING MS-DOS KERMIT TO DISPLAY, ENTER, AND TRANSFER HEBREW TEXT Frank da Cruz Academic Information Systems Columbia University E-Mail: fdc@columbia.edu April-November, 1994 Beginning with version 3.13 (July 1993), MS-DOS Kermit includes full support for Hebrew text, including Hebrew terminal emulation for mixing Hebrew and Roman characters when using host-based Hebrew software, and translation of Hebrew character sets during file transfer. Version 3.14 includes a complete Hebrew package, including font and key mappings. This document assumes some familiarity with DOS and with MS-DOS Kermit. References are listed at the end. This document explains how to use MS-DOS Kermit in Hebrew mode for interacting with other computers. It does not address questions of Hebrew text processing within the PC environment itself. The Hebrew package described in this document has been verified to work on both English/American-model PCs and on Hebrew-model PCs, using host-based ALEPH 2.x and 3.x software, Hebrew Pico, Hebrew Pine, Hebrew World-Wide-Web, and VMS HEDT (based on TPU), both with and without Hebrew keyboard drivers and/or code pages loaded. WARNING: As of this writing, I have not been able to find a way to make the techniques described in this document work in a Microsoft Windows window. Even though Kermit itself works perfectly in a window, Windows does not allow the Hebrew font to be loaded. Reportedly, Windows 3.1 ML (Multi-Lingual) supports Hebrew, but perhaps not in a way that can be used by Kermit (it wants to control screen-writing direction itself). Thus, to use Kermit's Hebrew features, you must run Kermit in DOS or in a Windows fullscreen session, but not in a window. BACKGROUND: HEBREW CHARACTER SETS There are several coded character sets that contain the Hebrew alphabet. Each of these sets uses a different encoding; they are all mutually incompatible. To interchange Hebrew text between two computers that use different encodings, conversions must be done. Kermit software makes these conversions for you. The character sets are: ASCII - The American National Standard Code for Information Interchange. This is a 7-bit character set, incorporating 128 characters, of which 95 are "graphic" (printable) characters, and 17 are control characters such as carriage return, linefeed, etc. It contains no Hebrew, but it is the basis for all the other character sets discussed here, unless noted otherwise. It includes uppercase and lowercase Roman letters A-Z, digits 0-9, space, and various punctuation marks. ISO 8859-8 - The Latin/Hebrew Alphabet. The international standard character set for Hebrew, adopted by the International Organization for Standardization (ISO), of which Israel is a member body. It is an 8-bit character set, incorporating 256 characters, of which 137 are graphic characters, 65 are control characters, and 22 are undefined. It includes ASCII, some additional punctuation, math, and currency symbols, plus the 22 Hebrew letters and 5 final forms. IBM PC Code Page 862. Similar to Latin/Hebrew, but including many additional characters (line and box drawing, accented Roman letters, etc), and using different encoding. Used only on PCs. IBM Mainframe Code Page 424. An 8-bit mainframe code, totally incompatible with ASCII and everything else, which contains approximately the same repertoire as Latin/Hebrew. DEC Hebrew (or "Hebrew-7"). A 7-bit character set, equivalent to ASCII, but with the lowercase Roman letters replaced by Hebrew letters. Used to trick 7-bit applications and communication methods into handling Hebrew characters. ADDING HEBREW FEATURES TO KERMIT To use MS-DOS Kermit's Hebrew terminal emulation features, you must first have or load a Hebrew code page into your PC. "Code page" is IBM's term for "font" or "character set". Hebrew-model PCs come with the Hebrew code page already loaded; otherwise an EGA, VGA, or compatible video system that permits text fonts to be loaded is required, as well as DOS 3.30 or later. The Kermit diskette contains a public-domain Hebrew code page (and several others) and public-domain utilities for loading and displaying code pages, compiled and/or created by Professor Joseph (Yossi) Gil at the Technion, plus additional material created at Columbia University: the Hebrew setups and key mappings for Kermit, various character set tables, documentation, etc. Here is a brief synopsis of the files in the Kermit HEBREW directory: HEBREW.DOC - This file HEBREW.INI - Hebrew initialization file for Kermit HEBREW.HLP - Documentation for HEBREW.INI CP862.TBL - IBM PC Hebrew code page table ISO88598.TBL - ISO 8859-8 Latin/Hebrew alphabet table HEBREW-7.TBL - Hebrew-7 table And these are in the Kermit PCFONTS directory: LOADFONT.COM - Program for changing PC code page (font) LOADFONT.HLP - Help text for LOADFONT CHARSET.COM - Program to display current code page (font) CP437.F16 - USA code page CP850.F16 - Multinational (i.e. Western Europe) code page CP852.F16 - Eastern Europe code page CP862.F16 - Hebrew code page CP866.F16 - Cyrillic code page The CPxxx.F16 files are to be used with LOADFONT when your PC screen has 25 lines (there are also .F08 files that can be used for larger screen lengths). For example, to load the Hebrew code page, type the following command at the DOS prompt: C:\> cd c:\kermit\pcfonts ^^^^^^^^^^^^^^^^^^^^ C:\> loadfont cp862.f16 ^^^^^^^^^^^^^^^^^^ The CP862.TBL file will look right when you have CP862 loaded (for example, when you TYPE it, EDIT it, etc). The other .TBL files are there for reference and practice. Even if you have a Hebrew code page or font already loaded, the HEBREW macro will load CP862.F16 anyway. That's because there is no reliable way for Kermit to tell that the Hebrew code page is already active; for example, on Hebrew-model PCs that have a Hebrew "hardware" code page, CHCP reports "437" instead of "862". No harm is done by loading CP862.F16 over your previous Hebrew code page, but it might look slightly different. If LOADFONT should fail (e.g. on a Hebrew-model PC with Mono or CGA adapter that does not support loadable fonts), but there is already a Hebrew hardware code page, everything should still work correctly. USING KERMIT'S HEBREW FEATURES After you start Kermit, type the command: HEBREW at the "MS-Kermit>" prompt. "HEBREW" is a macro, defined in MSKERMIT.INI, that executes the HEBREW.INI file from the KERMIT\HEBREW directory. HEBREW.INI sets everything up for you automatically. If you always want to have the Hebrew features available when you use Kermit, use a text editor to add the HEBREW command to your MSCUSTOM.INI file, and then you won't have to type this command at all. If you also want your numeric keypad to be loaded with VT100/200/300 functions, then you should also TAKE the KERMIT\KEYBOARD\VT300.INI file. If, in addition, you want the Num Lock key to function as the DEC Gold key, you must run the GOLD.COM program -- see KEYBOARDS\GOLD.DOC. The HEBREW.INI file: 1. Activates ISO 8859-8 / CP862 character-set translations. 2. Adds commands to let you change code pages easily. 3. Loads the Hebrew code page. 4. Defines the key maps for Hebrew and English keyboard modes. 5. Sets up commands and hot keys for switching keyboard modes. 6. Sets up hot keys for switching screen-writing direction. The initial keyboard mode is English. The Hebrew font remains loaded after you exit from Kermit, unless you load another font yourself. After Kermit has executed the HEBREW.INI command file, the following new commands are available at at the "MS-Kermit>" prompt: HKEYS Enter Hebrew keyboard mode upon next CONNECT command. EKEYS Enter English keyboard mode upon next CONNECT command. HFONT Load the Hebrew font (done automatically when you TAKE HEBREW.INI) EFONT Load the US font (CP437) MFONT Load the Multinational (West European) font (CP850) And the following function keys are available during terminal emulation (CONNECT mode): F5 "Hot key" to enter Hebrew keyboard mode immediately. F6 Hot key to enter English keyboard mode immediately. F7 Equivalent to DEC VT terminal's F7 key (for use with ALEPH software). F9 Select right-to-left screen writing. F10 Select left-to-right screen writing. USING MS-DOS KERMIT FOR HEBREW TERMINAL EMULATION The HEBREW.INI file sets Kermit up for an 8-bit connection to hosts and applications that use the 8-bit ISO Latin/Hebrew character set. This is the the international standard Hebrew character set, and the one used by most host-based applications, such as the ALEPH Hebrew library software. It is not the same as the PC Hebrew code page, so Kermit must translate between the two. There are at least two other possibilities, which you must consider if you access a Hebrew application through Kermit, but the characters look wrong: . On 7-bit connections, "Hebrew-7" -- a 7-bit character set in which the lowercase Roman letters are replaced by Hebrew letters -- is generally used. Hebrew-7 codes are different from Latin/Hebrew and also from CP862. Hebrew-7 is commonly used in e-mail, in which it is difficult or impossible to transmit 8-bit text. To use Hebrew-7: SET TERMINAL CHARACTER-SET HEBREW-7 SET TERMINAL BYTESIZE 7 . It is possible that some Israeli BBSs use Code Page 862. In this case, tell Kermit not to translate. SET TERMINAL CHARACTER-SET TRANSPARENT SET TERMINAL BYTESIZE 8 . For completeness, here are the commands to use ISO Latin/Hebrew: SET TERMINAL CHARACTER-SET HEBREW-ISO SET TERMINAL BYTESIZE 8 Before accessing the host or service, you must also choose the appropriate type of terminal emulation, one of the following (use the highest model that works): SET TERMINAL TYPE VT320 (this is the default) SET TERMINAL TYPE VT220 SET TERMINAL TYPE VT102 SET TERMINAL TYPE VT100 From this point, Hebrew-aware software on the remote host or service should be able to produce correctly formatted screens containing any mixture of English and Hebrew. ENTERING HEBREW CHARACTERS ON THE KEYBOARD MS-DOS Kermit acts like a Hebrew-model DEC VT terminal. Like your PC, the VT terminal has the normal number of keys; it does not have extra keys for Hebrew. Thus, some keys are "shared" between Roman and Hebrew characters. To send Hebrew letters the keyboard must be in "Hebrew mode", and to send lowercase Roman letters, the keyboard must be in "English mode". The HEBREW.INI file supplies you with commands and hot keys to switch modes: Command Hot-Key Enter Hebrew mode: HKEYS F5 Enter English mode: EKEYS F6 Use the commands (HKEYS, EKEYS) when at the "MS-Kermit>" prompt; use the hot keys (F5, F6) during terminal emulation. MS-DOS Kermit also allows the host application to change your keyboard mode automatically by sending escape sequences (ALEPH does this); see Appendix I at the end of this file. When Hebrew key mappings are in effect and you press any key to which a Hebrew code is assigned during terminal emulation, Kermit automatically translates the PC Hebrew code into the appropriate code (HEBREW-ISO or HEBREW-7 or TRANSPARENT) for the remote application, according to your TERMINAL CHARACTER-SET. In other words, you do NOT need different key mappings for different host Hebrew character sets. HEBREW FILE TRANSFER Hebrew text-file transfer is supported by MS-DOS Kermit, C-Kermit (UNIX, VMS, OS/2, Stratus VOS, etc), and IBM Mainframe Kermit (VM/CMS, MVS/TSO, CICS). When transferring Hebrew text files between MS-DOS Kermit and a remote computer or service, use the following commands to ensure that the Hebrew characters are translated correctly: On the PC: On the remote computer: SET FILE CHARACTER-SET CP862 SET FILE CHARACTER-SET xxx SET TRANSFER CHARACTER-SET HEBREW SET TRANSFER CHARACTER-SET HEBREW xxx is the name of the Hebrew character-set on the remote host, such as HEBREW-ISO, HEBREW-7, or (only on IBM Mainframes) CP424. Then send and receive text files in the normal way. PRINTING All files created on your PC's disk by Kermit will record Hebrew letters in the IBM PC Hebrew code page, CP862 (provided you have set up the appropriate translation). If you have a printer that is capable of printing this character set, then all the normal printing facilities of DOS and of Kermit should work as expected: . The DOS PRINT command. . The Print Screen key in DOS or Kermit. . etc etc. NOTE: If you have an IBM printer that is capable of code-page switching, then the Hebrew fonts supplied on the Hebrew disk will probably not print correctly. In this case, you will need the real IBM Code Page 862, such as IBM's HEBEGA.CPI, prepared and loaded according to the instructions on pages 126-129 of "Using MS-DOS Kermit". If you do NOT have a printer with a Hebrew font built in, then you must use higher-level software to do the printing. Reportedly, for example, it is possible to import a plain-text CP862 file (such as Kermit would create when you save a screen) into Hebrew WordPerfect and then print it from there. ACCESSING THE ALEPH LIBRARY CATALOG APPLICATION The ALEPH system, in use throughout Israel and also at the Jewish Theological Seminary of America (JTSA), is designed for use by DEC VT terminals, such as those emulated by MS-DOS Kermit, and it uses the 8-bit ISO Latin/Hebrew alphabet. The HEBREW.INI file sets everything up for you. If your PC is on a TCP/IP network and your MSCUSTOM.INI (MS-DOS Kermit customization file) is correctly set up for TCP/IP, you can telnet directly from your PC to an ALEPH host, e.g.: MS-Kermit> telnet jtsa.edu ^^^^^^^^^^^^^^^ If your PC is not on the network, you can dial up with a modem. No matter which way you came in, you should now see the host banner and login prompt, e.g.: ********************************************************************** * The Jewish Theological Seminary of America * * VAX/VMS v.5-4 * ********************************************************************** Username: ALEPH ^^^^^ Respond to the "Username:" prompt by typing the word "aleph" and then press the Enter key. You won't need a password. Now you will see a greeting and menu like this: Welcome to VAX/VMS version V5.4 on node THEO Last interactive login on Tuesday, 8-FEB-1994 18:38 Last non-interactive login on Sunday, 4-JUL-1993 18:44 Terminal selection Standard (non soft font) terminals: 3. VT102 (Latin only, unless accessed using Israeli ALEPH KERMIT) 11. VT220 protocol (VT220,VT320,VT340,VT420,V603, etc. Latin only, unless terminal has Hebrew chip installed) Full Latin and SOFT FONT (Hebrew, Arabic, Cyrillic) standard terminals: 17. VT320 18. VT420 English/Hebrew and SOFT FONT (Arabic, Cyrillic) Israeli Hebrew chip terminals: 27. VT320 28. VT420 Select from menu : 11 ^^ Choose 11 (VT220) from the terminal-type menu. That's all there is to it. Now you should see an English menu on your screen with Hebrew writing near the top. Here's a quick demo: 1. In the menu screen, type "?/HEB" (uppercase, without the quotes) and then press the Enter key to switch to Hebrew display mode. The menu should change to all Hebrew, and your keyboard should switch automatically into Hebrew mode. 2. Now type "?/ENG" to switch back to English. Beware: Since the keyboard is in Hebrew mode while you are typing this, the slash character (/) is now mapped to lowercase "q", so to enter "?/ENG", you must type "?qENG". Notice how these characters echo when you type them. Now you should see a help screen whose left side is English and whose right side is Hebrew. 3. Now type "ENG" or "HEB" to select English or Hebrew screens. The host application automatically switches your keyboard to the appropriate mode. If you select Hebrew, the Hebrew key mappings go into effect automatically; if you select English, the English mappings are made automatically. 4. In an English screen, search for (say) authors named Singer by typing: AU/Singer In a Hebrew screen type the Hebrew author-search command, Mem-Chet-slash (njq) and the author's name in Hebrew, for example "zhbdr" (= Zade Yod Nun Gimel Resh = Zinger): njqzhbdr 5. To capture a screen, hold down the Ctrl key and press the End key on the numeric keypad. This copies text on the screen to a file on your disk called KERMIT.SCN. If you do this more than once, it will keep adding new screens to the end of the KERMIT.SCN file, separating each one by a Formfeed. To get back to the main menu at any time, press the PC's F7 key. To leave ALEPH, type the word "STOP" (without the quotes) and then press the Enter key. Some Hebrew library catalogs that use the ALEPH software are: Central ALEPH Computer Telnet RAM2.HUJI.AC.IL or 128.139.4.207 Bar-Ilan University Telnet ALEPH.BIU.AC.IL or 132.70.9.36 Ben-Gurion University Telnet BGULIB.BGU.AC.IL Haifa University Telnet LIB.HAIFA.AC.IL or 132.74.1.100 Hebrew University Telnet ALEPH.HUJI.AC.IL or 128.139.4.207 Jewish Theological Seminary Telnet JTSA.EDU Technion Telnet LIB.TECHNION.AC.IL or 132.68.1.20 Tel Aviv University Telnet TAUVAX.TAU.AC.IL or 132.66.32.6 Weizmann Institute of Science Telnet WISLIB.WEIZMANN.AC.IL or 132.76.64.14 In all cases, the username to use is ALEPH and no password is required, and in all cases you should choose "11" from the terminal-type menu. Also, please note that references to "Hebrew-University Kermit" are obsolete, as are the instructions for using it. All the work done at Hebrew University was incorporated into MS-DOS Kermit 3.13, and upgraded to a higher level of functionality. Please ignore the instructions about special MSKERMIT.INI files, VT102 emulation, Terminal Type 3, etc. USING KERMIT'S HEBREW FEATURES IN NON-HEBREW APPLICATIONS You can use Kermit's Hebrew features to create or view plain-text documents on a CUNIX or other host computer written in Hebrew (or Yiddish?) (or Ladino?) if you keep the following points in mind: . Hebrew characters are restricted to the basic set of 22 letters and 5 final forms. . Hebrew characters are stored and transmitted "left to right", even though they should be displayed right to left. . You can't mix Roman and Hebrew text in a plain-text file unless you are willing to type the Hebrew letters in reverse order (or vice-versa, depending on how the text is to be displayed). That's because non-Hebrew-aware software is not equipped to handle bidirectional text. If you are using Kermit to create or read Hebrew text on a computer that does not have Hebrew-aware software, you can tell Kermit to reverse its screen-writing direction to force characters to be written right-to-left: SET TERMINAL DIRECTION RIGHT-TO-LEFT And, of course, you can also undo this effect: SET TERMINAL DIRECTION LEFT-TO-RIGHT The HEBREW.INI file assigns these functions to F9 and F10, respectively, so you can conveniently switch direction during terminal emulation. If your connection to the host application is "8-bit clean", AND the application itself is also 8-bit clean, you can use the ISO 8859-8 Latin/Hebrew Alphabet, which contains full upper and lowercase Roman, plus Hebrew, plus a variety of symbols. Unfortunately, very few host applications are 8-bit clean (except on VMS -- such as ALEPH and HEDT). EXAMPLE: Creating a Hebrew text file with the VMS EVE (EDIT/TPU) editor: 1. Type "hebrew" at the MS-Kermit> prompt. 2. Log in to the VAX. 3. EDIT/TPU <filename>. 4. Push F5 to enter Hebrew keyboard mode. 5. Push F9 to select right-to-left screen writing. 6. Create/edit the file in the normal way. All the English will be displayed backwards, but the Hebrew will look right. IN THE 7-BIT ENVIRONMENT, you'll have to use the Hebrew-7 character set, in which lowercase Roman letters are replaced by Hebrew letters; thus only uppercase Roman letters are available. For example, to send a Hebrew e-mail message with (English) Pine: 1. Access and log in to CUNIX (don't put Kermit into Hebrew mode yet). 2. Start Pine and select COMPOSE MESSAGE. 3. Fill out the To: and Subject: fields of the message using Roman letters. 4. Move to the message body using the down-arrow or Enter key. 5. Press the F5 key to enter Hebrew keyboard mode. 6. Use Alt-x to return to the MS-Kermit> prompt and enter the following commands: hebrew set terminal character-set hebrew-7 set terminal bytesize 7 connect Remember: you can abbreviate Kermit commands and keywords (but not filenames) to their minimum unique length. So the above commands could also be entered as: hebrew set ter ch hebrew-7 set ter by 7 c 7. Push F9 to select right-to-left screen writing. 8. Type Ctrl-L (hold down Ctrl and press the L key) to refresh the screen. 9. Enter Hebrew text into the message body, referring to the keyboard map. If you must type numbers, enter the digits in reverse order. If you must type English text, enter the letters in UPPER CASE and in reverse order. 10. To send the message, type Ctrl-X (hold down Ctrl, press X). 11. To return to English mode, press F6 and F10, then Ctrl-L to refresh the screen. 12. Enter Q to quit from Pine. The person who receives your message must, of course, also be set up for the Hebrew-7 character set and right-to-left display. Remember that when the keyboard is in Hebrew mode, all Roman letters must be entered in UPPER CASE. This includes (of course) Pine commands. OTHER HOST-BASED HEBREW APPLICATIONS There is a version of the text editor EMACS, developed in Japan, called MULE (MUltiLingual EMACS), which is capable of handling Hebrew (as well as almost any other script in the world), fully accomodating mixed Hebrew and Roman (or other) scripts, and (reportedly) handling bidirectionality correctly. It works best with X terminals, but might also work in Hebrew mode with PCs running Kermit. There is a Hebrew version of the UNIX VI text editor, called vi.iv, from the Technion in Haifa. Hebrew Pine and Pico are available from Hebrew University, horizon.huji.ac.il. HEDT is a product of DEC Israel. EPILOG Because Hebrew text is intrinsically bidirectional (since, for example, numbers are written left-to-right, and Roman or other types of left-to-right text are often mixed in), no "plain-text" standard for Hebrew has ever emerged. Hebrew text can only be handled on a "higher" level, e.g. by applications such as the JTSA catalog, Hebrew WordPerfect, and so on. Unfortunately, but not surprisingly, these higher-level applications are incompatible with each other, using different character sets and different methods for indicating and controlling directionality, not to mention other rendering and representation issues (Macintosh vs PC, font selection and style, boldface, italic, etc etc). Thus, widespread system- and application- independent interchange of Hebrew text has never been achieved. Informants in Israel tell me, for example, that Hebrew simply is not used in e-mail; everybody gets by with English. The situation with Arabic is similar, but not identical. The situation with other non-Roman alphabetic scripts, such as Cyrillic and Greek, is far better. These scripts can be handled very easily by a simple font change, and mixtures of Cyrillic and Roman or Greek and Roman letters in a plain text file poses no problems at all. Similar comments apply to other left-to-right alphabetic scripts such as Armenian, Georgian, etc. In the future, there will be a universal coded character set, ISO 10646, capable of representing all of the world's scripts in a single coding system, including both modern and ancient scripts. Presently, ISO 10646 includes only the basic Hebrew repertoire of 22 letters plus 5 final forms. An extension to this standard, proposed by the Israel Institute for Standards, will add vowel points, cantillation marks, and possibly also unique Hebrew forms of punctuation as well as Yiddish digraphs. ISO 10646 (and its precursor, Unicode, which is in most part a compatible subset of ISO 10646) will allow text to contain any mixture of scripts. But massive changes in software, data, as well as in display, printing, and data entry devices will be required, so only time will tell if ISO 10646 will achieve widespread use. APPENDIX I - THE HEBREW KEY MAP (Note: Names of Hebrew letters are from the ISO 8859-8 Standard.) Hebrew Order Roman Order QWERTY Keyboard Order q = Slash , = Taw q = Slash w = Apostrophe . = Terminal Zade w = Apostrophe ' = Comma ' = Comma e = Qoph / = Period / = Period r = Resh t = Aleph ; = Terminal Pe t = Aleph c = Bet a = Shin y = Tet d = Gimel b = Nun u = Waw s = Dalet c = Bet i = Terminal Nun v = He d = Gimel o = Terminal Mem u = Waw e = Qoph p = Pe z = Zain f = Kaph a = Shin j = Chet g = Ayin s = Dalet y = Tet h = Yod d = Gimel h = Yod i = Terminal Nun f = Kaph l = Terminal Kaph j = Chet g = Ayin f = Kaph k = Lamed h = Yod k = Lamed l = Terminal Kaph j = Chet o = Terminal Mem m = Zade k = Lamed n = Mem n = Mem l = Terminal Kaph i = Terminal Nun o = Terminal Mem ; = Terminal Pe b = Nun p = Pe ' = Comma x = Samech q = Slash z = Zain g = Ayin r = Resh x = Samech ; = Terminal Pe s = Dalet c = Bet p = Pe t = Aleph v = He . = Terminal Zade u = Waw b = Nun m = Zade v = He n = Mem e = Qoph w = Apostrophe m = Zade r = Resh x = Samech , = Taw a = Shin y = Tet . = Terminal Zade , = Taw z = Zain / = Period If you have a PostScript printer, you can get a picture of the key map by printing the KEYMAP.PS file from the KERMIT\HEBREW directory. APPENDIX II - Technical Summary Hebrew terminal emulation and file transfer (version 3.13). Commands: SET TRANSFER CHARACTER-SET HEBREW SET FILE CHARACTER-SET CP862 SET TERMINAL CHARACTER-SET { HEBREW-ISO, HEBREW-7 } SET TERMINAL DIRECTION { RIGHT-TO-LEFT, LEFT-TO-RIGHT } SET TERMINAL CODE-PAGE CP862 Terminal direction is controlled in two different ways: (1) by host-generated escape sequences (automatic, see below) and (2) by the SET TERMINAL DIRECTION command. When the writing direction is changed by escape sequences from the host, the cursor-positioning coordinate system is not changed. For example, if Kermit was in left-to-right mode and the host send ESC [ ? 34 h, position (1,1) would still be in the upper left. This is how a real Hebrew-model VT terminal works. If, however, you command Kermit into RIGHT-TO-LEFT mode, the coordinate system flips right to left so the origin (1,1) is at the upper right corner, which is useful for viewing and composing some right to left text. The host can override the user setting, and the user can later override the host setting. Hebrew character sets: . CP862 is the PC Hebrew code page, available from IBM as EGAHE.COM, or perhaps as a hardware code page on Hebrew-model PCs. Distributed on the the Kermit diskette in a public-domain form as CP862.F16, to be used with the (also public-domain) LOADFONT program. . HEBREW-ISO is the 8-bit standard ISO 8859-8 Latin/Hebrew alphabet. . HEBREW-7 is the 7-bit Hebrew "National Replacement Character Set" (NRC), ASCII with the lowercase Roman letters replaced by Hebrew letters, often used in e-mail. MS-DOS Kermit 3.13 supports: . Automatic selection of writing direction by host escape sequence. . ISO 2022-compliant terminal character-set designation and invocation. . Hebrew keyboard mode. Hebrew-specific escape sequences recognized by the VT220 and 320 terminal emulators: ESC ) H Designates right half of Latin/Hebrew to G1 ESC * H Designates right half of Latin/Hebrew to G2 ESC + H Designates right half of Latin/Hebrew to G3 ESC ( % = Designates 7-bit Hebrew NRC to G0-G3 ESC ) " 4 Designates DEC supplement Hebrew letters to G1 ESC * " 4 Designates DEC supplement Hebrew letters to G2 ESC + " 4 Designates DEC supplement Hebrew letters to G3 DCS 0 ! u " 4 ST Assigns DEC supplement Hebrew as UPSS DCS 0 ! u H ST Assigns Latin/Hebrew as UPSS CSI ? 34 h Sets right-to-left screen-writing mode CSI ? 34 l Sets left-to-right screen-writing mode CSI ? 35 h Sets Hebrew keyboard mapping via Kermit macros CSI ? 35 l Sets Roman (North American) keyboard mapping, ditto CSI ? 36 h Hebrew encoding mode: 7-bit Hebrew-7 "National mode" CSI ? 36 l Hebrew encoding mode: 8-bit ISO Latin/Hebrew Hebrew keyboard mapping: . CSI ? 35 h invokes the macro KEYBOARDS, which you must define to set up your keyboard for entering Hebrew characters. If this macro is not defined, nothing happens. . CSI ? 35 l invokes the macro KEYBOARDR, which you must define to set up your keyboard for entering Roman (North American) characters. If this macro is not defined, nothing happens. NOTE: do not define KEYBOARDS without also defining KEYBOARDR to undo its effects! The various reports furnished by MS-DOS Kermit also include Hebrew-specific information, and the following host-initiated operations work in both left- to-right and right-to-left mode: Insert/Replace Mode, Autowrap, Backspace, Carriage Return, Linefeed, Formfeed, Vertical Tab, Horizontal Tab. The keyboard mapping sequences invoke the user-defined macros KEYBOARDS (h) and KEYBOARDR (l). Users should define these macros to accomplish the desired keyboard mappings with SET KEY commands. Sample mappings (those used with Hebrew WordPerfect, etc) are supplied in the HEBREW.INI file. In VT100 and VT102 mode, the following functions are supported: ESC ) 1 Enter Hebrew mode ESC ) B Exit Hebrew mode FURTHER READING 1. Your MS-DOS manual, the sections on code pages. For example, Microsoft MS-DOS Operating System Version 5.0 User's Guide and Reference (1992), Chapter 13 and the Appendix, "Keyboard Layouts and Code Pages". 2. Gianone, Christine M., "Using MS-DOS Kermit", Digital Press (1992), Chapter 13, "International Character Sets". Also, for TCP/IP setup, Chapter 16, "Kermit on Local Area Networks". 3. The files KERMIT.UPD and HEBREW\HEBREW.HLP on the MS-DOS 3.13 diskette. 4. The Hebrew character-set tables in the HEBREW directory, and the PC font material in the PCFONTS directory. 5. The Unicode Standard, Worldwide Character Encoding, Version 1.0, Volume 1, The Unicode Consortium. Addison-Wesley (1991). (End of HEBREW.DOC)