README

   1 NEATVI
   2 ======
   3
   4 Neatvi is a vi/ex editor.  It can edit bidirectional UTF-8 text.
   5
   6 CONFIGURATION
   7 -------------
   8
   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).
  16
  17 COMMANDS
  18 --------
  19
  20 Commands not available in ex(1):
  21
  22 :cm[ap][!] [kmap]
  23   Without kmap, prints the current keymap name.
  24   When kmap is specified, sets the alternate keymap to
  25   kmap and, unless ! is given, switches to this keymap.
  26 :ft [filetype]
  27   Without filetype, prints the current file type.
  28   When filetype is specified, sets the file type of the
  29   current ex buffer.
  30
  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.
  36 ^l in normal mode, updates terminal dimensions.
  37
  38 OPTIONS
  39 -------
  40
  41 To improve neatvi's performance, shaping, character reordering, and
  42 syntax highlighting can be disabled by defining the EXINIT environment
  43 variable as "set noshape | set noorder | set nohl | set td=+2".
  44
  45 Options supported in neatvi:
  46
  47 td, textdirection
  48   Current direction context.  The following values are meaningful:
  49   * +2: always left-to-right.
  50   * +1: follow conf.h's dircontexts[]; left-to-right for others.
  51   * -1: follow conf.h's dircontexts[]; right-to-left for others.
  52   * -2: always right-to-left.
  53 shape
  54   If set (default), performs Arabic/Farsi letter shaping.
  55 order
  56   If set, reorder characters based on the rules defined
  57   in conf.h.
  58 hl, highlight
  59   If set (default), text will be highlighted based on syntax
  60   highlighting rules in conf.h.
  61 ai, autoindent
  62   As in vi(1).
  63 aw, autowrite
  64   As in vi(1).
  65 ic, ignorecase
  66   As in vi(1).
  67
  68 MARKS AND BUFFERS
  69 -----------------
  70
  71 Special marks:
  72 * the position of the previous change
  73 [ the first line of the previous change
  74 ] the last line of the previous change
  75
  76 Special yank buffers:
  77 / the previous search keyword
  78 : the previous ex command