Doc cleanups (#22)

* First batch of doc cleanups

* zsh{,db} -> bash{,db} and other doc fixes

* zsh{,db} -> bash{,db} and other doc fixes

* Gratuituous change to get readthe docs to reread?

* Go over docs. Sync with zshdb..

command/skip.sh

@@ -22,7 +22,7 @@
 _Dbg_help_add skip \
 "**skip** [*count*]
 
-Skip (don't run) the next *count* command(s).
+Skip over (don't run) the next *count* command(s).
 
 If *count* is given, stepping occurs that many times before
 stopping. Otherwise *count* is one. *count* can be an arithmetic
@@ -36,7 +36,7 @@ in:
       echo not skipped
    fi
 
-skipping the *if* statement will in effect skip running the *grep*
+Skipping the *if* statement will, in effect, skip running the *grep*
 command. Since the return code is 0 when skipped, the *if* body is
 entered. Similarly the same thing can  happen in a *while* statement
 test.

command/step.sh

@@ -38,13 +38,13 @@ expression.
 If suffix \"+\" is added, we ensure that the file and line position is
 different from the last one just stopped at.
 
-However in contrast to \"next\", functions and source'd files are stepped
-into.
-
 If suffix \"-\" is added, the different line aspect of \"step+\" does not occur.
 
 With no suffix is given, the behavior is dictated by the setting of **set different**.
 
+In contrast to \"next\", functions and source'd files are stepped
+into.
+
 Examples:
 ---------
 

docs/commands/running/continue.rst

@@ -1,7 +1,7 @@
 .. index:: continue
 .. _continue:
 
-Continue Program Execution (`continue`)
+Continue Program Execution (``continue``)
 ---------------------------------------
 
 **continue** [ *loc* | **-*** ]

docs/commands/running/quit.rst

@@ -1,9 +1,8 @@
 .. index:: quit
 .. _quit:
 
-Gentle Termination (`quit`)
----------------------------
-
+Gentle Termination (``quit``)
+-----------------------------
 **quit** [*exit-code* [*shell-levels*]]
 
 The program being debugged is aborted.  If *exit-code* is given, then
@@ -13,4 +12,6 @@ of those shells should have been run under the debugger.
 
 .. seealso::
 
-   :ref:`kill <kill>` or `kill` for more forceful termination commands. :ref:`run <run>` restarts the debugged program.
+
+   :ref:`kill <kill>` for more forceful termination commands. :ref:`run <run>` restarts the debugged program.
+

docs/commands/running/run.rst

@@ -1,8 +1,8 @@
 .. index:: run
 .. _run:
 
-Restart Program (`run`)
------------------------
+Restart Program (``run``)
+-------------------------
 
 **run** [*args*]
 

docs/commands/running/step.rst

@@ -20,7 +20,7 @@ into.
 
 If suffix \"-\" is added, the different line aspect of \"step+\" does not occur.
 
-With no suffix is given, the behavior is dictated by the setting of **set different**.
+With no suffix given, the behavior is dictated by the setting of **set different**.
 
 Examples:
 +++++++++