annotate runtime/doc/rileft.txt @ 684:a8caf7dd853d v7.0205

updated for version 7.0205
author vimboss
date Thu, 23 Feb 2006 21:34:44 +0000
parents 4707450c2b33
children 6beb2c667935
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 7
diff changeset
1 *rileft.txt* For Vim version 7.0aa. Last change: 2005 Apr 04
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Avner Lottem
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 updated by Nadim Shaikli
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 Right to Left display mode for Vim *rileft*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 These functions were originally created by Avner Lottem:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 E-mail: alottem@iil.intel.com
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 Phone: +972-4-8307322
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 {Vi does not have any of these commands}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 *E26*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 This feature is only available when the |+rightleft| feature was enabled
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 at compile time.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 Introduction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 ------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 Some languages such as Arabic, Farsi, Hebrew (among others) require the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 ability to display their text from right-to-left. Files in those languages
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 are stored conventionally and the right-to-left requirement is only a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 function of the display engine (per the Unicode specification). In
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 right-to-left oriented files the characters appear on the screen from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 right to left.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 Bidirectionality (or bidi for short) is what Unicode offers as a full
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 solution to these languages. Bidi offers the user the ability to view
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 both right-to-left as well as left-to-right text properly at the same time
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 within the same window. Vim currently, due to simplicity, does not offer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 bidi and is merely opting to present a functional means to display/enter/use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 right-to-left languages. An older hybrid solution in which direction is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 encoded for every character (or group of characters) are not supported either
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 as this kind of support is out of the scope of a simple addition to an
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 7
diff changeset
39 existing editor (and it's not sanctioned by Unicode either).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 Highlights
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 ----------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 o Editing left-to-right files as in the original Vim, no change.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 o Viewing and editing files in right-to-left windows. File orientation
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 is per window, so it is possible to view the same file in right-to-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 and left-to-right modes, simultaneously. (Useful for editing mixed files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 in which both right-to-left and left-to-right text exist).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 o Compatibility to the original Vim. Almost all features work in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 right-to-left mode (see Bugs below).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 o Backing from reverse insert mode to the correct place in the file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 (if possible).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 o No special terminal with right-to-left capabilities is required. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 right-to-left changes are completely hardware independent.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 o Many languages use and require right-to-left support. These languages
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 can quite easily be supported given the inclusion of their required
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 keyboard mappings and some possible minor code change. Some of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 current supported languages include - |arabic.txt|, |farsi.txt| and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 |hebrew.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 Of Interest...
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 --------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 o Invocations
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 -----------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 + 'rightleft' ('rl') sets window orientation to right-to-left.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 + 'delcombine' ('deco'), boolean, if editing UTF-8 encoded languages,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 allows one to remove a composing character which gets superimposed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 on those that proceeded them (some languages require this).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 + 'rightleftcmd' ('rlc') sets the command-line within certain modes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 (such as search) to be utilized in right-to-left orientation as well.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 o Typing backwards *ins-reverse*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 ----------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 In lieu of using full-fledged the 'rightleft' option, one can opt for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 reverse insertion. When the 'revins' (reverse insert) option is set,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 inserting happens backwards. This can be used to type right-to-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 text. When inserting characters the cursor is not moved and the text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 moves rightwards. A <BS> deletes the character under the cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 CTRL-W and CTRL-U also work in the opposite direction. <BS>, CTRL-W
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 and CTRL-U do not stop at the start of insert or end of line, no matter
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 how the 'backspace' option is set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 There is no reverse replace mode (yet).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 If the 'showmode' option is set, "-- REVERSE INSERT --" will be shown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 in the status line when reverse Insert mode is active.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 o Pasting when in a rightleft window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 ----------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 When cutting text with the mouse and pasting it in a rightleft window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 the text will be reversed, because the characters come from the cut buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 from the left to the right, while inserted in the file from the right to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 the left. In order to avoid it, toggle 'revins' before pasting.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 Bugs
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 ----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 o Does not handle CTRL-A and CTRL-X commands (add and subtract) correctly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 when in rightleft window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 o Does not support reverse insert and rightleft modes on the command-line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 However, functionality of the editor is not reduced, because it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 possible to enter mappings, abbreviations and searches typed from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 left to the right on the command-line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 o Somewhat slower in right-to-left mode, because right-to-left motion is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 emulated inside Vim, not by the controlling terminal.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 o When the Athena GUI is used, the bottom scrollbar works in the wrong
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 direction. This is difficult to fix.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 o When both 'rightleft' and 'revins' are on: 'textwidth' does not work.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 Lines do not wrap at all; you just get a single, long line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 o There is no full bidirectionality (bidi) support.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 vim:tw=78:ts=8:ft=help:norl: