regex: fix rinst struct field comment
[neatvi.git] / README
blob03e9ffd45a0bdc6c3916c10c730a16552efc6987
1 NEATVI
2 ======
4 Neatvi is a vi/ex editor.  It can edit bidirectional UTF-8 text.
6 CONFIGURATION
7 -------------
9 Edit conf.h to adjust syntax highlighting rules and text direction
10 patterns.  To define a new keymap, create a new array in kmap.h, like
11 kmap_fa, and add it to kmaps array in the same header (the first entry
12 of the new array specifies its name).  The current keymap may be
13 changed with :cm ex command.  When in input mode, ^e activates the
14 English kaymap and ^f switches to the alternate keymap (the last
15 keymap specified with :cm).
17 COMMANDS
18 --------
20 Commands not available in ex(1):
22 :cm[ap][!] [kmap]
23   Without kmap, print the current keymap name.
24   When kmap is specified, set the alternate keymap to
25   kmap and, unless ! is given, switch to this keymap.
26 :ft [filetype]
27   Without filetype, print the current file type.
28   When filetype is specified, set the file type of the
29   current ex buffer.
31 New key mappings:
32 ^a in normal mode, searches for the word under the cursor.
33 ^p in insert mode, inserts the contents of the default yank buffer.
34 zL, zl, zr, and zR in normal mode change the value of td option.
35 gu, gU, and g~ switch character case.
37 OPTIONS
38 -------
40 To improve neatvi's performance, shaping, character reordering, and
41 syntax highlighting can be disabled by defining the EXINIT environment
42 variable as "set noshape | set noorder | set nohl | set td=+2".
44 Options supported in neatvi:
46 td, textdirection
47   Current direction context.  The following values are meaningful:
48   * +2: always left-to-right.
49   * +1: follow conf.h's dircontexts[]; left-to-right for others.
50   * -1: follow conf.h's dircontexts[]; right-to-left for others.
51   * -2: always right-to-left.
52 shape
53   If set (default), performs Arabic/Farsi letter shaping.
54 order
55   If set, reorder characters based on the rules defined
56   in conf.h.
57 hl, highlight
58   If set (default), text will be highlighted based on syntax
59   highlighting rules in conf.h.
60 ai, autoindent
61   As in vi(1).
62 aw, autowrite
63   As in vi(1).
64 ic, ignorecase
65   As in vi(1).
67 MARKS AND BUFFERS
68 -----------------
70 Special marks:
71 * the position of the previous change
72 [ the first line of the previous change
73 ] the last line of the previous change
75 Special yank buffers:
76 / the previous search keyword
77 : the previous ex command