Fix missing help pages resulting from non-well-formed markup.

Most of the special case asciidoc replacements were also removed since
they're a bit confusing and doing so results in a 60% improvement in the
time taken by asciidoc to process the help pages.  Unfortunately, I'm
now limited to preparing a three course menu for my guests while it runs
rather than the degustation extravaganzas of the past but such is life.

It's still a bit of a mess but since we're almost certainly moving to
something else in the near future it's probably not worth cleaning it up
before 2.0 is released.

vimperator/locale/en-US/autocommands.txt

@@ -57,18 +57,18 @@ ________________________________________________________________________________
 
 
 |:doautoa| |:doautoall|
-||:doautoa[ll] {event} [url]|| +
+||:doautoa[ll] {event} [a][url][a]|| +
 ________________________________________________________________________________
-Apply the autocommands matching the specified URL to all buffers. If no [url]
+Apply the autocommands matching the specified URL to all buffers. If no
-is specified use the current URL.
+[a][url][a] is specified use the current URL.
 ________________________________________________________________________________
 
 
 |:do| |:doautocmd|
-||:do[autocmd] {event} [url]|| +
+||:do[autocmd] {event} [a][url][a]|| +
 ________________________________________________________________________________
 Apply the autocommands matching the specified URL to the current buffer. If no
-[url] is specified use the current URL.
+[a][url][a] is specified use the current URL.
 ________________________________________________________________________________
 
 section:Examples[autocmd-examples]

vimperator/locale/en-US/browsing.txt

@@ -30,7 +30,7 @@ ________________________________________________________________________________
 section:Opening{nbsp}web{nbsp}pages[opening]
 
 |o| |:o| |:open|
-||:o[pen][!] [arg1], [arg2], ...|| +
+||:o[pen][!] [a][arg1][a], [a][arg2][a], ...|| +
 ||o||
 ________________________________________________________________________________
 Open one or more URLs in the current tab.
@@ -65,7 +65,7 @@ ________________________________________________________________________________
 
 
 |t| |:t| |:tabopen| |:tabnew| |:tabe| |:tabedit|
-||:tabopen[!] [arg1], [arg2], ...|| +
+||:tabopen[!] [a][arg1][a], [a][arg2][a], ...|| +
 ||t||
 ________________________________________________________________________________
 Just like [c]:open[c], but opens the resulting web page(s)
@@ -100,7 +100,7 @@ ________________________________________________________________________________
 
 
 |:winopen| |:wopen| |:winedit|
-||:wino[pen][!] [arg1], [arg2], ...|| +
+||:wino[pen][!] [a][arg1][a], [a][arg2][a], ...|| +
 ________________________________________________________________________________
 Just like help::open[browsing.html#opening], but opens the resulting web page(s)
 in a new window.
@@ -274,11 +274,10 @@ ________________________________________________________________________________
 section:Writing[writing,save-file]
 
 |:w| |:write| |:sav| |:saveas| +
-||:sav[eas][!] [file]||
+||:sav[eas][!] [a][file][a]||
 ________________________________________________________________________________
-Save current web page to disk. If [file] is omitted, save to the page's
+Save current web page to disk. If [a][file][a] is omitted, save to the page's
-default filename. Existing documents will only be overwritten if [!] is
+default filename. Existing documents will only be overwritten if [!] is given.
-given.
 ________________________________________________________________________________
 
 section:Quitting[quitting,save-session]

vimperator/locale/en-US/buffer.txt

@@ -10,7 +10,7 @@ section:Buffer{nbsp}information[buffer-information]
 |<C-g>| +
 ||<C-g>||
 ________________________________________________________________________________
-Print the current file name.  Also shows some additional file information like
+Print the current file name. Also shows some additional file information like
 file size or the last modified date.
 ________________________________________________________________________________
 
@@ -47,10 +47,10 @@ ________________________________________________________________________________
 
 
 |:vie| |:viewsource|
-||:vie[wsource][!] [url]|| +
+||:vie[wsource][!] [a][url][a]|| +
 ________________________________________________________________________________
-View source code of current document.  If [url] is specified then view the
+View source code of current document. If [a][url][a] is specified then view the
-source of that document.  When [!] is given, it is opened with the external
+source of that document. When [!] is given, it is opened with the external
 editor.
 ________________________________________________________________________________
 
@@ -306,12 +306,12 @@ ________________________________________________________________________________
 
 
 |:zo| |:zoom|
-||:zo[om][!] [value]|| +
+||:zo[om][!] [a][value][a]|| +
 ||:zo[om][!] +{value} | -{value}|| +
 ________________________________________________________________________________
-Set zoom value of current web page. [value] can be an absolute value between 30
+Set zoom value of current web page. [a][value][a] can be an absolute value
-and 300% or a relative value if prefixed with "-" or "+". If [value] is
+between 30 and 300% or a relative value if prefixed with "-" or "+". If
-omitted, zoom is reset to 100%.
+[a][value][a] is omitted, zoom is reset to 100%.
 
 Normally this command operates on the text zoom, if used with [!] it operates
 on full zoom.
@@ -339,14 +339,14 @@ ________________________________________________________________________________
 
 section:Alternate{nbsp}style{nbsp}sheets[alternate-stylesheet]
 
-Page authors may specify alternate style sheets for an HTML document.  Users
+Page authors may specify alternate style sheets for an HTML document. Users can
-can then switch between these various style sheets, selecting their favorite.
+then switch between these various style sheets, selecting their favorite.
 
 |:pagest| |:pagestyle|
-||:pagest[yle] [stylesheet]|| +
+||:pagest[yle] [a][stylesheet][a]|| +
 ________________________________________________________________________________
-Select the author style sheet to apply.  If [stylesheet] is not specified the
+Select the author style sheet to apply. If [a][stylesheet][a] is not specified
-page's default style sheet is used.
+the page's default style sheet is used.
 
 All author styling can be removed by setting the 'usermode' option.
 ________________________________________________________________________________

vimperator/locale/en-US/cmdline.txt

@@ -66,7 +66,7 @@ section:Command-line{nbsp}completion[cmdline-completion]
 ||<Tab>||
 ________________________________________________________________________________
 Complete the word in front of the cursor according to the behavior specified in
-'wildmode'.  If 'wildmode' contains "list" and there are multiple matches then
+'wildmode'. If 'wildmode' contains "list" and there are multiple matches then
 the completion menu window is opened.
 ________________________________________________________________________________
 

vimperator/locale/en-US/developer.txt

@@ -8,7 +8,7 @@ http://www.methods.co.nz/asciidoc/index.html[asciidoc] version 8.x or
 newer. The are placed in the _src/locale/en-US/_ directory and compiled with
 _make doc_. Please refer to the
 http://www.methods.co.nz/asciidoc/userguide.html[asciidoc documentation] above
-for details.  Usually you can just write text as is, and mostly it will be
+for details. Usually you can just write text as is, and mostly it will be
 interpreted correctly. The only difficult part is to write special sections
 like for help::help[various.html#online-help].
 
@@ -53,10 +53,11 @@ Some notes about the code above:
 - The actual help code for this command is embedded in at least 4 underscores
   (_). This generates a quoteblock and indents the text so it is more clear
   that it belongs to the command.
-- Wrap things in *$$[c]$$* and they are drawn like a :command. Also *$$[o]$$*
+- Wrap things in *$$[c]$$* and they are drawn like a :command. Also *$$[o]$$*,
-  and *$$[m]$$* are available to show options and mappings.
+  *$$[m]$$* and *$$[a]$$* are available to markup options, mappings, and
-- Any string within \{...\} and $$[arg]$$, $$[url]$$, $$[count]$$ and $$[!]$$ are
+  arguments.
-  automatically drawn in a blue color.
+- As a convenience, any string within \{...\} and $$[count]$$ and $$[!]$$ are
+  automatically marked up as an argument.
 
 There are also some additional asciidoc commands specifically for writing
 Vimperator documentation:

vimperator/locale/en-US/eval.txt

@@ -8,10 +8,9 @@ INTRO TO BE WRITTEN...
 ||:ec[ho] {expr}||
 ________________________________________________________________________________
 Echo the expression. Useful for showing informational messages. Multiple lines
-can be separated by \n.  {expr} can either be a quoted string, or any
+can be separated by \n. {expr} can either be a quoted string, or any expression
-expression which can be fed to eval() like 4+5. You can also view the source
+which can be fed to eval() like 4+5. You can also view the source code of
-code of objects and functions if the return value of {expr} is an object or
+objects and functions if the return value of {expr} is an object or function.
-function.
 ________________________________________________________________________________
 
 

vimperator/locale/en-US/map.txt

@@ -5,8 +5,8 @@ Key mappings, abbreviations, and user-defined commands.
 section:Key{nbsp}mapping[key-mapping,mapping,macro]
 
 The key mapping commands can be used to either redefine the standard key
-bindings or define new ones.  A mapping consists of a key, or sequence of keys,
+bindings or define new ones. A mapping consists of a key, or sequence of keys,
-which are translated to a string of characters.  Example:
+which are translated to a string of characters. Example:
 
   :map <F2> :echo new Date().toDateString()<CR>
 
@@ -20,7 +20,7 @@ Command-line modes.
 |<Nop>| +
 ||<Nop>||
 ________________________________________________________________________________
-Do nothing.  This command is useful for disabling a specific mapping.  [c]:map
+Do nothing. This command is useful for disabling a specific mapping. [c]:map
 <C-n> <Nop>[c] will prevent [m]<C-n>[m] from doing anything.
 ________________________________________________________________________________
 
@@ -28,9 +28,9 @@ ________________________________________________________________________________
 |<CR>| |map_return| +
 ||<CR>||
 ________________________________________________________________________________
-Expand to a line terminator in a key mapping.  An Ex command in the {rhs} of a
+Expand to a line terminator in a key mapping. An Ex command in the {rhs} of a
 mapping requires a a line terminator after it so that it is executed when the
-mapping is expanded.  [m]<CR>[m] should be used for this purpose.
+mapping is expanded. [m]<CR>[m] should be used for this purpose.
 ________________________________________________________________________________
 
 

vimperator/locale/en-US/marks.txt

@@ -15,7 +15,7 @@ Vimperator supports a number of different marks:
 section:Bookmarks[bookmarks]
 
 |a| |:bma| |:bmark|
-||:bma[rk][!] [-title=title] [-keyword=kw] [-tags=tag1,tag2] [url]|| +
+||:bma[rk][!] [a][-title=title][a] [a][-keyword=kw][a] [a][-tags=tag1,tag2][a] [a][url][a]|| +
 ||a||
 ____________________________________________________________________________
 Add a bookmark. +
@@ -27,12 +27,12 @@ The following options are interpreted:
 - -keyword=keyword (short option: -k)
 
 If [!] is present, a new bookmark is always added. Otherwise, the first
-bookmark matching [url] is updated.
+bookmark matching [a][url][a] is updated.
 
 When creating a new bookmark, if [a][-title][a] isn't given, either the web
-page's title or URL is used. You can omit the optional [url] argument, so just
+page's title or URL is used. You can omit the optional [a][url][a] argument, so
-do [c]:bmark[c] to bookmark the currently loaded web page with a default title
+just do [c]:bmark[c] to bookmark the currently loaded web page with a default
-and without any tags.
+title and without any tags.
 ____________________________________________________________________________
 
 
@@ -47,10 +47,11 @@ ________________________________________________________________________________
 
 
 |:bmarks|
-||:bmarks[!] [filter]|| +
+||:bmarks[!] [a][filter][a]|| +
 ________________________________________________________________________________
 List or open multiple bookmarks. Open the message window at the bottom of the
-screen with all bookmarks which match [filter] either in the title or URL.
+screen with all bookmarks which match [a][filter][a] either in the title or
+URL.
 
 The special version [c]:bmarks![c] works the same as [c]:bmarks[c] except it
 opens all the found bookmarks in new tabs.
@@ -62,10 +63,10 @@ ________________________________________________________________________________
 
 
 |:delbm| |:delbmarks|
-||:delbm[arks] [url]|| +
+||:delbm[arks] [a][url][a]|| +
 ________________________________________________________________________________
-Delete a bookmark. Deletes *all* bookmarks which match the [url].
+Delete a bookmark. Deletes *all* bookmarks which match the [a][url][a]. If
-If omitted, [url] defaults to the URL of the current buffer. Use [m]<Tab>[m]
+omitted, [a][url][a] defaults to the URL of the current buffer. Use [m]<Tab>[m]
 key on a string to complete the URL which you want to delete.
 
 The following options WILL be interpreted in the future:
@@ -106,7 +107,7 @@ ________________________________________________________________________________
 
 
 |:ba| |:back|
-||:[count]ba[ck][!] [url]|| +
+||:[count]ba[ck][!] [a][url][a]|| +
 ________________________________________________________________________________
 Go back in the browser history. Count is supported, [c]:3back[c] goes back 3
 pages in the browser history. +
@@ -115,7 +116,7 @@ ________________________________________________________________________________
 
 
 |:fw| |:fo| |:forward|
-||:[count]fo[rward][!] [url]|| +
+||:[count]fo[rward][!] [a][url][a]|| +
 ________________________________________________________________________________
 Go forward in the browser history. Count is supported, [c]:3forward[c] goes
 forward 3 pages in the browser history. The special version [c]:forward![c]
@@ -124,10 +125,10 @@ ________________________________________________________________________________
 
 
 |:hs| |:hist| |:history|
-||:hist[ory][!] [filter]|| +
+||:hist[ory][!] [a][filter][a]|| +
 ________________________________________________________________________________
-Show recently visited URLs. Open the message window at the bottom of the
+Show recently visited URLs. Open the message window at the bottom of the screen
-screen with all history items which match [filter] either in the title or URL.
+with all history items which match [a][filter][a] either in the title or URL.
 
 The special version [c]:history![c] works the same as [c]:history[c] except
 it opens all the found items in new tabs.
@@ -183,7 +184,7 @@ ________________________________________________________________________________
 
 
 |:qma| |:qmark|
-||:qma[rk] {a-zA-Z0-9} [url]|| +
+||:qma[rk] {a-zA-Z0-9} [a][url][a]|| +
 ________________________________________________________________________________
 Mark a URL with a letter for quick access. You can also mark whole groups like this: +
 [c]:qmark f \http://forum1.com, \http://forum2.com, imdb some artist[c]
@@ -191,9 +192,10 @@ ________________________________________________________________________________
 
 
 |:qmarks|
-||:qmarks [arg]||
+||:qmarks [a][arg][a]||
 ________________________________________________________________________________
-Show all QuickMarks. If [arg] is specified then limit the list to those QuickMarks mentioned.
+Show all QuickMarks. If [a][arg][a] is specified then limit the list to those
+QuickMarks mentioned.
 ________________________________________________________________________________
 
 section:Local{nbsp}marks[localmarks]
@@ -237,9 +239,10 @@ ________________________________________________________________________________
 
 
 |:marks| +
-||:marks [arg]||
+||:marks [a][arg][a]||
 ________________________________________________________________________________
-Show all location marks of current web page. If [arg] is specified then limit the list to those marks mentioned.
+Show all location marks of current web page. If [a][arg][a] is specified then
+limit the list to those marks mentioned.
 ________________________________________________________________________________
 
 // vim: set syntax=asciidoc:

vimperator/locale/en-US/options.txt

@@ -239,9 +239,9 @@ ____
 |\'ds'| |\'defsearch'|
 ||'defsearch' 'ds'|| string (default: "google")
 ____
-Sets the default search engine.
+Sets the default search engine. The default search engine name is used in the
-The default search engine name is used in the [c]:[tab]open [arg][c] command if
+[c]:[tab]open [arg][c] command if [a][arg][a] neither looks like a URL or like
-[[arg]] neither looks like a URL or like a specified search engine/keyword.
+a specified search engine/keyword.
 
 This means, it you set 'defsearch' to "youtube", then [c]:open arnold
 schwarzenegger[c] will be exactly the same as [c]:open youtube arnold
@@ -249,7 +249,7 @@ schwarzenegger[c]. Therefore, you need to add a keyword or search engine
 "youtube" first.
 
 If 'defsearch' is empty, then Firefox will always attempt to open the
-raw [[arg]].
+raw [a][arg][a].
 ____
 
 
@@ -528,7 +528,7 @@ ____
 ||'pageinfo' 'pa'||
 charlist (default: gfm)
 ____
-Desired info on [c]:pa[geinfo][c].  Available items:
+Desired info on [c]:pa[geinfo][c]. Available items:
 
 .--------`----------------
 *g*      General info

vimperator/locale/en-US/pattern.txt

@@ -3,9 +3,9 @@ HEADER
 |text-search-commands| +
 
 Vimperator provides a Vim-like interface to Firefox's standard text search
-functionality.  There is no support for using regular expressions in search
+functionality. There is no support for using regular expressions in search
-commands as Firefox does not provide native regexp support.  It is unlikely
+commands as Firefox does not provide native regexp support. It is unlikely that
-that this will ever be available.
+this will ever be available.
 
 |/| +
 ||/\\{pattern\\}[/]<CR>|| +
@@ -13,7 +13,7 @@ ________________________________________________________________________________
 Search forward for the first occurrence of {pattern}.
 
 If "\c" appears anywhere in the pattern the whole pattern is handled as though
-'ignorecase' is on. "\C" forces case-sensitive matching for the whole pattern.  +
+'ignorecase' is on. "\C" forces case-sensitive matching for the whole pattern. +
 If "\l" appears in the pattern only the text of links is searched for a
 match as though 'linksearch' is on. "\L" forces the entire page to be searched
 for a match.

vimperator/locale/en-US/print.txt

@@ -6,7 +6,7 @@ HEADER
 ||:ha[rdcopy][!]||
 ________________________________________________________________________________
 Print current document. Open a GUI dialog where you can select the printer,
-number of copies, orientation, etc.  When used with [!], the dialog is skipped
+number of copies, orientation, etc. When used with [!], the dialog is skipped
 and the default printer used.
 ________________________________________________________________________________
 

vimperator/locale/en-US/repeat.txt

@@ -16,10 +16,10 @@ ____________________________________________________________________________
 
 
 |:macros|
-||:mac[ros] [args]|| +
+||:mac[ros] [a][pat][a]|| +
 ________________________________________________________________________________
-List recorded macros matching the optional regular expression [args]. If no
+List recorded macros matching the optional regular expression [a][pat][a]. If
-regexp is given, list all macros.
+no regexp is given, list all macros.
 ________________________________________________________________________________
 
 

vimperator/locale/en-US/starting.txt

@@ -34,11 +34,12 @@ _%HOMEDRIVE%%HOMEPATH%_.
 section:Saving{nbsp}settings[save-settings]
 
 |:mkv| |:mkvimperatorrc|
-||:mkv[imperatorrc][!] [file]|| +
+||:mkv[imperatorrc][!] [a][file][a]|| +
 ________________________________________________________________________________
-Write current key mappings and changed options to [file]. If no [file] is
+Write current key mappings and changed options to [a][file][a]. If no
-specified then _~/.vimperatorrc_ is written unless this file already exists. The
+[a][file][a] is specified then _~/.vimperatorrc_ is written unless this file
-special version [c]:mkvimperatorrc![c] will overwrite [file] if it exists.
+already exists. The special version [c]:mkvimperatorrc![c] will overwrite
+[a][file][a] if it exists.
 
 Warning: this differs from Vim's behavior which defaults to writing the file
 in the current directory.

vimperator/locale/en-US/tabs.txt

@@ -9,11 +9,11 @@ result many buffer and tab commands are interchangeable.
 section:Listing{nbsp}tabs[listing-tabs]
 
 |B| |:tabs| |:ls| |:files| |:buffers|
-||:buffers [filter]|| +
+||:buffers [a][filter][a]|| +
 ||B||
 ________________________________________________________________________________
-Show a list of buffers (=tabs) matching [filter]. Without [filter] list all
+Show a list of buffers (=tabs) matching [a][filter][a]. Without [a][filter][a]
-tabs.
+list all tabs.
 ________________________________________________________________________________
 
 section:Opening{nbsp}tabs[opening-tabs]
@@ -174,16 +174,16 @@ ________________________________________________________________________________
 section:Closing{nbsp}tabs[closing-tabs]
 
 |d| |:tabc| |:tabclose| |:bun| |:bunload| |:bw| |:bwipeout| |:bd| |:bdelete|
-||:[count]bd[elete][!] [arg]|| +
+||:[count]bd[elete][!] [a][arg][a]|| +
 ||[count]d||
 ________________________________________________________________________________
 Delete current buffer (=tab). Count is supported, [c]:2bd[c] removes two tabs
 and the one to the right is selected. Afterwards, the tab to the right of the
 deleted one is selected.
 
-When used with [arg], remove all tabs which contain [arg] in the hostname.
+When used with [a][arg][a], remove all tabs which contain [a][arg][a] in the
-[!] forces this command to also search for [arg] in the full URL and also
+hostname. [!] forces this command to also search for [a][arg][a] in the full
-the title of the tab. Use with care.
+URL and also the title of the tab. Use with care.
 ________________________________________________________________________________
 
 
@@ -195,11 +195,11 @@ ________________________________________________________________________________
 
 
 |u| |:u| |:undo|
-||:[count]u[ndo] [url]|| +
+||:[count]u[ndo] [a][url][a]|| +
 ||[count]u||
 ________________________________________________________________________________
 Undo closing of a tab. If a count is given, don't close the last but the
-[count]th last tab. With [url] restores the tab matching the URL.
+[count]th last tab. With [a][url][a] restores the tab matching the URL.
 ________________________________________________________________________________
 
 

vimperator/locale/en-US/tutorial.txt

@@ -11,14 +11,14 @@ section:Quick-start{nbsp}tutorial[tutorial]
 
 If you've started using Vimperator from scratch (i.e., without any
 customization), you should be looking at this help page in a relatively
-bare-looking window.  The menubar, navigation bar, and bookmark bars are
+bare-looking window. The menubar, navigation bar, and bookmark bars are hidden.
-hidden.  In case you missed the notice in the help:Introduction[intro.html],
+In case you missed the notice in the help:Introduction[intro.html], you can
-you can regain these by issuing the command
+regain these by issuing the command
 
   :set go+=mTb<CR>
 
 where [m]<CR>[m] represents pressing the <Enter> or <Return> key.
-If you're a veteran Vim user, this may look familiar.  It should.
+If you're a veteran Vim user, this may look familiar. It should.
 
 However, in this author's opinion, the best way to get familiar with
 Vimperator is to leave these disabled for now. (The above action can be
@@ -27,29 +27,29 @@ reversed with [c]:set go=<CR>[c])  You can look at the entry for
 
 section:Vimperator's{nbsp}modal{nbsp}interface[modal]
 
-Vimperator's power, like Vim's, comes from it's modal interface.  Keys have
+Vimperator's power, like Vim's, comes from it's modal interface. Keys have
-different meanings depending on which mode the browser is in.  Vimperator has
+different meanings depending on which mode the browser is in. Vimperator has
 several modes, but the 2 most important are ``normal'' mode and
 ``command-line'' mode.
 
-When Vimperator starts, it is in normal mode by default.  This is probably
+When Vimperator starts, it is in normal mode by default. This is probably where
-where you will spend the majority of your time.
+you will spend the majority of your time.
 
 The other core mode of Vimperator, command-line mode, can be entered from
-normal mode by typing a \':' (colon).  You will frequently see Vimperator
+normal mode by typing a \':' (colon). You will frequently see Vimperator
 commands start with a \':', indicating that what follows is a command.
 
-To return to normal mode command-line mode, type [m]<Esc>[m].  Pressing
+To return to normal mode command-line mode, type [m]<Esc>[m]. Pressing
 [m]<Esc>[m] will also return you to normal mode from most other modes in
 Vimperator.
 
 section:Getting{nbsp}help[getting-help]
 
-Vim is a great editor but it's not much of a web browser.  So even seasoned
+Vim is a great editor but it's not much of a web browser. So even seasoned Vim
-Vim users will probably have to look at Vimperator documentation sooner or
+users will probably have to look at Vimperator documentation sooner or later.
-later.  Most of the documentation for Vimperator's features are easily found
+Most of the documentation for Vimperator's features are easily found using the
-using the [c]:help[c] command.  For example, you can find help on the
+[c]:help[c] command. For example, you can find help on the [c]:help[c] command
-[c]:help[c] command by typing
+by typing
 
   :help :help<CR>
 
@@ -71,7 +71,7 @@ section:Mouseless[living-mouseless]
 
 The efficiency of Vimperator, as with the legendary editor it was inspired by,
 relies on the user being able to keep his fingers on the keyboard where they
-can do the most good.  While there are some areas where the mouse is clearly
+can do the most good. While there are some areas where the mouse is clearly
 superior at, such as GUI design or some games, Vimperator acts on the
 assumption that the web browser doesn't have to be one of those.
 
@@ -114,10 +114,10 @@ Vimmers.
   * [m]d[m] --
     close the active tab (delete the buffer)
 
-To open a web page in a new tab, use the [c]:tabopen {url}[c].  To open a URL
+To open a web page in a new tab, use the [c]:tabopen {url}[c]. To open a URL in
-in the current tab, use [c]:open[c]. The normal mode
+the current tab, use [c]:open[c]. The normal mode mappings [m]t[m] and [m]o[m],
-mappings [m]t[m] and [m]o[m], respectively, map to these commands, so the
+respectively, map to these commands, so the following pairs sequences are
-following pairs sequences are equivalent:
+equivalent:
 
   :open my.webmail.com<CR>
   omy.webmail.com<CR>
@@ -127,39 +127,39 @@ following pairs sequences are equivalent:
 
 section:Some{nbsp}hints{nbsp}about{nbsp}surfing...[hints-tutorial]
 
-So now you can navigate around in Vimperator.  But wait... how do you *open* a
+So now you can navigate around in Vimperator. But wait... how do you *open* a
 page or tab linked in a web page?  How do you ``click'' on all those links
 without your tailed friend?
 
-The answer is ``hints''.  Activating hints displays a number next to every
+The answer is ``hints''. Activating hints displays a number next to every link
-link Vimperator can find.  To follow the link, simply type the number
+Vimperator can find. To follow the link, simply type the number corresponding
-corresponding to the hint, a white number inside a red square by default.
+to the hint, a white number inside a red square by default.
 
 For text links, there's an additional shortcut; you can type some text
 contained in the link and Vimperator will search all the links it can find and
-only hint the matching links, further narrowing down the list.  If the text
+only hint the matching links, further narrowing down the list. If the text you
-you type uniquely identifies any given link, Vimperator will follow that link
+type uniquely identifies any given link, Vimperator will follow that link
 immediately without any further user input.
 
 Whichever way you choose to indicate your target link, once Vimperator has
 highlighted the link you want, simply hit [m]<Enter>[m] to open it.
 
 The most common hint mode is called help:QuickHint{nbsp}mode[various.html,f].
-To activate QuickHint mode, press either [m]f[m] or [m]F[m].  The lower-case
+To activate QuickHint mode, press either [m]f[m] or [m]F[m]. The lower-case
 [m]f[m] will open the resulting link in the current tab, while the upper-case
 [m]F[m] will open it in a new tab.
 
 To test it, try this link: http://vimperator.org/[Vimperator Homepage].
 Activate QuickHint mode with [m]f[m] or [m]F[m] to highlight all currently
-visible links.  Then start typing the text of the link.  The link should be
+visible links. Then start typing the text of the link. The link should be
-uniquely identified soon, and Vimperator will open it.  Once you're done,
+uniquely identified soon, and Vimperator will open it. Once you're done,
 remember to use [m]<C-o>[m] (``History Back'') or [m]d[m] (``Delete Buffer'')
 to return here, depending on which key you used to activate QuickHint mode.
 
 section:Common{nbsp}issues[common-issues]
 
 Say you get half-way done typing in a new URL, only to remember that you've
-already got that page open in the previous tab.  Your command-line might look
+already got that page open in the previous tab. Your command-line might look
 something like this:
 
   :open my.partial.url/fooba
@@ -171,10 +171,9 @@ following:
 
 section:Saving{nbsp}for{nbsp}posterity{nbsp}-{nbsp}vimperatorrc[vimperatorrc]
 
-Once you get Vimperator set up with your desired options, maps, and
+Once you get Vimperator set up with your desired options, maps, and commands,
-commands, you'll probably want them to be available the next time you
+you'll probably want them to be available the next time you open Vimperator.
-open Vimperator.  Continuing the Vim theme, this is done with a
+Continuing the Vim theme, this is done with a vimperatorrc file.
-vimperatorrc file.
 
 To save your current settings and allow them to be loaded automatically
 next time you start Vimperator, issue the [c]:mkv[c] command.
@@ -195,27 +194,27 @@ Vimperator supports all of Vim's classic methods of exiting.
 
 section:Where{nbsp}did{nbsp}Firefox{nbsp}go?[whither-firefox]
 
-You might feel pretty disoriented now. Don't worry.  This is still Firefox
+You might feel pretty disoriented now. Don't worry. This is still Firefox
-underneath.  Here are some ways Vimperator allows Firefox to shine through.
+underneath. Here are some ways Vimperator allows Firefox to shine through. See
-See the [c]:help[c] for these commands and mappings for more information on
+the [c]:help[c] for these commands and mappings for more information on how to
-how to make the best use of them.
+make the best use of them.
 
   * [c]:dialog[c] --
     To access some of Firefox's many dialog windows, you can use the
-    [c]:dialog[c] command.  See [c]:help :dialog[c].
+    [c]:dialog[c] command. See [c]:help :dialog[c].
   * [c]:bmarks[c] --
     Vimperator provides a new interface to bookmarks, but they're still your
-    standard Firefox bookmarks under the hood.  [c]:bmark[c] will add a new
+    standard Firefox bookmarks under the hood. [c]:bmark[c] will add a new
     bookmark, while [c]:bmarks[c] will list the bookmarks currently defined.
   * [c]:history[c] --
-    It's exactly what it sounds like.  This command will display a colorized,
+    It's exactly what it sounds like. This command will display a colorized,
     scrollable and clickable list of the locations in Vimperator's history.
   * [c]:emenu[c] --
     Access the Firefox menus through the Vimperator command-line.
 
 
-Feel free to explore at this point.  If you use the [c]:tabopen[c] command,
+Feel free to explore at this point. If you use the [c]:tabopen[c] command,
-remember to use the [m]gt[m]/[m]gT[m] mappings to get back to this page.  If
+remember to use the [m]gt[m]/[m]gT[m] mappings to get back to this page. If
 using the [c]:open[c] command, use the history keys (e.g., [m]H[m]) to return.
 If you get hopelessly lost, just type [c]:help<CR>[c] and click the
 ``Tutorial'' link to return.
@@ -228,7 +227,7 @@ section:Get{nbsp}me{nbsp}out{nbsp}of{nbsp}here![removal]
 
 If you've given it a fair shot and determined ... TODO
 
-The Vimperator way to do this is with the command [c]:addons[c].  Issuing this
+The Vimperator way to do this is with the command [c]:addons[c]. Issuing this
 command brings up the Firefox Add-ons dialog window; you can then remove it as
 normal, selecting Vimperator from the list and clicking (yes, clicking)
 *Uninstall*.
@@ -239,16 +238,16 @@ as above, with [c]:set go+=m[c], and select *Add-ons* from the *Tools* menu.
 
 section:I'm{nbsp}interested...but{nbsp}lost![support]
 
-Vimperator has an energetic and growing user base.  If you've run into a
+Vimperator has an energetic and growing user base. If you've run into a problem
-problem that you can't seem to solve with Vimperator, or if you think you might
+that you can't seem to solve with Vimperator, or if you think you might have
-have found a bug, please let us know!  There is support available on the
+found a bug, please let us know!  There is support available on the
 http://vimperator.cutup.org/index.php?title=Main_Page[wiki], or in the
 #vimperator IRC channel on http://freenode.net/[freenode].
 
 If you have any feature requests or (even better) offers to help, we'd love to
-hear from you as well.  Developers work on Vimperator whenever possible, but
+hear from you as well. Developers work on Vimperator whenever possible, but we
-we are neither infinite nor omnipotent; please bear with us.  If you can't
+are neither infinite nor omnipotent; please bear with us. If you can't wait for
-wait for us to get around to it, rest assured patches are welcome!  See
+us to get around to it, rest assured patches are welcome! See the
-the help:Developer[developer.html] page for more information.
+help:Developer[developer.html] page for more information.
 
 // vim: set syntax=asciidoc: