home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / mskermit / msvibm.hbr < prev    next >
Text File  |  2020-01-01  |  32KB  |  694 lines
  1. USING MS-DOS KERMIT TO DISPLAY, ENTER, AND TRANSFER HEBREW TEXT
  2.  
  3.   Frank da Cruz
  4.   Academic Information Systems
  5.   Columbia University
  6.   E-Mail: fdc@columbia.edu
  7.   April-November, 1994
  8.  
  9. Beginning with version 3.13 (July 1993), MS-DOS Kermit includes full support
  10. for Hebrew text, including Hebrew terminal emulation for mixing Hebrew and
  11. Roman characters when using host-based Hebrew software, and translation of
  12. Hebrew character sets during file transfer.  Version 3.14 includes a complete
  13. Hebrew package, including font and key mappings.
  14.  
  15. This document assumes some familiarity with DOS and with MS-DOS Kermit.
  16. References are listed at the end.
  17.  
  18.   This document explains how to use MS-DOS Kermit in Hebrew mode for
  19.   interacting with other computers.  It does not address questions
  20.   of Hebrew text processing within the PC environment itself.
  21.  
  22. The Hebrew package described in this document has been verified to work on
  23. both English/American-model PCs and on Hebrew-model PCs, using host-based
  24. ALEPH 2.x and 3.x software, Hebrew Pico, Hebrew Pine, Hebrew World-Wide-Web,
  25. and VMS HEDT (based on TPU), both with and without Hebrew keyboard drivers
  26. and/or code pages loaded.
  27.  
  28. WARNING: As of this writing, I have not been able to find a way to make the
  29. techniques described in this document work in a Microsoft Windows window.
  30. Even though Kermit itself works perfectly in a window, Windows does not allow
  31. the Hebrew font to be loaded.  Reportedly, Windows 3.1 ML (Multi-Lingual)
  32. supports Hebrew, but perhaps not in a way that can be used by Kermit (it wants
  33. to control screen-writing direction itself).  Thus, to use Kermit's Hebrew
  34. features, you must run Kermit in DOS or in a Windows fullscreen session, but
  35. not in a window.
  36.  
  37. BACKGROUND: HEBREW CHARACTER SETS
  38.  
  39. There are several coded character sets that contain the Hebrew alphabet.  Each
  40. of these sets uses a different encoding; they are all mutually incompatible.
  41. To interchange Hebrew text between two computers that use different encodings,
  42. conversions must be done.  Kermit software makes these conversions for you.
  43. The character sets are:
  44.  
  45. ASCII - The American National Standard Code for Information Interchange.
  46.   This is a 7-bit character set, incorporating 128 characters, of which 95 are
  47.   "graphic" (printable) characters, and 17 are control characters such as
  48.   carriage return, linefeed, etc.  It contains no Hebrew, but it is the basis
  49.   for all the other character sets discussed here, unless noted otherwise.  It
  50.   includes uppercase and lowercase Roman letters A-Z, digits 0-9, space, and
  51.   various punctuation marks.
  52.  
  53. ISO 8859-8 - The Latin/Hebrew Alphabet.
  54.   The international standard character set for Hebrew, adopted by the
  55.   International Organization for Standardization (ISO), of which Israel is a
  56.   member body.  It is an 8-bit character set, incorporating 256 characters, of
  57.   which 137 are graphic characters, 65 are control characters, and 22 are
  58.   undefined.  It includes ASCII, some additional punctuation, math, and
  59.   currency symbols, plus the 22 Hebrew letters and 5 final forms.
  60.  
  61. IBM PC Code Page 862.
  62.   Similar to Latin/Hebrew, but including many additional characters (line and
  63.   box drawing, accented Roman letters, etc), and using different encoding.
  64.   Used only on PCs.
  65.  
  66. IBM Mainframe Code Page 424.
  67.   An 8-bit mainframe code, totally incompatible with ASCII and everything
  68.   else, which contains approximately the same repertoire as Latin/Hebrew.
  69.  
  70. DEC Hebrew (or "Hebrew-7").
  71.   A 7-bit character set, equivalent to ASCII, but with the lowercase Roman
  72.   letters replaced by Hebrew letters.  Used to trick 7-bit applications and
  73.   communication methods into handling Hebrew characters.
  74.  
  75. ADDING HEBREW FEATURES TO KERMIT
  76.  
  77. To use MS-DOS Kermit's Hebrew terminal emulation features, you must first have
  78. or load a Hebrew code page into your PC.  "Code page" is IBM's term for "font"
  79. or "character set".  Hebrew-model PCs come with the Hebrew code page already
  80. loaded; otherwise an EGA, VGA, or compatible video system that permits text
  81. fonts to be loaded is required, as well as DOS 3.30 or later.
  82.  
  83. The Kermit diskette contains a public-domain Hebrew code page (and several
  84. others) and public-domain utilities for loading and displaying code pages,
  85. compiled and/or created by Professor Joseph (Yossi) Gil at the Technion, plus
  86. additional material created at Columbia University: the Hebrew setups and key
  87. mappings for Kermit, various character set tables, documentation, etc.
  88.  
  89. Here is a brief synopsis of the files in the Kermit HEBREW directory:
  90.  
  91.    HEBREW.DOC   - This file
  92.    HEBREW.INI   - Hebrew initialization file for Kermit
  93.    HEBREW.HLP   - Documentation for HEBREW.INI
  94.    CP862.TBL    - IBM PC Hebrew code page table
  95.    ISO88598.TBL - ISO 8859-8 Latin/Hebrew alphabet table
  96.    HEBREW-7.TBL - Hebrew-7 table   
  97.  
  98. And these are in the Kermit PCFONTS directory:
  99.  
  100.    LOADFONT.COM - Program for changing PC code page (font)
  101.    LOADFONT.HLP - Help text for LOADFONT
  102.    CHARSET.COM  - Program to display current code page (font)
  103.  
  104.    CP437.F16    - USA code page
  105.    CP850.F16    - Multinational (i.e. Western Europe) code page
  106.    CP852.F16    - Eastern Europe code page
  107.    CP862.F16    - Hebrew code page
  108.    CP866.F16    - Cyrillic code page
  109.  
  110. The CPxxx.F16 files are to be used with LOADFONT when your PC screen has 25
  111. lines (there are also .F08 files that can be used for larger screen lengths).
  112. For example, to load the Hebrew code page, type the following command at the
  113. DOS prompt:
  114.  
  115.   C:\> cd c:\kermit\pcfonts
  116.        ^^^^^^^^^^^^^^^^^^^^
  117.   C:\> loadfont cp862.f16
  118.        ^^^^^^^^^^^^^^^^^^
  119. The CP862.TBL file will look right when you have CP862 loaded (for example,
  120. when you TYPE it, EDIT it, etc).  The other .TBL files are there for reference
  121. and practice.
  122.  
  123. Even if you have a Hebrew code page or font already loaded, the HEBREW macro
  124. will load CP862.F16 anyway.  That's because there is no reliable way for
  125. Kermit to tell that the Hebrew code page is already active; for example, on
  126. Hebrew-model PCs that have a Hebrew "hardware" code page, CHCP reports "437"
  127. instead of "862".  No harm is done by loading CP862.F16 over your previous
  128. Hebrew code page, but it might look slightly different.  If LOADFONT should
  129. fail (e.g. on a Hebrew-model PC with Mono or CGA adapter that does not support
  130. loadable fonts), but there is already a Hebrew hardware code page, everything
  131. should still work correctly.
  132.  
  133. USING KERMIT'S HEBREW FEATURES
  134.  
  135. After you start Kermit, type the command:
  136.  
  137.   HEBREW
  138.  
  139. at the "MS-Kermit>" prompt.  "HEBREW" is a macro, defined in MSKERMIT.INI,
  140. that executes the HEBREW.INI file from the KERMIT\HEBREW directory.
  141. HEBREW.INI sets everything up for you automatically.  If you always want to
  142. have the Hebrew features available when you use Kermit, use a text editor to
  143. add the HEBREW command to your MSCUSTOM.INI file, and then you won't have to
  144. type this command at all.
  145.  
  146. If you also want your numeric keypad to be loaded with VT100/200/300
  147. functions, then you should also TAKE the KERMIT\KEYBOARD\VT300.INI file.
  148. If, in addition, you want the Num Lock key to function as the DEC Gold key,
  149. you must run the GOLD.COM program -- see KEYBOARDS\GOLD.DOC.
  150.  
  151. The HEBREW.INI file:
  152.  
  153.   1. Activates ISO 8859-8 / CP862 character-set translations.
  154.   2. Adds commands to let you change code pages easily.
  155.   3. Loads the Hebrew code page.
  156.   4. Defines the key maps for Hebrew and English keyboard modes.
  157.   5. Sets up commands and hot keys for switching keyboard modes.
  158.   6. Sets up hot keys for switching screen-writing direction.
  159.  
  160. The initial keyboard mode is English.
  161.  
  162. The Hebrew font remains loaded after you exit from Kermit, unless you load
  163. another font yourself.
  164.  
  165. After Kermit has executed the HEBREW.INI command file, the following new
  166. commands are available at at the "MS-Kermit>" prompt:
  167.  
  168.   HKEYS   Enter Hebrew keyboard mode upon next CONNECT command.
  169.   EKEYS   Enter English keyboard mode upon next CONNECT command.
  170.   HFONT   Load the Hebrew font (done automatically when you TAKE HEBREW.INI)
  171.   EFONT   Load the US font (CP437)
  172.   MFONT   Load the Multinational (West European) font (CP850) 
  173.     
  174. And the following function keys are available during terminal emulation
  175. (CONNECT mode):
  176.  
  177.   F5      "Hot key" to enter Hebrew keyboard mode immediately.
  178.   F6      Hot key to enter English keyboard mode immediately.
  179.   F7      Equivalent to DEC VT terminal's F7 key (for use with ALEPH software).
  180.   F9      Select right-to-left screen writing.
  181.   F10     Select left-to-right screen writing.
  182.  
  183. USING MS-DOS KERMIT FOR HEBREW TERMINAL EMULATION
  184.  
  185. The HEBREW.INI file sets Kermit up for an 8-bit connection to hosts and
  186. applications that use the 8-bit ISO Latin/Hebrew character set.  This is the
  187. the international standard Hebrew character set, and the one used by most
  188. host-based applications, such as the ALEPH Hebrew library software.  It is not
  189. the same as the PC Hebrew code page, so Kermit must translate between the two.
  190.  
  191. There are at least two other possibilities, which you must consider if you
  192. access a Hebrew application through Kermit, but the characters look wrong:
  193.  
  194.  . On 7-bit connections, "Hebrew-7" -- a 7-bit character set in which the
  195.    lowercase Roman letters are replaced by Hebrew letters -- is generally
  196.    used.  Hebrew-7 codes are different from Latin/Hebrew and also from CP862.
  197.    Hebrew-7 is commonly used in e-mail, in which it is difficult or impossible
  198.    to transmit 8-bit text.  To use Hebrew-7:
  199.  
  200.      SET TERMINAL CHARACTER-SET HEBREW-7
  201.      SET TERMINAL BYTESIZE 7
  202.   
  203.  . It is possible that some Israeli BBSs use Code Page 862.  In this case,
  204.    tell Kermit not to translate.
  205.  
  206.      SET TERMINAL CHARACTER-SET TRANSPARENT
  207.      SET TERMINAL BYTESIZE 8
  208.    
  209.  . For completeness, here are the commands to use ISO Latin/Hebrew:
  210.  
  211.      SET TERMINAL CHARACTER-SET HEBREW-ISO
  212.      SET TERMINAL BYTESIZE 8
  213.  
  214. Before accessing the host or service, you must also choose the appropriate type
  215. of terminal emulation, one of the following (use the highest model that works):
  216.  
  217.   SET TERMINAL TYPE VT320  (this is the default)
  218.   SET TERMINAL TYPE VT220
  219.   SET TERMINAL TYPE VT102
  220.   SET TERMINAL TYPE VT100
  221.  
  222. From this point, Hebrew-aware software on the remote host or service should be
  223. able to produce correctly formatted screens containing any mixture of English
  224. and Hebrew.
  225.  
  226. ENTERING HEBREW CHARACTERS ON THE KEYBOARD
  227.  
  228. MS-DOS Kermit acts like a Hebrew-model DEC VT terminal.  Like your PC, the VT
  229. terminal has the normal number of keys; it does not have extra keys for Hebrew.
  230. Thus, some keys are "shared" between Roman and Hebrew characters.  To send
  231. Hebrew letters the keyboard must be in "Hebrew mode", and to send lowercase
  232. Roman letters, the keyboard must be in "English mode".  The HEBREW.INI file
  233. supplies you with commands and hot keys to switch modes:
  234.  
  235.                         Command    Hot-Key
  236.    Enter Hebrew mode:    HKEYS       F5
  237.    Enter English mode:   EKEYS       F6
  238.  
  239. Use the commands (HKEYS, EKEYS) when at the "MS-Kermit>" prompt; use the hot
  240. keys (F5, F6) during terminal emulation.  MS-DOS Kermit also allows the host
  241. application to change your keyboard mode automatically by sending escape
  242. sequences (ALEPH does this); see Appendix I at the end of this file.
  243.  
  244. When Hebrew key mappings are in effect and you press any key to which a Hebrew
  245. code is assigned during terminal emulation, Kermit automatically translates
  246. the PC Hebrew code into the appropriate code (HEBREW-ISO or HEBREW-7 or
  247. TRANSPARENT) for the remote application, according to your TERMINAL
  248. CHARACTER-SET.  In other words, you do NOT need different key mappings for
  249. different host Hebrew character sets.
  250.  
  251. HEBREW FILE TRANSFER
  252.  
  253. Hebrew text-file transfer is supported by MS-DOS Kermit, C-Kermit (UNIX, VMS,
  254. OS/2, Stratus VOS, etc), and IBM Mainframe Kermit (VM/CMS, MVS/TSO, CICS).
  255.  
  256. When transferring Hebrew text files between MS-DOS Kermit and a remote
  257. computer or service, use the following commands to ensure that the Hebrew
  258. characters are translated correctly:
  259.  
  260. On the PC:                         On the remote computer:
  261.  
  262.  SET FILE CHARACTER-SET CP862       SET FILE CHARACTER-SET xxx
  263.  SET TRANSFER CHARACTER-SET HEBREW  SET TRANSFER CHARACTER-SET HEBREW
  264.  
  265. xxx is the name of the Hebrew character-set on the remote host, such as
  266. HEBREW-ISO, HEBREW-7, or (only on IBM Mainframes) CP424.  Then send and
  267. receive text files in the normal way.
  268.  
  269. PRINTING
  270.  
  271. All files created on your PC's disk by Kermit will record Hebrew letters in
  272. the IBM PC Hebrew code page, CP862 (provided you have set up the appropriate
  273. translation).  If you have a printer that is capable of printing this
  274. character set, then all the normal printing facilities of DOS and of Kermit
  275. should work as expected:
  276.  
  277.  . The DOS PRINT command.
  278.  . The Print Screen key in DOS or Kermit.
  279.  . etc etc.
  280.  
  281. NOTE: If you have an IBM printer that is capable of code-page switching, then
  282. the Hebrew fonts supplied on the Hebrew disk will probably not print
  283. correctly.  In this case, you will need the real IBM Code Page 862, such as
  284. IBM's HEBEGA.CPI, prepared and loaded according to the instructions on pages
  285. 126-129 of "Using MS-DOS Kermit".
  286.  
  287. If you do NOT have a printer with a Hebrew font built in, then you must use
  288. higher-level software to do the printing.  Reportedly, for example, it is
  289. possible to import a plain-text CP862 file (such as Kermit would create when
  290. you save a screen) into Hebrew WordPerfect and then print it from there.
  291.  
  292. ACCESSING THE ALEPH LIBRARY CATALOG APPLICATION
  293.  
  294. The ALEPH system, in use throughout Israel and also at the Jewish Theological
  295. Seminary of America (JTSA), is designed for use by DEC VT terminals, such as
  296. those emulated by MS-DOS Kermit, and it uses the 8-bit ISO Latin/Hebrew
  297. alphabet.  The HEBREW.INI file sets everything up for you.
  298.  
  299. If your PC is on a TCP/IP network and your MSCUSTOM.INI (MS-DOS Kermit
  300. customization file) is correctly set up for TCP/IP, you can telnet directly
  301. from your PC to an ALEPH host, e.g.:
  302.  
  303.   MS-Kermit> telnet jtsa.edu
  304.              ^^^^^^^^^^^^^^^
  305. If your PC is not on the network, you can dial up with a modem.
  306.  
  307. No matter which way you came in, you should now see the host banner and
  308. login prompt, e.g.:
  309.  
  310.   **********************************************************************
  311.   *           The Jewish Theological Seminary of America               *
  312.   *                         VAX/VMS v.5-4                              *
  313.   **********************************************************************
  314.  
  315.   Username: ALEPH
  316.             ^^^^^
  317. Respond to the "Username:" prompt by typing the word "aleph" and then press
  318. the Enter key.  You won't need a password.  Now you will see a greeting and
  319. menu like this:
  320.  
  321.         Welcome to VAX/VMS version V5.4 on node THEO
  322.     Last interactive login on Tuesday, 8-FEB-1994 18:38
  323.     Last non-interactive login on Sunday,  4-JUL-1993 18:44
  324.  
  325.               Terminal selection  
  326.   Standard (non soft font) terminals: 
  327.    3.  VT102 (Latin only, unless accessed using Israeli ALEPH KERMIT)
  328.    11. VT220 protocol (VT220,VT320,VT340,VT420,V603, etc.
  329.            Latin only, unless terminal has Hebrew chip installed)
  330.  
  331.   Full Latin and SOFT FONT (Hebrew, Arabic, Cyrillic) standard terminals:
  332.    17. VT320 
  333.    18. VT420 
  334.  
  335.   English/Hebrew and SOFT FONT (Arabic, Cyrillic) Israeli Hebrew chip
  336.   terminals:
  337.    27. VT320 
  338.    28. VT420 
  339.  
  340.            Select from menu : 11
  341.                                       ^^
  342. Choose 11 (VT220) from the terminal-type menu.  That's all there is to it.
  343.  
  344. Now you should see an English menu on your screen with Hebrew writing near
  345. the top.  Here's a quick demo:
  346.  
  347. 1. In the menu screen, type "?/HEB" (uppercase, without the quotes) and then
  348.    press the Enter key to switch to Hebrew display mode.  The menu should
  349.    change to all Hebrew, and your keyboard should switch automatically into
  350.    Hebrew mode.
  351.  
  352. 2. Now type "?/ENG" to switch back to English.  Beware: Since the keyboard is
  353.    in Hebrew mode while you are typing this, the slash character (/) is now
  354.    mapped to lowercase "q", so to enter "?/ENG", you must type "?qENG".
  355.    Notice how these characters echo when you type them.  Now you should see a
  356.    help screen whose left side is English and whose right side is Hebrew.
  357.  
  358. 3. Now type "ENG" or "HEB" to select English or Hebrew screens.  The host
  359.    application automatically switches your keyboard to the appropriate mode.
  360.    If you select Hebrew, the Hebrew key mappings go into effect automatically;
  361.    if you select English, the English mappings are made automatically.
  362.  
  363. 4. In an English screen, search for (say) authors named Singer by typing:
  364.  
  365.       AU/Singer
  366.  
  367.    In a Hebrew screen type the Hebrew author-search command, Mem-Chet-slash
  368.    (njq) and the author's name in Hebrew, for example "zhbdr" (= Zade Yod Nun
  369.    Gimel Resh = Zinger):
  370.  
  371.       njqzhbdr
  372.  
  373. 5. To capture a screen, hold down the Ctrl key and press the End key on the
  374.    numeric keypad.  This copies text on the screen to a file on your disk
  375.    called KERMIT.SCN.  If you do this more than once, it will keep adding new
  376.    screens to the end of the KERMIT.SCN file, separating each one by a
  377.    Formfeed.
  378.    
  379. To get back to the main menu at any time, press the PC's F7 key.
  380.  
  381. To leave ALEPH, type the word "STOP" (without the quotes) and then press the
  382. Enter key.
  383.  
  384. Some Hebrew library catalogs that use the ALEPH software are:
  385.  
  386.   Central ALEPH Computer          Telnet RAM2.HUJI.AC.IL or 128.139.4.207
  387.   Bar-Ilan University             Telnet ALEPH.BIU.AC.IL or 132.70.9.36
  388.   Ben-Gurion University           Telnet BGULIB.BGU.AC.IL
  389.   Haifa University                Telnet LIB.HAIFA.AC.IL or 132.74.1.100
  390.   Hebrew University               Telnet ALEPH.HUJI.AC.IL or 128.139.4.207
  391.   Jewish Theological Seminary     Telnet JTSA.EDU
  392.   Technion                        Telnet LIB.TECHNION.AC.IL or 132.68.1.20
  393.   Tel Aviv University             Telnet TAUVAX.TAU.AC.IL or 132.66.32.6
  394.   Weizmann Institute of Science   Telnet WISLIB.WEIZMANN.AC.IL or 132.76.64.14
  395.  
  396. In all cases, the username to use is ALEPH and no password is required,
  397. and in all cases you should choose "11" from the terminal-type menu.
  398.  
  399. Also, please note that references to "Hebrew-University Kermit" are obsolete,
  400. as are the instructions for using it.  All the work done at Hebrew University
  401. was incorporated into MS-DOS Kermit 3.13, and upgraded to a higher level of
  402. functionality.  Please ignore the instructions about special MSKERMIT.INI
  403. files, VT102 emulation, Terminal Type 3, etc.
  404.  
  405. USING KERMIT'S HEBREW FEATURES IN NON-HEBREW APPLICATIONS
  406.  
  407. You can use Kermit's Hebrew features to create or view plain-text documents on
  408. a CUNIX or other host computer written in Hebrew (or Yiddish?) (or Ladino?)
  409. if you keep the following points in mind:
  410.  
  411.  . Hebrew characters are restricted to the basic set of 22 letters and
  412.    5 final forms.
  413.  
  414.  . Hebrew characters are stored and transmitted "left to right", even though
  415.    they should be displayed right to left.
  416.  
  417.  . You can't mix Roman and Hebrew text in a plain-text file unless you are
  418.    willing to type the Hebrew letters in reverse order (or vice-versa,
  419.    depending on how the text is to be displayed).  That's because
  420.    non-Hebrew-aware software is not equipped to handle bidirectional text.
  421.  
  422. If you are using Kermit to create or read Hebrew text on a computer that does
  423. not have Hebrew-aware software, you can tell Kermit to reverse its
  424. screen-writing direction to force characters to be written right-to-left:
  425.  
  426.   SET TERMINAL DIRECTION RIGHT-TO-LEFT
  427.  
  428. And, of course, you can also undo this effect:
  429.  
  430.   SET TERMINAL DIRECTION LEFT-TO-RIGHT
  431.  
  432. The HEBREW.INI file assigns these functions to F9 and F10, respectively, so
  433. you can conveniently switch direction during terminal emulation.
  434.  
  435. If your connection to the host application is "8-bit clean", AND the
  436. application itself is also 8-bit clean, you can use the ISO 8859-8
  437. Latin/Hebrew Alphabet, which contains full upper and lowercase Roman, plus
  438. Hebrew, plus a variety of symbols.  Unfortunately, very few host applications
  439. are 8-bit clean (except on VMS -- such as ALEPH and HEDT).
  440.  
  441. EXAMPLE: Creating a Hebrew text file with the VMS EVE (EDIT/TPU) editor:
  442.  
  443.   1. Type "hebrew" at the MS-Kermit> prompt.
  444.   2. Log in to the VAX.
  445.   3. EDIT/TPU <filename>.
  446.   4. Push F5 to enter Hebrew keyboard mode.
  447.   5. Push F9 to select right-to-left screen writing.
  448.   6. Create/edit the file in the normal way.  All the English
  449.      will be displayed backwards, but the Hebrew will look right.
  450.  
  451. IN THE 7-BIT ENVIRONMENT, you'll have to use the Hebrew-7 character set,
  452. in which lowercase Roman letters are replaced by Hebrew letters; thus
  453. only uppercase Roman letters are available.  For example, to send a Hebrew
  454. e-mail message with (English) Pine:
  455.  
  456.   1. Access and log in to CUNIX (don't put Kermit into Hebrew mode yet).
  457.   2. Start Pine and select COMPOSE MESSAGE.
  458.   3. Fill out the To: and Subject: fields of the message using Roman letters.
  459.   4. Move to the message body using the down-arrow or Enter key.
  460.   5. Press the F5 key to enter Hebrew keyboard mode.
  461.   6. Use Alt-x to return to the MS-Kermit> prompt and enter the following
  462.      commands:
  463.      
  464.        hebrew
  465.        set terminal character-set hebrew-7
  466.        set terminal bytesize 7
  467.        connect
  468.  
  469.      Remember: you can abbreviate Kermit commands and keywords (but not
  470.      filenames) to their minimum unique length.  So the above commands could
  471.      also be entered as:
  472.  
  473.        hebrew
  474.        set ter ch hebrew-7
  475.        set ter by 7
  476.        c
  477.  
  478.   7. Push F9 to select right-to-left screen writing.
  479.   8. Type Ctrl-L (hold down Ctrl and press the L key) to refresh the screen.
  480.   9. Enter Hebrew text into the message body, referring to the keyboard map.
  481.      If you must type numbers, enter the digits in reverse order.  If you must
  482.      type English text, enter the letters in UPPER CASE and in reverse order.
  483.  10. To send the message, type Ctrl-X (hold down Ctrl, press X).
  484.  11. To return to English mode, press F6 and F10, then Ctrl-L to refresh
  485.      the screen.
  486.  12. Enter Q to quit from Pine.
  487.  
  488. The person who receives your message must, of course, also be set up for the
  489. Hebrew-7 character set and right-to-left display.  Remember that when the
  490. keyboard is in Hebrew mode, all Roman letters must be entered in UPPER CASE.
  491. This includes (of course) Pine commands.
  492.  
  493. OTHER HOST-BASED HEBREW APPLICATIONS   
  494.  
  495. There is a version of the text editor EMACS, developed in Japan, called MULE
  496. (MUltiLingual EMACS), which is capable of handling Hebrew (as well as almost
  497. any other script in the world), fully accomodating mixed Hebrew and Roman (or
  498. other) scripts, and (reportedly) handling bidirectionality correctly.  It
  499. works best with X terminals, but might also work in Hebrew mode with PCs
  500. running Kermit.
  501.  
  502. There is a Hebrew version of the UNIX VI text editor, called vi.iv, from
  503. the Technion in Haifa.
  504.  
  505. Hebrew Pine and Pico are available from Hebrew University, horizon.huji.ac.il.
  506.  
  507. HEDT is a product of DEC Israel.
  508.  
  509. EPILOG
  510.  
  511. Because Hebrew text is intrinsically bidirectional (since, for example,
  512. numbers are written left-to-right, and Roman or other types of left-to-right
  513. text are often mixed in), no "plain-text" standard for Hebrew has ever
  514. emerged.  Hebrew text can only be handled on a "higher" level, e.g. by
  515. applications such as the JTSA catalog, Hebrew WordPerfect, and so on.
  516.  
  517. Unfortunately, but not surprisingly, these higher-level applications are
  518. incompatible with each other, using different character sets and different
  519. methods for indicating and controlling directionality, not to mention other
  520. rendering and representation issues (Macintosh vs PC, font selection and
  521. style, boldface, italic, etc etc).  Thus, widespread system- and application-
  522. independent interchange of Hebrew text has never been achieved.  Informants in
  523. Israel tell me, for example, that Hebrew simply is not used in e-mail;
  524. everybody gets by with English.
  525.  
  526. The situation with Arabic is similar, but not identical.
  527.  
  528. The situation with other non-Roman alphabetic scripts, such as Cyrillic and
  529. Greek, is far better.  These scripts can be handled very easily by a simple
  530. font change, and mixtures of Cyrillic and Roman or Greek and Roman letters in
  531. a plain text file poses no problems at all.  Similar comments apply to other
  532. left-to-right alphabetic scripts such as Armenian, Georgian, etc.
  533.  
  534. In the future, there will be a universal coded character set, ISO 10646,
  535. capable of representing all of the world's scripts in a single coding system,
  536. including both modern and ancient scripts.  Presently, ISO 10646 includes only
  537. the basic Hebrew repertoire of 22 letters plus 5 final forms.  An extension to
  538. this standard, proposed by the Israel Institute for Standards, will add vowel
  539. points, cantillation marks, and possibly also unique Hebrew forms of
  540. punctuation as well as Yiddish digraphs.  ISO 10646 (and its precursor,
  541. Unicode, which is in most part a compatible subset of ISO 10646) will allow
  542. text to contain any mixture of scripts.  But massive changes in software,
  543. data, as well as in display, printing, and data entry devices will be
  544. required, so only time will tell if ISO 10646 will achieve widespread use.
  545.  
  546. APPENDIX I - THE HEBREW KEY MAP
  547.  
  548. (Note: Names of Hebrew letters are from the ISO 8859-8 Standard.)
  549.  
  550. Hebrew Order             Roman Order              QWERTY Keyboard Order        
  551.  
  552.   q = Slash                , = Taw             q = Slash 
  553.   w = Apostrophe           . = Terminal Zade        w = Apostrophe 
  554.   ' = Comma                ' = Comma                e = Qoph 
  555.   / = Period               / = Period               r = Resh 
  556.   t = Aleph                ; = Terminal Pe          t = Aleph 
  557.   c = Bet                  a = Shin                 y = Tet 
  558.   d = Gimel                b = Nun                  u = Waw 
  559.   s = Dalet                c = Bet                  i = Terminal Nun 
  560.   v = He                   d = Gimel                o = Terminal Mem 
  561.   u = Waw                  e = Qoph                 p = Pe 
  562.   z = Zain                 f = Kaph                 a = Shin 
  563.   j = Chet                 g = Ayin                 s = Dalet 
  564.   y = Tet                  h = Yod                  d = Gimel 
  565.   h = Yod                  i = Terminal Nun         f = Kaph 
  566.   l = Terminal Kaph        j = Chet                 g = Ayin 
  567.   f = Kaph                 k = Lamed                h = Yod 
  568.   k = Lamed                l = Terminal Kaph        j = Chet 
  569.   o = Terminal Mem         m = Zade                 k = Lamed 
  570.   n = Mem                  n = Mem                  l = Terminal Kaph 
  571.   i = Terminal Nun         o = Terminal Mem         ; = Terminal Pe 
  572.   b = Nun                  p = Pe                   ' = Comma 
  573.   x = Samech               q = Slash                z = Zain 
  574.   g = Ayin                 r = Resh                 x = Samech 
  575.   ; = Terminal Pe          s = Dalet                c = Bet 
  576.   p = Pe                   t = Aleph                v = He 
  577.   . = Terminal Zade        u = Waw                  b = Nun 
  578.   m = Zade                 v = He                   n = Mem 
  579.   e = Qoph                 w = Apostrophe           m = Zade 
  580.   r = Resh                 x = Samech               , = Taw 
  581.   a = Shin                 y = Tet                  . = Terminal Zade 
  582.   , = Taw                  z = Zain                 / = Period 
  583.  
  584. If you have a PostScript printer, you can get a picture of the key map
  585. by printing the KEYMAP.PS file from the KERMIT\HEBREW directory.
  586.  
  587. APPENDIX II - Technical Summary
  588.  
  589. Hebrew terminal emulation and file transfer (version 3.13).  Commands:
  590.  
  591.   SET TRANSFER CHARACTER-SET HEBREW
  592.   SET FILE CHARACTER-SET CP862
  593.   SET TERMINAL CHARACTER-SET { HEBREW-ISO, HEBREW-7 }
  594.   SET TERMINAL DIRECTION { RIGHT-TO-LEFT, LEFT-TO-RIGHT }
  595.   SET TERMINAL CODE-PAGE CP862
  596.  
  597. Terminal direction is controlled in two different ways: (1) by host-generated
  598. escape sequences (automatic, see below) and (2) by the SET TERMINAL DIRECTION
  599. command.  When the writing direction is changed by escape sequences from the
  600. host, the cursor-positioning coordinate system is not changed.  For example,
  601. if Kermit was in left-to-right mode and the host send ESC [ ? 34 h, position
  602. (1,1) would still be in the upper left.  This is how a real Hebrew-model VT
  603. terminal works.  If, however, you command Kermit into RIGHT-TO-LEFT mode, the
  604. coordinate system flips right to left so the origin (1,1) is at the upper
  605. right corner, which is useful for viewing and composing some right to left
  606. text. The host can override the user setting, and the user can later override
  607. the host setting.
  608.  
  609. Hebrew character sets:
  610.  
  611.  . CP862 is the PC Hebrew code page, available from IBM as EGAHE.COM, or
  612.    perhaps as a hardware code page on Hebrew-model PCs.  Distributed on the
  613.    the Kermit diskette in a public-domain form as CP862.F16, to be used with
  614.    the (also public-domain) LOADFONT program.
  615.  
  616.  . HEBREW-ISO is the 8-bit standard ISO 8859-8 Latin/Hebrew alphabet.
  617.  
  618.  . HEBREW-7 is the 7-bit Hebrew "National Replacement Character Set" (NRC),
  619.    ASCII with the lowercase Roman letters replaced by Hebrew letters,
  620.    often used in e-mail.
  621.  
  622. MS-DOS Kermit 3.13 supports:
  623.  
  624.  . Automatic selection of writing direction by host escape sequence.
  625.  . ISO 2022-compliant terminal character-set designation and invocation.
  626.  . Hebrew keyboard mode.
  627.  
  628. Hebrew-specific escape sequences recognized by the VT220 and 320 terminal
  629. emulators: 
  630.  
  631.   ESC ) H        Designates right half of Latin/Hebrew to G1   
  632.   ESC * H        Designates right half of Latin/Hebrew to G2   
  633.   ESC + H        Designates right half of Latin/Hebrew to G3   
  634.   ESC ( % =        Designates 7-bit Hebrew NRC to G0-G3          
  635.   ESC ) " 4        Designates DEC supplement Hebrew letters to G1
  636.   ESC * " 4        Designates DEC supplement Hebrew letters to G2
  637.   ESC + " 4        Designates DEC supplement Hebrew letters to G3
  638.   DCS 0 ! u " 4 ST    Assigns DEC supplement Hebrew as UPSS
  639.   DCS 0 ! u H ST    Assigns Latin/Hebrew as UPSS
  640.   CSI ? 34 h        Sets right-to-left screen-writing mode
  641.   CSI ? 34 l        Sets left-to-right screen-writing mode
  642.   CSI ? 35 h        Sets Hebrew keyboard mapping via Kermit macros
  643.   CSI ? 35 l        Sets Roman (North American) keyboard mapping, ditto
  644.   CSI ? 36 h        Hebrew encoding mode: 7-bit Hebrew-7 "National mode"
  645.   CSI ? 36 l        Hebrew encoding mode: 8-bit ISO Latin/Hebrew
  646.  
  647. Hebrew keyboard mapping:
  648.  
  649.  . CSI ? 35 h invokes the macro KEYBOARDS, which you must define to set up
  650.    your keyboard for entering Hebrew characters.  If this macro is not
  651.    defined, nothing happens.
  652.  
  653.  . CSI ? 35 l invokes the macro KEYBOARDR, which you must define to set up
  654.    your keyboard for entering Roman (North American) characters.  If this
  655.    macro is not defined, nothing happens.
  656.  
  657.      NOTE: do not define KEYBOARDS without also defining KEYBOARDR
  658.      to undo its effects!
  659.  
  660. The various reports furnished by MS-DOS Kermit also include Hebrew-specific
  661. information, and the following host-initiated operations work in both left-
  662. to-right and right-to-left mode: Insert/Replace Mode, Autowrap, Backspace,
  663. Carriage Return, Linefeed, Formfeed, Vertical Tab, Horizontal Tab.
  664.  
  665. The keyboard mapping sequences invoke the user-defined macros KEYBOARDS (h)
  666. and KEYBOARDR (l).  Users should define these macros to accomplish the desired
  667. keyboard mappings with SET KEY commands.  Sample mappings (those used with
  668. Hebrew WordPerfect, etc) are supplied in the HEBREW.INI file.
  669.  
  670. In VT100 and VT102 mode, the following functions are supported:
  671.  
  672.   ESC ) 1        Enter Hebrew mode
  673.   ESC ) B        Exit Hebrew mode
  674.  
  675. FURTHER READING 
  676.  
  677. 1. Your MS-DOS manual, the sections on code pages.  For example, Microsoft 
  678.    MS-DOS Operating System Version 5.0 User's Guide and Reference (1992), 
  679.    Chapter 13 and the Appendix, "Keyboard Layouts and Code Pages". 
  680.  
  681. 2. Gianone, Christine M., "Using MS-DOS Kermit", Digital Press (1992), 
  682.    Chapter 13, "International Character Sets".  Also, for TCP/IP setup, 
  683.    Chapter 16, "Kermit on Local Area Networks". 
  684.  
  685. 3. The files KERMIT.UPD and HEBREW\HEBREW.HLP on the MS-DOS 3.13 diskette.
  686.  
  687. 4. The Hebrew character-set tables in the HEBREW directory, and the PC
  688.    font material in the PCFONTS directory.
  689.  
  690. 5. The Unicode Standard, Worldwide Character Encoding, Version 1.0, Volume 1, 
  691.    The Unicode Consortium.  Addison-Wesley (1991). 
  692.  
  693. (End of HEBREW.DOC) 
  694.