From 1fe5d33ecafb81a091dbab50aae01acf70508716 Mon Sep 17 00:00:00 2001 From: Arun Isaac Date: Fri, 1 Oct 2021 23:27:14 +0530 Subject: 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. --- doc/user/emacs.skb | 75 +++++++++++++++++++++++++++--------------------------- 1 file 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 . -;*---------------------------------------------------------------------*/ -;* 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" -- cgit v1.2.3