A few docs clarifications.

-- shifted mappings notation (<C-n> vs <C-N>)
-- adjusted the ':!' warning
-- other minor fixes

3 files changed, 12 insertions, 7 deletions

diff --git a/vimperator/locale/en-US/map.txt b/vimperator/locale/en-US/map.txt
index b1073ffe..136a85f0 100644
--- a/vimperator/locale/en-US/map.txt
+++ b/vimperator/locale/en-US/map.txt
@@ -15,6 +15,10 @@ will echo the current date to the command line when [m]<F2>[m] is pressed.
 There are separate key mapping tables for each of the Normal, Insert, and
 Command-line modes.
 
+Please note that, unlike Vim and other applications, mappings containing
+the Shift key are specified with the capital letter, so e.g. [m]<C-n>[m] is
+different from [m]<C-N>[m], the latter being the only way to map Shift-Ctrl-n.
+
 |:map-special-chars| +
 
 |<Nop>| +
diff --git a/vimperator/locale/en-US/styling.txt b/vimperator/locale/en-US/styling.txt
index 4bdc79c3..87de57cb 100644
--- a/vimperator/locale/en-US/styling.txt
+++ b/vimperator/locale/en-US/styling.txt
@@ -18,11 +18,11 @@ sourced.
 ________________________________________________________________________________
 
 |:hi| |:highlight| +
-||:hi[ghlight][!] [-append] {group}[{selector}] [{css}]|| +
+||:hi[ghlight][!] [-append] {group} [[{selector}] {css}]|| +
 ________________________________________________________________________________
 Highlight {group} with {css}. Normally, {css} is checked for valid
 syntax before it's applied. Once you're certain it's valid, [!] can be
-used to override the check to speed Vimperator startup. {selector} can
+used to skip the check to speed up Vimperator startup. {selector} can
 be any valid CSS selector, such as [c]:hover[c], and, if provided, will
 restrict the match to matching elements.
 
@@ -89,11 +89,11 @@ Valid groups are:
 Every invocation completely replaces the styling of any previous invocation,
 unless *-append* (short option: *-a*) is provided, in which case {css} is
 appended to its current value. If {css} is not provided, any styles matching
-{group} are listed.
+{group} are listed, or all styles if no {group} provided.
 ________________________________________________________________________________
 
 |:highlight-clear| +
-||:hi[light] clear [{group}[{selector}]]|| +
+||:hi[ghlight] clear [{group} [{selector}]]|| +
 ________________________________________________________________________________
 Reset the highlighting for {group} to its default value. If
 {group} is not given, reset all highlighting groups.
diff --git a/vimperator/locale/en-US/various.txt b/vimperator/locale/en-US/various.txt
index 3d91d444..67ee6e2f 100644
--- a/vimperator/locale/en-US/various.txt
+++ b/vimperator/locale/en-US/various.txt
@@ -30,11 +30,12 @@ ________________________________________________________________________________
 ||:!{cmd}||
 ________________________________________________________________________________
 Run a command. Runs {cmd} through system() and displays its output. Any \'!' in
-{cmd} is replaced with the previous external command. But not when there is a
-backslash before the \'!', then that backslash is removed.
+{cmd} is replaced with the previous external command, but not when there is a
+backslash before the \'!', then the backslash is removed.
 
 Warning: Input redirection (< foo) not done, also do not run commands which
-require stdin or it will hang Firefox!
+require stdin or it will hang Firefox! It is possible to launch background
+processes, though (e.g. ':! xterm &').
 ________________________________________________________________________________