rightleft.txt

MSYS在windows下模拟了一个类unix的终端

*rightleft.txt* For Vim version 5.8.  Last change: 1999 Jun 14


		  VIM REFERENCE MANUAL    by Avner Lottem


Right to Left and Hebrew Mapping for Vim		*hebrew*


These functions have been made by Avner Lottem
E-mail: <[e-mail]>
Phone:  [phone]

{Vi does not have any of these commands}

All this is only available when the |+rightleft| feature was enabled at
compile time.


Introduction
------------
In right-to-left oriented files the characters appear on the screen from right
to left.  This kind of file is most useful when writing Hebrew documents using
TeX--XeT, troffh, composing faxes or writing Hebrew memos.

Logical order files, where direction is encoded for every character (or group
of characters) are not supported as this kind of support is out of the scope
of a simple addition to an existing editor.  Also, no Hebrew commands, prompts
and help files were added, the standard Vi interface was maintained.  The
intention here was to incorporate Hebrew support to an existing modern and
live editor, hoping that the Hebrew support will continue to live in
subsequent versions.  Many other Hebrew supported packages were designed for a
particular version of the original (English) software and when it continued
developing, the Hebrew version stayed behind.  Therefore this particular
support to Vim tries to be as simple (and short) as possible, so that it could
be incorporated into the official source.


Highlights
----------
o  Editing left-to-right files as in the original Vim, no change.

o  Viewing and editing files in right-to-left windows.   File orientation
   is per window, so it is possible to view the same file in right-to-left
   and left-to-right modes, simultaneously.
   (This is sometimes useful when editing documents with TeX--XeT.)

o  Compatibility to the original Vim.   Almost all features work in
   right-to-left mode (see Bugs below).

o  Changing keyboard mapping and reverse insert modes using a single
   command.

o  Backing from reverse insert mode to the correct place in the file
   (if possible).

o  No special terminal with right-to-left capabilities is required.  The
   right-to-left changes are completely hardware independent.  Only
   Hebrew font is necessary.

   The MIT X distribution includes at least two fonts: heb6x13 and heb8x13.
   Some fonts are on
	http://sunsite.unc.edu/pub/Linux/X11/fonts/hebxfonts-0.2.tgz
   More pointers are in the Hebrew HOWTO on
	http://sunsite.unc.edu/pub/Linux/docs/HOWTO
   To create a Hebrew font for a DOS box under MS-Windows, refer to a hack on
   ftp://tochna.technion.ac.il/pub/staff/lottem/doswin-0.1.tgz.

o  It should be quite easy to adjust this support to handle other right-to
   left languages, such as Arabic, by simply changing the keyboard mapping
   according to the character encoding.


Change details
--------------
+  Options:
   +  'rightleft' ('rl') sets window orientation to right-to-left.
   +  'hkmap' ('hk') sets keyboard mapping to Hebrew, in insert/replace modes.
   +  'aleph' ('al'), numeric, holds the decimal code of Aleph, for keyboard
      mapping.

+  Encoding:
   +  Under Unix, ISO 8859-8 encoding (Hebrew letters codes: 224-250).
   +  Under MS DOS, PC encoding (Hebrew letters codes: 128-154).
   These are defaults, that can be overridden using the 'aleph' option.

+  Vim arguments:
   +  'vim -H file' starts editing a Hebrew file, i.e. 'rightleft' and 'hkmap'
      are set.

+  Keyboard:
   +  The 'allowrevins' option enables the CTRL-_ command in Insert mode and
      in Command-line mode.

   +  CTRL-_ in insert/replace modes toggles 'revins' and 'hkmap' as follows:

      When in rightleft window, 'revins' and 'nohkmap' are toggled, since
      English will likely be inserted in this case.

      When in norightleft window, 'revins' 'hkmap' are toggled, since Hebrew
      will likely be inserted in this case.

      CTRL-_ moves the cursor to the end of the typed text.

   +  CTRL-_ in command mode only toggles keyboard mapping (see Bugs below).
      This setting is independent of 'hkmap' option, which only applies to
      insert/replace mode.

      Note: On some keyboards, CTRL-_ is mapped to CTRL-?.

   +  Keyboard mapping while 'hkmap' is set:

	q w e r t y u i o p		The characters in the mapping shown
	/ '