Na}{

Path: ~//proc/self/root/usr/share/vim/vim81/doc/

File Content: `rileft.txt`

*rileft.txt*    For Vim version 8.1.  Last change: 2019 May 05


		  VIM REFERENCE MANUAL    by Avner Lottem
					  updated by Nadim Shaikli


Right to Left display mode for Vim				*rileft*


These functions were originally created by Avner Lottem:
   E-mail: alottem@iil.intel.com
   Phone:  +972-4-8307322

								*E26*
{only available when compiled with the |+rightleft| feature}


Introduction
------------
Some languages such as Arabic, Farsi, Hebrew (among others) require the
ability to display their text from right-to-left.  Files in those languages
are stored conventionally and the right-to-left requirement is only a
function of the display engine (per the Unicode specification).  In
right-to-left oriented files the characters appear on the screen from
right to left.

Bidirectionality (or bidi for short) is what Unicode offers as a full
solution to these languages.  Bidi offers the user the ability to view
both right-to-left as well as left-to-right text properly at the same time
within the same window.  Vim currently, due to simplicity, does not offer
bidi and is merely opting to present a functional means to display/enter/use
right-to-left languages.  An older hybrid solution in which direction is
encoded for every character (or group of characters) are not supported either
as this kind of support is out of the scope of a simple addition to an
existing editor (and it's not sanctioned by Unicode either).


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.  (Useful for editing mixed files
   in which both right-to-left and left-to-right text exist).

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

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.

o  Many languages use and require right-to-left support.  These languages
   can quite easily be supported given the inclusion of their required
   keyboard mappings and some possible minor code change.  Some of the
   current supported languages include - |arabic.txt|, |farsi.txt| and
   |hebrew.txt|.


Of Interest...
--------------

o  Invocations
   -----------
   + 'rightleft' ('rl') sets window orientation to right-to-left.
   + 'delcombine' ('deco'), boolean, if editing UTF-8 encoded languages,
     allows one to remove a composing character which gets superimposed
     on those that proceeded them (some languages require this).
   + 'rightleftcmd' ('rlc') sets the command-line within certain modes
     (such as search) to be utilized in right-to-left orientation as well.

o  Typing backwards					*ins-reverse*
   ----------------
   In lieu of using full-fledged the 'rightleft' option, one can opt for
   reverse insertion.  When the 'revins' (reverse insert) option is set,
   inserting happens backwards.  This can be used to type right-to-left
   text.  When inserting characters the cursor is not moved and the text
   moves rightwards.  A <BS> deletes the character under the cursor.
   CTRL-W and CTRL-U also work in the opposite direction.  <BS>, CTRL-W
   and CTRL-U do not stop at the start of insert or end of line, no matter
   how the 'backspace' option is set.

   There is no reverse replace mode (yet).

   If the 'showmode' option is set, "-- REVERSE INSERT --" will be shown
   in the status line when reverse Insert mode is active.

o  Pasting when in a rightleft window
   ----------------------------------
   When cutting text with the mouse and pasting it in a rightleft window
   the text will be reversed, because the characters come from the cut buffer
   from the left to the right, while inserted in the file from the right to
   the left.   In order to avoid it, toggle 'revins' before pasting.


Bugs
----
o  Does not handle CTRL-A and CTRL-X commands (add and subtract) correctly
   when in rightleft window.

o  Does not support reverse insert and rightleft modes on the command-line.
   However, functionality of the editor is not reduced, because it is
   possible to enter mappings, abbreviations and searches typed from the
   left to the right on the command-line.

o  Somewhat slower in right-to-left mode, because right-to-left motion is
   emulated inside Vim, not by the controlling terminal.

o  When the Athena GUI is used, the bottom scrollbar works in the wrong
   direction.  This is difficult to fix.

o  When both 'rightleft' and 'revins' are on: 'textwidth' does not work.
   Lines do not wrap at all; you just get a single, long line.

o  There is no full bidirectionality (bidi) support.


 vim:tw=78:ts=8:noet:ft=help:norl:

Edit Rename Chmod Delete

FILE FOLDER INFO

Name	Size	Permission
README.Debian	324 bytes	0644
arabic.txt	11900 bytes	0644
autocmd.txt	69821 bytes	0644
change.txt	76688 bytes	0644
channel.txt	48550 bytes	0644
cmdline.txt	48010 bytes	0644
debug.txt	6896 bytes	0644
debugger.txt	5879 bytes	0644
develop.txt	22694 bytes	0644
diff.txt	16820 bytes	0644
digraph.txt	61879 bytes	0644
editing.txt	73069 bytes	0644
eval.txt	492432 bytes	0644
farsi.txt	523 bytes	0644
filetype.txt	27251 bytes	0644
fold.txt	23689 bytes	0644
ft_ada.txt	18246 bytes	0644
ft_rust.txt	9596 bytes	0644
ft_sql.txt	30699 bytes	0644
gui.txt	52135 bytes	0644
gui_w32.txt	19365 bytes	0644
gui_x11.txt	29773 bytes	0644
hangulin.txt	3296 bytes	0644
hebrew.txt	5666 bytes	0644
help.txt	8894 bytes	0644
help.txt.vim-tiny	1431 bytes	0644
helphelp.txt	14432 bytes	0644
howto.txt	2916 bytes	0644
if_cscop.txt	19325 bytes	0644
if_lua.txt	15596 bytes	0644
if_mzsch.txt	11963 bytes	0644
if_ole.txt	7362 bytes	0644
if_perl.txt	11273 bytes	0644
if_pyth.txt	38336 bytes	0644
if_ruby.txt	8534 bytes	0644
if_sniff.txt	271 bytes	0644
if_tcl.txt	22968 bytes	0644
indent.txt	41698 bytes	0644
index.txt	79569 bytes	0644
insert.txt	84303 bytes	0644
intro.txt	38846 bytes	0644
map.txt	66344 bytes	0644
mbyte.txt	59650 bytes	0644
message.txt	31228 bytes	0644
mlang.txt	7867 bytes	0644
motion.txt	51086 bytes	0644
netbeans.txt	37573 bytes	0644
options.txt	387455 bytes	0644
os_390.txt	4750 bytes	0644
os_amiga.txt	5466 bytes	0644
os_beos.txt	10988 bytes	0644
os_dos.txt	12026 bytes	0644
os_mac.txt	6856 bytes	0644
os_mint.txt	1407 bytes	0644
os_msdos.txt	523 bytes	0644
os_os2.txt	299 bytes	0644
os_qnx.txt	4071 bytes	0644
os_risc.txt	328 bytes	0644
os_unix.txt	2600 bytes	0644
os_vms.txt	32551 bytes	0644
os_win32.txt	13352 bytes	0644
pattern.txt	59685 bytes	0644
pi_getscript.txt	21083 bytes	0644
pi_gzip.txt	1294 bytes	0644
pi_logipat.txt	4191 bytes	0644
pi_netrw.txt	176566 bytes	0644
pi_paren.txt	2274 bytes	0644
pi_spec.txt	4127 bytes	0644
pi_tar.txt	6662 bytes	0644
pi_vimball.txt	11858 bytes	0644
pi_zip.txt	7040 bytes	0644
popup.txt	36537 bytes	0644
print.txt	31207 bytes	0644
quickfix.txt	79082 bytes	0644
quickref.txt	71981 bytes	0644
quotes.txt	12748 bytes	0644
recover.txt	10705 bytes	0644
remote.txt	8417 bytes	0644
repeat.txt	41020 bytes	0644
rileft.txt	4939 bytes	0644
russian.txt	3024 bytes	0644
scroll.txt	13781 bytes	0644
sign.txt	24920 bytes	0644
spell.txt	63877 bytes	0644
sponsor.txt	7203 bytes	0644
starting.txt	73296 bytes	0644
syntax.txt	221438 bytes	0644
tabpage.txt	16897 bytes	0644
tags	345417 bytes	0644
tags.vim-tiny	30 bytes	0644
tagsrch.txt	39135 bytes	0644
term.txt	46907 bytes	0644
terminal.txt	53712 bytes	0644
testing.txt	12929 bytes	0644
textprop.txt	13870 bytes	0644
tips.txt	20278 bytes	0644
todo.txt	308789 bytes	0644
uganda.txt	14029 bytes	0644
undo.txt	16585 bytes	0644
usr_01.txt	7095 bytes	0644
usr_02.txt	24344 bytes	0644
usr_03.txt	23610 bytes	0644
usr_04.txt	19087 bytes	0644
usr_05.txt	27058 bytes	0644
usr_06.txt	9611 bytes	0644
usr_07.txt	15989 bytes	0644
usr_08.txt	19379 bytes	0644
usr_09.txt	11502 bytes	0644
usr_10.txt	29185 bytes	0644
usr_11.txt	12924 bytes	0644
usr_12.txt	13429 bytes	0644
usr_20.txt	13708 bytes	0644
usr_21.txt	18456 bytes	0644
usr_22.txt	15000 bytes	0644
usr_23.txt	12705 bytes	0644
usr_24.txt	20874 bytes	0644
usr_25.txt	19176 bytes	0644
usr_26.txt	8259 bytes	0644
usr_27.txt	17722 bytes	0644
usr_28.txt	16020 bytes	0644
usr_29.txt	20121 bytes	0644
usr_30.txt	22661 bytes	0644
usr_31.txt	10399 bytes	0644
usr_32.txt	5378 bytes	0644
usr_40.txt	23189 bytes	0644
usr_41.txt	93419 bytes	0644
usr_42.txt	13854 bytes	0644
usr_43.txt	7409 bytes	0644
usr_44.txt	29216 bytes	0644
usr_45.txt	17650 bytes	0644
usr_90.txt	17580 bytes	0644
usr_toc.txt	9264 bytes	0644
various.txt	30327 bytes	0644
version4.txt	13911 bytes	0644
version5.txt	308541 bytes	0644
version6.txt	577055 bytes	0644
version7.txt	674772 bytes	0644
version8.txt	1323626 bytes	0644
vi_diff.txt	57621 bytes	0644
vim2html.pl	4517 bytes	0755
visual.txt	21775 bytes	0644
windows.txt	54925 bytes	0644
workshop.txt	371 bytes	0644

File Content: rileft.txt

File Content: `rileft.txt`