doc: Re-indent and re-fill paragraph.

* doc/user/emacs.skb: Re-indent and re-fill paragraph. Start block
comments with double semicolons. Replace double spaces between
sentences with a single space.

1 files changed, 38 insertions, 37 deletions

diff --git a/doc/user/emacs.skb b/doc/user/emacs.skb
index 1cb3c5a..5e6354b 100644
--- a/doc/user/emacs.skb
+++ b/doc/user/emacs.skb
@@ -20,62 +20,63 @@
 ;;; You should have received a copy of the GNU General Public License
 ;;; along with Skribilo.  If not, see <http://www.gnu.org/licenses/>.
 
-;*---------------------------------------------------------------------*/
-;*    Editing Skribilo programs                                        */
-;*---------------------------------------------------------------------*/
+;;*---------------------------------------------------------------------*/
+;;*    Editing Skribilo programs                                        */
+;;*---------------------------------------------------------------------*/
 (chapter :title [Editing Skribilo Programs]
-   
-   (p [Skribilo documents can be typed in.  The ,(tt [outline]) syntax
+
+  (p [Skribilo documents can be typed in.  The ,(tt [outline]) syntax
 (see ,(numref :text [Section] :ident "outline-syntax")) can be easily
 typed in with any editor, although the Outline and Org modes found in
 GNU,(~)Emacs and XEmacs make it more convenient to deal with this
-format.  For instance, they allow section contents to be hidden, leaving
-only the section headings visible; Org Mode can also highlight forms
-that denote emphasis, and provide proper display of Org-Mode-style
-hyperlinks (well, not surprisingly).])
+format. For instance, they allow section contents to be hidden,
+leaving only the section headings visible; Org Mode can also highlight
+forms that denote emphasis, and provide proper display of
+Org-Mode-style hyperlinks (well, not surprisingly).])
 
-   (p [When using the Skribe syntax (see ,(numref :text [Section] :ident
-"skribe-syntax")), it is highly recommended to use ,(ref :url
+  (p [When using the Skribe syntax (see ,(numref :text [Section]
+:ident "skribe-syntax")), it is highly recommended to use ,(ref :url
 *emacs-url* :text "GNU Emacs") or ,(ref :url *xemacs-url* :text
-"XEmacs").  In addition to parentheses matching, these editors provide
+"XEmacs"). In addition to parentheses matching, these editors provide
 syntax highlighting (or ``fontification'') through the Skribe Mode
 described below.])
 
-;*---------------------------------------------------------------------*/
-;*    Skribe emacs mode                                                */
-;*---------------------------------------------------------------------*/
-(section :title "Skribe Emacs Mode"
+  ;;*---------------------------------------------------------------------*/
+  ;;*    Skribe emacs mode                                                */
+  ;;*---------------------------------------------------------------------*/
+  (section :title "Skribe Emacs Mode"
 
-(index "emacs" :note "skribe mode")
+    (index "emacs" :note "skribe mode")
 
-(p [The Skribilo distribution contains a minor mode dedicated to Skribe
-edition originally written by Manuel Serrano.  This mode provides ,(emph
-"fontification") and indentation of Skribe programs.  In this manual, we
-present the two most important key bindings specific to this mode:
+    (p [The Skribilo distribution contains a minor mode dedicated to
+Skribe edition originally written by Manuel Serrano.  This mode
+provides ,(emph "fontification") and indentation of Skribe programs.
+In this manual, we present the two most important key bindings
+specific to this mode:
 
-,(itemize (item [,(color :fg "#007700" (kbd "tab")) indents the current line.])
-	  (item [,(color :fg "#007700" (kbd "M-C-q")) indents a whole Skribe
+,(itemize (item [,(color :fg "#007700" (kbd "tab")) indents the
+current line.])
+(item [,(color :fg "#007700" (kbd "M-C-q")) indents a whole Skribe
 expression.]))])
 
-(p [To use the Skribe/Skribilo Emacs mode, you need to tell Emacs that
-when the Emacs Lisp ,(tt "skribe-mode") function is needed it has to
-be loaded from the ,(tt "skribe.el") file:])
+    (p [To use the Skribe/Skribilo Emacs mode, you need to tell Emacs
+that when the Emacs Lisp ,(tt "skribe-mode") function is needed it has
+to be loaded from the ,(tt "skribe.el") file:])
 
 
-(disp :verb #t (source :language lisp [
-(autoload 'skribe-mode "skribe.el" "Skribe mode." t)]))
+    (disp :verb #t
+      (source :language lisp
+        [(autoload 'skribe-mode "skribe.el" "Skribe mode." t)]))
 
-(p [The ,(tt "skribe.el") file must in the path described by the Emacs Lisp
-,(tt "load-path") variable.])
+    (p [The ,(tt "skribe.el") file must in the path described by the
+Emacs Lisp ,(tt "load-path") variable.])
 
-(p [The ,(code "skribe") mode is a minor mode. It is intended to be
-used with a Lisp or Scheme mode. Hence, to use the ,(code "skribe") mode
-you will have to use the following Emacs commands:])
+    (p [The ,(code "skribe") mode is a minor mode. It is intended to
+be used with a Lisp or Scheme mode. Hence, to use the ,(code "skribe")
+mode you will have to use the following Emacs commands:])
 
-(disp :verb #t (source :language lisp [
-M-x scheme-mode
-M-x skribe-mode
-]))))
+    (disp :verb #t (source :language lisp [M-x scheme-mode
+M-x skribe-mode]))))
 
 ;;; Local Variables:
 ;;; ispell-local-dictionary: "american"