vim: fix and improve command descriptions
[sheet.git] / vim-cmds.inc.pl
index 40ed33ecd0a58252d41a0f948b2034eab2365bd5..a3b9ba4e1903dcd187dd20b07cc033832398496c 100644 (file)
@@ -3,14 +3,14 @@ use utf8;
 '' => {
        desc => "normal mode",
 
-       '~' => ["toggle case", "co undo"],
-       '!' => ["extern$sign{_}al filter", "co argm undo modec"],
+       '~' => ["case toggle", "co undo"],
+       '!' => ["filt$sign{_}er lines", "co argm undo modec"],
        '@' => ["play macro", "co arg undo"],
        '#' => ["rev. find word", "pm vim"],
        '$' => ["eol", "pm"],
        '%' => ["goto match", "pm"],
        '^' => ['"soft" bol', "pm"],
-       '&' => ["repeat :s", "co undo"],
+       '&' => [":s rep$sign{_}eat", "co undo"],
        '*' => ["find word", "pm vim"],
        '(' => ["begin sentence", "pm"],
        ')' => ["end sentence", "pm"],
@@ -26,11 +26,11 @@ use utf8;
        ':' => ["ex cmd line", "co modec"],
        "'" => ["goto mark bol", "pm arg"],
        '"' => ["use register", "co arg"],
-       '\\' => ["not used", "me arg"],
+       '\\' => ["reser$sign{_}ved", 'me arg'],
        '^\\' => ["to mode/$sign{_}ext$sign{_}ens$sign{_}ion$sign{_}s", "mo arg"],
        ',' => ["reverse t/T/f/F", "pm"],
        '<' => ["un$sign{_}ind$sign{_}ent", "co argm undo"],
-       '.' => ["repeat cmd", "co undo"],
+       '.' => ["repeat last cmd", "co undo"],
        '>' => ["ind$sign{_}ent", "co argm undo"],
        '/' => ["find", "pm arg modec"],
        '[' => ["move back$sign{_}ward$sign{_}s", "me arg mode["],
@@ -38,7 +38,7 @@ use utf8;
        ']' => ["move forw$sign{_}ard", "me arg mode]"],
        '}' => ["end parag.", "pm"],
        '^]'=> ["go to tag", "po"],
-       '|' => ["bol/$sign{_}goto col", "pm"],
+       '|' => ["goto (1st) col", "pm"],
 
        'a' => ["append", "mi undo modei"],
        'A' => ["append to eol", "mi undo modei"],
@@ -76,13 +76,13 @@ use utf8;
        'L' => ["screen bottom", "pm", "Lowermost Line"],
        '^l'=> ["redraw", "ci"],
        'm' => ["set mark", "co arg"],
-       'M' => ["screen mid'l", "pm"],
+       'M' => ["screen mid$sign{_}dle", "pm"],
        '^m'=> "+",
        'n' => ["next find", "pm"],
        'N' => ["prev find", "pm"],
        '^n'=> "j",
-       'o' => ["open below", "mi undo modei"],
-       'O' => ["open above", "mi undo modei"],
+       'o' => ["line below", "mi undo modei", 'Open'],
+       'O' => ["line above", "mi undo modei"],
        '^o'=> ["jump to older", "pm vim"],
        'p' => ["paste after", "co undo"],
        'P' => ["paste before", "co undo"],
@@ -92,26 +92,26 @@ use utf8;
        '^q'=> ["(xon)", "ci", 'Qome back'], # or ^v
        'r' => ["replace char", "co arg undo"],
        'R' => ["replace mode", "mi undo modei"],
-       '^r'=> ["redo", "co undo"],
+       '^r'=> ["redo", "co undo vim"],
        's' => ["subst char", "mi undo modei"],
        'S' => ["subst line", "mi undo modei"],
        '^s'=> ["(xoff)", "ci", 'Stop'],
        't' => ["till char", "pm arg"],
        'T' => ["back till char", "pm"],
-       '^t'=> ["previous tag", "po"],
+       '^t'=> ["back tag", "po"], # backtrag :P
        'u' => ["undo", "co undo"],
        'U' => ["undo line", "co undo"],
        '^u'=> ["scroll up", "po"],
        'v' => ["visual mode", "mv modev"],
        'V' => ["visual lines", "mv modev"],
-       '^v'=> ["visual block", "mv modev"],
+       '^v'=> ["visual block", "mv modev vim"],
        'w' => ["next word", "pm"],
        'W' => ['next <span style="font-variant:small-caps">word</span>', "pm"],
        '^w'=> ["window cmds", "me arg mode^w"],
        'x' => ["delete char", "co undo"],
        'X' => ["back$sign{_}space", "co undo"],
        '^x'=> ["subs$sign{_}tract", "co undo"],
-       'y' => ["yank", "co argm"],
+       'y' => ["yank", "co argm", '(copy)'],
        'Y' => ["yank line", "co"],
        '^y'=> ["window up", "po", 'Yield'],
        'z' => ["extra cmds", "me arg modez"],
@@ -128,7 +128,7 @@ g => {
        '#' => ["rev. find string", "pm vim"],
        '$' => ["virt$sign{_}ual eol", "pm"],
        '^' => [qq'"soft" bol v$sign{_}irt$sign{_}ual', "pm vim"],
-       '&' => ["repeat :s global$sign{_}ly", "co", "Global substitute"],
+       '&' => [":s rep$sign{_}eat glob$sign{_}al$sign{_}ly", "co", "Global substitute"],
        '*' => ["find string", "pm vim"],
        '_' => [qq'"soft" eol', "pm vim"],
        '+' => ["later undo", "co vim7"],
@@ -157,16 +157,16 @@ g => {
        '^g'=> ["cursor pos info", "ci"],
        'h' => ["select mode", "mv modev", "Get Highlighted"],
        'H' => ["select lines", "mv modev", "Get Highlighted"],
-       '^h'=> ["select block", "mv modev", "Get Highlighted"],
+       '^h'=> ["select block", "mv modev vim", "Get Highlighted"],
        'i' => ["insert at last pos", "mi undo modei"],
        'I' => ["insert at soft bol", "mi undo modei"],
-       'j' => ["display line down", "pm vim"],
+       'j' => ["$sign{down} screen", "pm vim"],
        'J' => ["join leave spac$sign{_}ing", "co"],
-       'k' => ["display line up", "pm vim"],
-       'm' => ["g0 right half scr$sign{_}een", "pm vim"],
+       'k' => ["$sign{up} screen", "pm vim"],
+       'm' => ["center screen", "pm vim"],
        'o' => [":goto (byte)", "pm"],
-       'p' => ["paste no move", "co undo"],
-       'P' => ["paste before no move", "co"],
+       'p' => ["paste still", "co undo"],
+       'P' => ["paste before still", "co"],
        'q' => ["format", "co argm"],
        'Q' => ["ex mode manual :", "mo vim"],
        'r' => ["replace char vir.", "co arg"],
@@ -178,7 +178,7 @@ g => {
        'U' => ["upper$sign{_}case", "co undo argm vim"],
        'v' => ["previous highl$sign{_}ight", 'mv modev', 'precedinG Visual'],
        'V' => ["avoid reselect$sign{_}ion", "co"],
-       'w' => ["format remain cursor", "co argm vim7"],
+       'w' => ["for$sign{_}mat still", "co argm vim7"],
        'x' => ["Netrw$sign{_}BrowseX", "co vim7"],
 }, # mode g
 
@@ -188,8 +188,8 @@ Z => {
 
        '^['=> ["esc", "mo mode"],
 
-       'Q' => [" :q!", "co vim"],
-       'Z' => [" :wq", "co"],
+       'Q' => [" :q! (force)", "co vim"],
+       'Z' => [" :wq (write)", "co"],
 }, # mode Z
 
 z => {
@@ -214,8 +214,8 @@ z => {
        'E' => ["eliminate folds", "co vim folding"],
        'f' => ["create fold", "co argm vim folding"],
        'F' => ["fold lines", "co vim folding"],
-       'g' => ["correct spelling", "co vim7", "Good word"],
-       'G' => ["add spelling", "co vim7"],
+       'g' => ["add spelling", "co vim7", 'Good word'],
+       'G' => ["temp spelling", "co vim7"],
        'h' => ["scroll $sign{right}", "po"],
        'H' => ["scroll $sign{right} half scr$sign{_}een", "po"],
        'i' => ["toggle all folds", "co vim folding"],
@@ -240,7 +240,7 @@ z => {
        'W' => ["temp misspell$sign{_}ing", "co vim7"],
        'x' => ["update folds", "co vim folding"],
        'X' => ["reapply folds", "co vim folding"],
-       'z' => ["line at center", "po", "Zee Zenter (with an accent)"],
+       'z' => ["line at center", "po", "Zee Zenter (with a funny accent)"],
 }, # mode z
 
 '[' => {
@@ -259,13 +259,13 @@ z => {
        ']' => [qq'<span style="font-variant:small-caps">section</span> back$sign{_}ward$sign{_}s', "pm"],
 
        'c' => ["start of change backw$sign{_}ards", "pm"],
-       'd' => ["list define", "co"],
-       'D' => ["list defines", "co"],
-       '^d'=> ["first #define", "po"],
+       'd' => ["define line", "ci"],
+       'D' => ["defin$sign{_}ition", "co"],
+       '^d'=> ["to defin$sign{_}it$sign{_}ion", "po"],
        'f' => "gf",  # deprecated
-       'i' => ["list line", "co"],
-       'I' => ["list lines", "co"],
-       '^i'=> ["first occur$sign{_}renc$sign{_}e", "po"],
+       'i' => ["first occur$sign{_}renc$sign{_}e line", 'ci'],
+       'I' => ["first occur$sign{_}renc$sign{_}e", 'co'],
+       '^i'=> ["to first occur$sign{_}renc$sign{_}e", 'po'],
        'm' => ["start of funct$sign{_}ion", "pm"],
        'p' => ["P but reindent", "co"],
        'P' => ["[p", "co"],
@@ -290,13 +290,13 @@ z => {
        '}' => ["next open }", "pm"],
 
        'c' => ["start of change forw$sign{_}ards", "pm"],
-       'd' => ["list define", "co"],
-       'D' => ["list defines", "co"],
-       '^d'=> ["first #define", "po"],
+       'd' => ["next define line", "ci"],
+       'D' => ["next define", "co"],
+       '^d'=> ["to next define", "po"],
        'f' => "gf",  # deprecated
-       'i' => ["list line", "co"],
-       'I' => ["list lines", "co"],
-       '^i'=> ["first occur$sign{_}renc$sign{_}e", "po"],
+       'i' => ["next occur$sign{_}renc$sign{_}e line", "ci"],
+       'I' => ["next occur$sign{_}renc$sign{_}e", "co"],
+       '^i'=> ["to occur$sign{_}renc$sign{_}e", "po"],
        'm' => ["end of funct$sign{_}ion", "pm"],
        'p' => ["p but reindent", "co"],
        'P' => "[p",
@@ -380,7 +380,7 @@ v => {
        '^\\'=>'^\\',
 
        'a' => ["extend area", "me modeva arg vim"],
-       'A' => ["append to block", "mi modei"], # block
+       'A' => ["append to block", "mi modei vim"], # block
        'c' => ["replace area", "mi modei vim"],
        'C' => ["replace lines", "mi modei vim"],
        '^c'=> ["abort", "mo mode"],
@@ -390,7 +390,7 @@ v => {
        '^g'=> ["select mode", "mv"],
        '^h'=> ["delete area", "co"], # select mode only
        'i' => ["extend inner a$sign{_}r$sign{_}ea", "me modeva arg vim"],
-       'I' => ["insert to block", "mi modei"], # block
+       'I' => ["insert to block", "mi modei vim"], # block
        'J' => ["join lines", "co"],
        'K' => ["keyword$sign{_}prg", "co"],
        'o' => ["to other corner", "pm"],
@@ -408,7 +408,7 @@ v => {
        'U' => ["upper$sign{_}case", "co vim"],
        'v' => ["char$sign{_}wise", "mv"],
        'V' => ["line$sign{_}wise", "mv"],
-       '^v'=> ["block$sign{_}wise", "mv"],
+       '^v'=> ["block$sign{_}wise", "mv vim"],
        'x' => "vd",
        'X' => "vD",
        'y' => ["yank area", "co"],
@@ -504,7 +504,7 @@ i => {
        '^h' => ["back$sign{_}space", "co"],
        '^i' => ["tab", "co"],
        '^j' => ["enter", "co"],
-       '^k' => ["di$sign{_}graph", "co arg arg vim", "Key code"],
+       '^k' => ["di$sign{_}graph", "co arg arg vim linkdigraphs.plp", "Key code"],
        '^l' => ["<em>im</em> leave ins mode", "mo mode vim"],  # insertmode only
        '^m' => ["enter", "co"],
        '^n' => ["find next keyword", "pm vim"],