vim: fix and improve command descriptions

Several subtle description updates, stating functionality more clearly
(and less incorrectly for [d [i and similar).

diff --git a/vim-cmds.inc.pl b/vim-cmds.inc.pl
index bc171da3eef3e8b09ae01bee2e2baaf7516e88e3..a3b9ba4e1903dcd187dd20b07cc033832398496c 100644 (file)
--- a/vim-cmds.inc.pl
+++ b/vim-cmds.inc.pl
@@ -3,14 +3,14 @@ use utf8;
 '' => {
        desc => "normal mode",
 
 '' => {
        desc => "normal mode",
 

-       '~' => ["toggle case", "co undo"],
-       '!' => ["extern$sign{_}al filt$sign{_}er", "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"],
        '@' => ["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"],
        '*' => ["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"],
        ':' => ["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"],
        '^\\' => ["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["],
        '>' => ["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"],
        ']' => ["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"],
 
        '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"],
        '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",
        '^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"],
        '^o'=> ["jump to older", "pm vim"],
        'p' => ["paste after", "co undo"],
        'P' => ["paste before", "co undo"],


@@ -98,7 +98,7 @@ use utf8;
        '^s'=> ["(xoff)", "ci", 'Stop'],
        't' => ["till char", "pm arg"],
        'T' => ["back till char", "pm"],
        '^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"],
        'u' => ["undo", "co undo"],
        'U' => ["undo line", "co undo"],
        '^u'=> ["scroll up", "po"],


@@ -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"],
        '#' => ["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"],
        '*' => ["find string", "pm vim"],
        '_' => [qq'"soft" eol', "pm vim"],
        '+' => ["later undo", "co vim7"],


@@ -160,13 +160,13 @@ g => {
        '^h'=> ["select block", "mv modev vim", "Get Highlighted"],
        'i' => ["insert at last pos", "mi undo modei"],
        'I' => ["insert at soft bol", "mi undo modei"],
        '^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"],
        '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"],
        '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"],
        '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"],
        '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
 
        'x' => ["Netrw$sign{_}BrowseX", "co vim7"],
 }, # mode g
 


@@ -188,8 +188,8 @@ Z => {
 
        '^['=> ["esc", "mo mode"],
 
 
        '^['=> ["esc", "mo mode"],
 

-       'Q' => [" :q!", "co vim"],
-       'Z' => [" :wq", "co"],
+       'Q' => [" :q! (force)", "co vim"],
+       'Z' => [" :wq (write)", "co"],

 }, # mode Z
 
 z => {
 }, # 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"],
        '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"],
        '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"],
        '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
 
 '[' => {
 }, # 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"],
        ']' => [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
        '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"],
        '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"],
        '}' => ["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
        '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",
        'm' => ["end of funct$sign{_}ion", "pm"],
        'p' => ["p but reindent", "co"],
        'P' => "[p",