changeset 15664:a50ebf4ac764

(outline-auto-activation, outline-layout) (outline-primary-bullet, outline-plain-bullets-string) (outline-distinctive-bullets-string, outline-old-style-prefixes) (outline-stylish-prefixes, outline-file-xref-bullet) (outline-use-hanging-indents, outline-bullets-string) (outline-write-file-hook, outline-mode, outline-prefix-data) (outline-before-change-protect, outline-make-topic-prefix) (outline-rebullet-current-heading, outline-rebullet-heading) (outline-listify-exposed, outline-expose-topic) (outline-old-expose-topic, outline-exposure) (outline-latex-verbatim-quote-curr-line) (outline-show-current-subtree, outline-hide-current-subtree) (outline-hide-current-leaves, outline-new-exposure): Doc fix.
author Karl Heuer <kwzh@gnu.org>
date Sat, 13 Jul 1996 18:46:08 +0000
parents 4f762e6ae80a
children 432750098147
files lisp/allout.el
diffstat 1 files changed, 126 insertions(+), 127 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/allout.el	Sat Jul 13 18:40:22 1996 +0000
+++ b/lisp/allout.el	Sat Jul 13 18:46:08 1996 +0000
@@ -33,19 +33,19 @@
 ;; supporting outline structuring and manipulation of syntax-
 ;; sensitive text, eg programming languages.  (For an example, see the
 ;; allout code itself, which is organized in outline structure.)
-;; 
+;;
 ;; It also includes such things as topic-oriented repositioning, cut, and
 ;; paste; integral outline exposure-layout; incremental search with
 ;; dynamic exposure/concealment of concealed text; automatic topic-number
 ;; maintenance; and many other features.
-;; 
+;;
 ;; See the docstring of the variables `outline-layout' and
 ;; `outline-auto-activation' for details on automatic activation of
 ;; allout outline-mode as a minor mode.  (It has changed since allout
 ;; 3.x, for those of you that depend on the old method.)
 ;;
-;; Note - the lines beginning with ';;;_' are outline topic headers.
-;;        Just 'ESC-x eval-current-buffer' to give it a whirl.
+;; Note - the lines beginning with `;;;_' are outline topic headers.
+;;        Just `ESC-x eval-current-buffer' to give it a whirl.
 
 ;;Ken Manheimer	      				   301 975-3539
 ;;ken.manheimer@nist.gov			   FAX: 301 963-9137
@@ -80,8 +80,8 @@
 With value `ask', auto-mode-activation is enabled, and endorsement for
 performing auto-layout is asked of the user each time.
 
-With value `activate', only auto-mode-activation is enabled, auto-
-layout is not.
+With value `activate', only auto-mode-activation is enabled,
+auto-layout is not.
 
 With value `nil', neither auto-mode-activation nor auto-layout are
 enabled.
@@ -95,9 +95,9 @@
 Buffer-specific.
 
 A list value specifies a default layout for the current buffer, to be
-applied upon activation of allout outline-mode.  Any non-nil value
-will automatically trigger allout outline-mode, provided `outline-
-init' has been called to enable it.
+applied upon activation of allout outline-mode.  Any non-nil value will
+automatically trigger allout outline-mode, provided `outline-init'
+has been called to enable it.
 
 See the docstring for `outline-init' for details on setting up for
 auto-mode-activation, and for `outline-expose-topic' for the format of
@@ -116,10 +116,9 @@
 `\(outline-expose-topic 0 : -1 -1 0\)'.  \(This is the layout used for
 the allout.el, itself.)
 
-Also, allout's mode-specific provisions will make topic prefixes
-default to the comment-start string, if any, of the language of the
-file.  This is modulo the setting of `outline-use-mode-specific-
-leader', which see.") 
+Also, allout's mode-specific provisions will make topic prefixes default
+to the comment-start string, if any, of the language of the file.  This
+is modulo the setting of `outline-use-mode-specific-leader', which see.")
 (make-variable-buffer-local 'outline-layout)
 
 ;;;_  = outline-header-prefix
@@ -140,7 +139,7 @@
 prefix, which is concluded by bullets that includes the value of this
 var and the respective outline-*-bullets-string vars.
 
-The value of an asterisk ('*') provides for backwards compatibility
+The value of an asterisk (`*') provides for backwards compatibility
 with the original emacs outline mode.  See outline-plain-bullets-string
 and outline-distinctive-bullets-string for the range of available
 bullets.")
@@ -150,10 +149,10 @@
 					     "+-:.;,")
   "*The bullets normally used in outline topic prefixes.
 
-See 'outline-distinctive-bullets-string' for the other kind of
+See `outline-distinctive-bullets-string' for the other kind of
 bullets.
 
-DO NOT include the close-square-bracket, ']', as a bullet.
+DO NOT include the close-square-bracket, `]', as a bullet.
 
 Outline mode has to be reactivated in order for changes to the value
 of this var to take effect.")
@@ -167,10 +166,10 @@
 shifting the level of a topic.  See `outline-plain-bullets-string' for
 the selection of alternating bullets.
 
-You must run 'set-outline-regexp' in order for changes
+You must run `set-outline-regexp' in order for changes
 to the value of this var to effect outline-mode operation.
 
-DO NOT include the close-square-bracket, ']', on either of the bullet
+DO NOT include the close-square-bracket, `]', on either of the bullet
 strings.")
 (make-variable-buffer-local 'outline-distinctive-bullets-string)
 
@@ -180,7 +179,7 @@
 
 Allout outline mode will use the mode-specific `outline-mode-leaders'
 and/or comment-start string, if any, to lead the topic prefix string,
-so topic headers look like comments in the programming language. 
+so topic headers look like comments in the programming language.
 
 String values are used as they stand.
 
@@ -194,12 +193,12 @@
 Value `nil' means to always use the default \(`.'\).
 
 comment-start strings that do not end in spaces are tripled, and an
-'_' underscore is tacked on the end, to distinguish them from regular
+`_' underscore is tacked on the end, to distinguish them from regular
 comment strings.  comment-start strings that do end in spaces are not
-tripled, but an underscore is substituted for the space.  \[This
+tripled, but an underscore is substituted for the space.  [This
 presumes that the space is for appearance, not comment syntax.  You
 can use `outline-mode-leaders' to override this behavior, when
-incorrect.\]")
+incorrect.]")
 ;;;_  = outline-mode-leaders
 (defvar outline-mode-leaders '()
   "Specific outline-prefix leading strings per major modes.
@@ -214,7 +213,7 @@
 
 ;;;_  = outline-old-style-prefixes
 (defvar outline-old-style-prefixes nil
-  "*When non-nil, use only old-and-crusty outline-mode '*' topic prefixes.
+  "*When non-nil, use only old-and-crusty outline-mode `*' topic prefixes.
 
 Non-nil restricts the topic creation and modification
 functions to asterix-padded prefixes, so they look exactly
@@ -230,7 +229,7 @@
 Non-nil enables topic creation, modification, and repositioning
 functions to vary the topic bullet char (the char that marks the topic
 depth) just preceding the start of the topic text) according to level.
-Otherwise, only asterisks ('*') and distinctive bullets are used.
+Otherwise, only asterisks (`*') and distinctive bullets are used.
 
 This is how an outline can look (but sans indentation) with stylish
 prefixes:
@@ -282,11 +281,11 @@
   "*Bullet signifying file cross-references, for `outline-resolve-xref'.
 
 Set this var to the bullet you want to use for file cross-references.
-Set it 'nil' if you want to inhibit this capability.")
+Set it to nil if you want to inhibit this capability.")
 
 ;;;_ + LaTeX formatting
 ;;;_  - outline-number-pages
-(defvar outline-number-pages nil 
+(defvar outline-number-pages nil
   "*Non-nil turns on page numbering for LaTeX formatting of an outline.")
 ;;;_  - outline-label-style
 (defvar outline-label-style "\\large\\bf"
@@ -314,7 +313,7 @@
 ;;;_ + Miscellaneous customization
 
 ;;;_  = outline-keybindings-list
-;;; You have to reactivate outline-mode - '(outline-mode t)' - to
+;;; You have to reactivate outline-mode - `(outline-mode t)' - to
 ;;; institute changes to this var.
 (defvar outline-keybindings-list ()
   "*List of outline-mode key / function bindings.
@@ -379,8 +378,8 @@
 relevant mostly for use with indented-text-mode, or other situations
 where auto-fill occurs.
 
-[This feature no longer depends in any way on the 'filladapt.el'
-lisp-archive package.]")
+\[This feature no longer depends in any way on the `filladapt.el'
+lisp-archive package.\]")
 (make-variable-buffer-local 'outline-use-hanging-indents)
 
 ;;;_  = outline-reindent-bodies
@@ -444,9 +443,9 @@
 (defvar outline-bullets-string ""
   "A string dictating the valid set of outline topic bullets.
 
-This var should *not* be set by the user - it is set by 'set-outline-regexp',
-and is produced from the elements of 'outline-plain-bullets-string'
-and 'outline-distinctive-bullets-string'.")
+This var should *not* be set by the user - it is set by `set-outline-regexp',
+and is produced from the elements of `outline-plain-bullets-string'
+and `outline-distinctive-bullets-string'.")
 (make-variable-buffer-local 'outline-bullets-string)
 ;;;_   = outline-bullets-string-len
 (defvar outline-bullets-string-len 0
@@ -457,7 +456,7 @@
   "Outline-regexp with outline-style beginning-of-line anchor.
 
 \(Ie, C-j, *or* C-m, for prefixes of hidden topics).  This is properly
-set when outline-regexp is produced by 'set-outline-regexp', so
+set when outline-regexp is produced by `set-outline-regexp', so
 that (match-beginning 2) and (match-end 2) delimit the prefix.")
 (make-variable-buffer-local 'outline-line-boundary-regexp)
 ;;;_   = outline-bob-regexp
@@ -530,7 +529,7 @@
 		  (and (memq use-leader '(t comment-start))
 		       comment-start
 		       ;; Use comment-start, maybe tripled, and with
-		       ;; underscore: 
+		       ;; underscore:
 		       (concat
 			(if (string= " "
 				     (substring comment-start
@@ -630,12 +629,12 @@
 	    keymap-list)
     map))
 ;;;_   = outline-prior-bindings - being deprecated.
-(defvar outline-prior-bindings nil 
+(defvar outline-prior-bindings nil
   "Variable for use in V18, with outline-added-bindings, for
 resurrecting, on mode deactivation, bindings that existed before
 activation.  Being deprecated.")
 ;;;_   = outline-added-bindings - being deprecated
-(defvar outline-added-bindings nil 
+(defvar outline-added-bindings nil
   "Variable for use in V18, with outline-prior-bindings, for
 resurrecting, on mode deactivation, bindings that existed before
 activation.  Being deprecated.")
@@ -658,7 +657,7 @@
 from the list."
 
   (let ((on-list (assq name outline-mode-prior-settings))
-        prior-capsule                   ; By 'capsule' i mean a list
+        prior-capsule                   ; By `capsule' i mean a list
                                         ; containing a value, so we can
                                         ; distinguish nil from no value.
         )
@@ -721,7 +720,7 @@
 (make-variable-buffer-local 'outline-override-protect)
 ;;;_   > outline-unprotected (expr)
 (defmacro outline-unprotected (expr)
-  "Evaluate EXPRESSION with `outline-override-protect' let-bound 't'."
+  "Evaluate EXPRESSION with `outline-override-protect' let-bound to t."
   (` (let ((outline-override-protect t))
        (, expr))))
 ;;;_   = outline-undo-aggregation
@@ -740,8 +739,8 @@
 (defun outline-write-file-hook ()
   "In outline mode, run as a local-write-file-hooks activity.
 
-Currently just sets 'outline-during-write-cue', so outline-change-
-protection knows to keep inactive during file write."
+Currently just sets `outline-during-write-cue', so outline-change-protection
+knows to keep inactive during file write."
   (setq outline-during-write-cue t)
   nil)
 
@@ -764,11 +763,11 @@
 
 MODE is one of the following symbols:
 
- - nil \(or no argument) deactivate auto-activation/layou;
- - 'activate', enable auto-activation only;
- - 'ask', enable auto-activation, and enable auto-layout but with
+ - nil \(or no argument) deactivate auto-activation/layout;
+ - `activate', enable auto-activation only;
+ - `ask', enable auto-activation, and enable auto-layout but with
    confirmation for layout operation solicited from user each time;
- - 'report', just report and return the current auto-activation state;
+ - `report', just report and return the current auto-activation state;
  - anything else \(eg, t) for auto-activation and auto-layout, without
    any confirmation check.
 
@@ -805,7 +804,7 @@
       ;; convenience aliases, for consistent ref to respective vars:
       ((hook 'outline-find-file-hook)
        (curr-mode 'outline-auto-activation))
-	
+
     (cond ((not mode)
 	   (setq find-file-hooks (delq hook find-file-hooks))
 	   (if (interactive-p)
@@ -816,7 +815,7 @@
 	     ;; Just punt and use the reports from each of the modes:
 	     (outline-init (symbol-value curr-mode))))
 	  (t (add-hook 'find-file-hooks hook)
-	     (set curr-mode		; 'set', not 'setq'!
+	     (set curr-mode		; `set', not `setq'!
 		  (cond ((eq mode 'activate)
 			 (message
 			  "Outline mode auto-activation enabled.")
@@ -832,7 +831,7 @@
 			((message
 			  "Outline mode auto-activation and -layout enabled.")
 			 'full)))))))
-		   
+
 ;;;_  > outline-mode (&optional toggle)
 ;;;_   : Defun:
 (defun outline-mode (&optional toggle)
@@ -884,7 +883,7 @@
 	---------------------------------
 C-c >	outline-shift-in	Shift current topic and all offspring deeper.
 C-c <	outline-shift-out	... less deep.
-C-c<CR>	outline-rebullet-topic	Reconcile bullets of topic and its' offspring
+C-c<CR>	outline-rebullet-topic	Reconcile bullets of topic and its offspring
 				- distinctive bullets are not changed, others
 				  alternated according to nesting depth.
 C-c *	outline-rebullet-current-heading Prompt for alternate bullet for
@@ -962,11 +961,11 @@
 	The immediate offspring of a topic.
 SIBLINGS:
 	Topics having the same parent and depth.
-	       
+
 Topic text constituents:
 
 HEADER:	The first line of a topic, include the topic PREFIX and header
-	text. 
+	text.
 PREFIX: The leading text of a topic which which distinguishes it from
 	normal text.  It has a strict form, which consists of a
 	prefix-lead string, padding, and a bullet.  The bullet may be
@@ -976,7 +975,7 @@
 	The relative length of the PREFIX determines the nesting depth
 	of the topic.
 PREFIX-LEAD:
-	The string at the beginning of a topic prefix, normally a '.'.
+	The string at the beginning of a topic prefix, normally a `.'.
 	It can be customized by changing the setting of
 	`outline-header-prefix' and then reinitializing outline-mode.
 
@@ -989,8 +988,8 @@
 	Spaces or asterisks which separate the prefix-lead and the
 	bullet, according to the depth of the topic.
 BULLET: A character at the end of the topic prefix, it must be one of
-	the characters listed on 'outline-plain-bullets-string' or
-        'outline-distinctive-bullets-string'.  (See the documentation
+	the characters listed on `outline-plain-bullets-string' or
+        `outline-distinctive-bullets-string'.  (See the documentation
         for these variables for more details.)  The default choice of
 	bullet when generating varies in a cycle with the depth of the
 	topic.
@@ -1000,21 +999,21 @@
 
 EXPOSURE:
  	The state of a topic which determines the on-screen visibility
-	of its' offspring and contained text.
+	of its offspring and contained text.
 CONCEALED:
 	Topics and entry text whose display is inhibited.  Contiguous
-	units of concealed text is represented by '...' ellipses.
-	(Ref the 'selective-display' var.)
+	units of concealed text is represented by `...' ellipses.
+	(Ref the `selective-display' var.)
 
 	Concealed topics are effectively collapsed within an ancestor.
 CLOSED:	A topic whose immediate offspring and body-text is concealed.
-OPEN:	A topic that is not closed, though its' offspring or body may be."
+OPEN:	A topic that is not closed, though its offspring or body may be."
 ;;;_    . Code
   (interactive "P")
 
   (let* ((active (and (not (equal major-mode 'outline))
 		     (outline-mode-p)))
-				       ; Massage universal-arg 'toggle' val:
+				       ; Massage universal-arg `toggle' val:
 	 (toggle (and toggle
 		     (or (and (listp toggle)(car toggle))
 			 toggle)))
@@ -1048,7 +1047,7 @@
 	  (string-match "^19.1[89]"	; Bug only known to be in v19.18 and
 			emacs-version)); 19.19.
       t)
-	  
+
      ;; Deactivation:
      ((and (not explicit-activation)
 	  (or active toggle))
@@ -1131,7 +1130,7 @@
 	(use-local-map (produce-outline-mode-map outline-keybindings-list
 						(current-local-map)))
 	)
-		 
+
 				       ; selective-display is the
 				       ; emacs conditional exposure
 				       ; mechanism:
@@ -1200,7 +1199,7 @@
 	  (goto-char 0)
 	  (outline-this-or-next-heading)
 	  (condition-case err
-	      (progn 
+	      (progn
 		(apply 'outline-expose-topic (list outline-layout))
 		(message "Adjusting '%s' exposure... done." (buffer-name)))
 	    ;; Problem applying exposure - notify user, but don't
@@ -1235,7 +1234,7 @@
 (defmacro outline-prefix-data (beg end)
   "Register outline-prefix state data - BEGINNING and END of prefix.
 
-For reference by 'outline-recent' funcs.  Returns BEGINNING."
+For reference by `outline-recent' funcs.  Returns BEGINNING."
   (` (setq outline-recent-prefix-end (, end)
 	   outline-recent-prefix-beginning (, beg))))
 ;;;_  > outline-recent-depth ()
@@ -1366,7 +1365,7 @@
 
   '(if (re-search-forward outline-line-boundary-regexp nil 0)
        (progn				; Got valid location state - set vars:
-	 (outline-prefix-data 
+	 (outline-prefix-data
 	  (goto-char (or (match-beginning 2)
 			 outline-recent-prefix-beginning))
 	  (or (match-end 2) outline-recent-prefix-end)))))
@@ -1390,7 +1389,7 @@
 	 (or (re-search-backward outline-line-boundary-regexp nil 0)
 	     (looking-at outline-bob-regexp))
 	 (progn				; Got valid location state - set vars:
-	   (outline-prefix-data 
+	   (outline-prefix-data
 	    (goto-char (or (match-beginning 2)
 			   outline-recent-prefix-beginning))
 	    (or (match-end 2) outline-recent-prefix-end))))))
@@ -1428,7 +1427,7 @@
 not be specified by external callers.  ORIG-DEPTH is depth of topic at
 starting point, and PREV-DEPTH is depth of prior topic."
 
-  (let ((original (not orig-depth))	; 'orig-depth' set only in recursion.
+  (let ((original (not orig-depth))	; `orig-depth' set only in recursion.
 	chart curr-depth)
 
     (if original			; Just starting?
@@ -1487,14 +1486,14 @@
 			  '(?\n ?\^M))
 		    (forward-char -1))
 	       (setq outline-recent-end-of-subtree (point))))
-    
+
     chart				; (nreverse chart) not necessary,
 					; and maybe not preferable.
     ))
 ;;;_   > outline-chart-siblings (&optional start end)
 (defun outline-chart-siblings (&optional start end)
   "Produce a list of locations of this and succeeding sibling topics.
-Effectively a top-level chart of siblings.  See 'outline-chart-subtree'
+Effectively a top-level chart of siblings.  See `outline-chart-subtree'
 for an explanation of charts."
   (save-excursion
     (if (outline-goto-prefix)
@@ -1549,10 +1548,10 @@
  - bare positive values indicate that this topic header should be
    opened.
  - Lists signify the beginning and end points of regions that should
-   be flagged, and the flag to employ.  (For concealment: '\(\?r\)', and
+   be flagged, and the flag to employ.  (For concealment: `\(\?r\)', and
    exposure:"
   (while spec
-    (cond ((listp spec) 
+    (cond ((listp spec)
 	   )
 	  )
     (setq spec (cdr spec)))
@@ -1908,15 +1907,15 @@
 \(This is for the sake of functions that do change the file during
 writes, like crypt and zip modes.)
 
-Locally bound in outline buffers to 'before-change-function', which
+Locally bound in outline buffers to `before-change-function', which
 in emacs 19 is run before any change to the buffer.  (Has no effect
-in Emacs 18, which doesn't support before-change-function.) 
-
-Any functions which set ['this-command' to 'undo', or which set]
-'outline-override-protect' non-nil (as does, eg, outline-flag-chars)
+in Emacs 18, which doesn't support before-change-function.)
+
+Any functions which set [`this-command' to `undo', or which set]
+`outline-override-protect' non-nil (as does, eg, outline-flag-chars)
 are exempt from this restriction."
   (if (and (outline-mode-p)
-					; outline-override-protect 
+					; outline-override-protect
 					; set by functions that know what
 					; they're doing, eg outline internals:
 	   (not outline-override-protect)
@@ -1951,7 +1950,7 @@
 		(rehide-completely (save-excursion (outline-goto-prefix)
 						   (outline-hidden-p)))
 		rehide-place)
-				       
+
 	    (save-excursion
 	      (if (condition-case err
 		      ;; Condition case to catch keyboard quits during reads.
@@ -1966,7 +1965,7 @@
 					; until they respond:
 					; Then interpret the response:
 			(while
-			    (progn 
+			    (progn
 			      (message (concat "Change inside concealed"
 					       " region - do it? "
 					       "(n or 'y'/'r'eclose)"))
@@ -1981,7 +1980,7 @@
 				      t)
 				     ((eq response ??)
 				      (message
-				       "'r' means 'yes, then reclose")
+				       "`r' means `yes, then reclose'")
 				      nil)
 				     (t (message "Please answer y, n, or r")
 					(sit-for 1)
@@ -2092,7 +2091,7 @@
 	   outline-mode
 	   (eq this-command 'self-insert-command)
 	   (eq (point)(outline-current-bullet-pos)))
-	   
+
       (let* ((this-key-num (if (numberp last-command-event)
 			       last-command-event))
 	     mapped-binding)
@@ -2222,7 +2221,7 @@
 choice among the valid bullets.  (This overrides other all the
 options, including, eg, a distinctive PRIOR-BULLET.)
 
-Fifth arg, NUMBER-CONTROL, matters only if 'outline-numbered-bullet'
+Fifth arg, NUMBER-CONTROL, matters only if `outline-numbered-bullet'
 is non-nil *and* soliciting was not explicitly invoked.  Then
 NUMBER-CONTROL non-nil forces prefix to either numbered or
 denumbered format, depending on the value of the sixth arg, INDEX.
@@ -2388,7 +2387,7 @@
                                         ; Positioning and vertical
                                         ; padding - only if not
                                         ; opening-on-blank:
-        (progn 
+        (progn
           (goto-char ref-topic)
           (setq dbl-space               ; Determine double space action:
                 (or (and (<= relative-depth 0)	; not descending;
@@ -2495,7 +2494,7 @@
 ;;;_     ; buffer boundaries - special provisions for beginning and end ob
 ;;;_     ; level 1 topics have special provisions also - double space.
 ;;;_     ; location of new topic
-;;;_    . 
+;;;_    .
 ;;;_   > outline-open-subtopic (arg)
 (defun outline-open-subtopic (arg)
   "Open new topic header at deeper level than the current one.
@@ -2563,7 +2562,7 @@
 	   ;; *before* the prefix was changed, so we infer it relative
 	   ;; to the new margin and the shift in depth:
 	   (old-margin (+ old-depth (- new-margin new-depth))))
-             
+
       ;; Process lines up to (but excluding) next topic header:
       (outline-unprotected
        (save-match-data
@@ -2572,7 +2571,7 @@
 				     nil
 				     t)
 		  ;; Register the indent data, before we reset the
-		  ;; match data with a subsequent 'looking-at':
+		  ;; match data with a subsequent `looking-at':
 		  (setq old-indent-begin (match-beginning 1)
 			old-indent-end (match-end 1))
 		  (not (looking-at outline-regexp)))
@@ -2587,7 +2586,7 @@
 	     (indent-to (+ new-margin excess)))))))))
 ;;;_    > outline-rebullet-current-heading (arg)
 (defun outline-rebullet-current-heading (arg)
-  "Like non-interactive version 'outline-rebullet-heading'.
+  "Like non-interactive version `outline-rebullet-heading'.
 
 But \(only\) affects visible heading containing point.
 
@@ -2621,7 +2620,7 @@
 of the topics current depth.
 
 Third arg NUMBER-CONTROL can force the prefix to or away from
-numbered form.  It has effect only if 'outline-numbered-bullet' is
+numbered form.  It has effect only if `outline-numbered-bullet' is
 non-nil and soliciting was not explicitly invoked (via first arg).
 Its effect, numbering or denumbering, then depends on the setting
 of the forth arg, INDEX.
@@ -2637,8 +2636,8 @@
 Fifth arg DO-SUCCESSORS t means re-resolve count on succeeding
 siblings.
 
-Cf vars 'outline-stylish-prefixes', 'outline-old-style-prefixes',
-and 'outline-numbered-bullet', which all affect the behavior of
+Cf vars `outline-stylish-prefixes', `outline-old-style-prefixes',
+and `outline-numbered-bullet', which all affect the behavior of
 this function."
 
   (let* ((current-depth (outline-depth))
@@ -2922,7 +2921,7 @@
 		  (and (outline-next-heading)
 		       (>= (outline-recent-depth) depth))))
 	    (forward-char 1)))
-	
+
     (kill-region beg (point))
     (sit-for 0)
     (save-excursion
@@ -2955,12 +2954,12 @@
       (exchange-point-and-mark))
   (let* ((subj-beg (point))
 	 (subj-end (mark-marker))
-	 ;; 'resituate' if yanking an entire topic into topic header:
+	 ;; `resituate' if yanking an entire topic into topic header:
 	 (resituate (and (outline-e-o-prefix-p)
 			 (looking-at (concat "\\(" outline-regexp "\\)"))
 			 (outline-prefix-data (match-beginning 1)
 					      (match-end 1))))
-	 ;; 'rectify-numbering' if resituating (where several topics may
+	 ;; `rectify-numbering' if resituating (where several topics may
 	 ;; be resituating) or yanking a topic into a topic slot (bol):
 	 (rectify-numbering (or resituate
 				(and (bolp) (looking-at outline-regexp)))))
@@ -3039,7 +3038,7 @@
 		  (if (looking-at " ") (delete-char 1))))
 	    (exchange-point-and-mark))))
     (if rectify-numbering
-	(progn 
+	(progn
 	  (save-excursion
                                         ; Give some preliminary feedback:
 	    (message "... reconciling numbers") (sit-for 0)
@@ -3113,9 +3112,9 @@
   (interactive)
   (if (not outline-file-xref-bullet)
       (error
-       "outline cross references disabled - no 'outline-file-xref-bullet'")
+       "outline cross references disabled - no `outline-file-xref-bullet'")
     (if (not (string= (outline-current-bullet) outline-file-xref-bullet))
-        (error "current heading lacks cross-reference bullet '%s'"
+        (error "current heading lacks cross-reference bullet `%s'"
                outline-file-xref-bullet)
       (let (file-name)
         (save-excursion
@@ -3128,7 +3127,7 @@
         (setq file-name
               (if (not (= (aref file-name 0) ?:))
                   (expand-file-name file-name)
-                                        ; A registry-files ref, strip the ':'
+                                        ; A registry-files ref, strip the `:'
                                         ; and try to follow it:
                 (let ((reg-ref (reference-registered-file
                                 (substring file-name 1) nil t)))
@@ -3181,7 +3180,7 @@
 
   "Produce a list representing exposed topics in current region.
 
-This list can then be used by 'outline-process-exposed' to manipulate
+This list can then be used by `outline-process-exposed' to manipulate
 the subject region.
 
 List is composed of elements that may themselves be lists representing
@@ -3189,7 +3188,7 @@
 
 Each component list contains:
  - a number representing the depth of the topic,
- - a string representing the header-prefix (ref. 'outline-header-prefix'),
+ - a string representing the header-prefix (ref. `outline-header-prefix'),
  - a string representing the bullet character,
  - and a series of strings, each containing one line of the exposed
    portion of the topic entry."
@@ -3198,7 +3197,7 @@
   (save-excursion
     (let* (strings pad result depth bullet beg next done) ; State vars.
       (goto-char start)
-      (beginning-of-line)		
+      (beginning-of-line)
       (if (not (outline-goto-prefix))	; Get initial position within a topic:
 	  (outline-next-visible-heading 1))
       (while (and (not done)
@@ -3361,7 +3360,7 @@
 
   (interactive "p")
   ;;(beep)
-  ;;(message (format "Use '%s' instead of '%s' (%s)."
+  ;;(message (format "Use `%s' instead of `%s' (%s)."
   ;;		   "outline-show-children"
   ;;		   "outline-show-current-children"
   ;;		   (buffer-name (current-buffer))))
@@ -3452,7 +3451,7 @@
 ;;;_   > outline-show-current-subtree (&optional arg)
 (defun outline-show-current-subtree (&optional arg)
   "Show everything within the current topic.  With a repeat-count,
-expose this topic and its' siblings."
+expose this topic and its siblings."
   (interactive "P")
   (save-excursion
     (if (<= (outline-current-depth) 0)
@@ -3471,7 +3470,7 @@
   "Close the current topic, or containing topic if this one is already closed.
 
 If this topic is closed and it's a top level topic, close this topic
-and its' siblings.
+and its siblings.
 
 If optional arg JUST-CLOSE is non-nil, do not treat the parent or
 siblings, even if the target topic is already closed."
@@ -3510,7 +3509,7 @@
   (outline-show-children t))
 ;;;_   > outline-hide-current-leaves ()
 (defun outline-hide-current-leaves ()
-  "Hide the bodies of the current topic and all its' offspring."
+  "Hide the bodies of the current topic and all its offspring."
   (interactive)
   (outline-back-to-current-heading)
   (outline-hide-region-body (point) (progn (outline-end-of-current-subtree)
@@ -3565,9 +3564,9 @@
 Non-null lists recursively designate exposure specs for respective
 subtopics of the current topic.
 
-The ':' repeat spec is used to specify exposure for any number of
+The `:' repeat spec is used to specify exposure for any number of
 successive siblings, up to the trailing ones for which there are
-explicit specs following the ':'.
+explicit specs following the `:'.
 
 Simple (numeric and null-list) specs are interpreted as follows:
 
@@ -3578,9 +3577,9 @@
      - positive numbers open to the relative depth indicated by the
        number, but do not force already opened subtopics to be closed.
      - 0 means to close topic - hide all offspring.
-  :  - 'repeat'
+  :  - `repeat'
        apply prior element to all siblings at current level, *up to*
-       those siblings that would be covered by specs following the ':'
+       those siblings that would be covered by specs following the `:'
        on the list.  Ie, apply to all topics at level but the last
        ones.  \(Only first of multiple colons at same level is
        respected - subsequent ones are discarded.)
@@ -3627,7 +3626,7 @@
 		((eq curr-elem '-) (outline-show-current-entry))
 		((eq curr-elem ':)
 		 (setq stay t)
-		 ;; Expand the 'repeat' spec to an explicit version,
+		 ;; Expand the `repeat' spec to an explicit version,
 		 ;; w.r.t. remaining siblings:
 		 (let ((residue	   ; = # of sibs not covered by remaining spec
 			;; Dang - could be nice to make use of the chart, sigh:
@@ -3685,9 +3684,9 @@
     absolute value of the number.
   - positive numbers just open to the relative depth indicated by the number.
   - 0 just closes
- - '*' completely opens the topic, including bodies.
- - '+' shows all the sub headers, but not the bodies
- - '-' exposes the body and immediate offspring of the corresponding topic.
+ - `*' completely opens the topic, including bodies.
+ - `+' shows all the sub headers, but not the bodies
+ - `-' exposes the body and immediate offspring of the corresponding topic.
 
 If the spec is a list, the first element must be a number, which
 dictates the exposure depth of the topic as a whole.  Subsequent
@@ -3747,7 +3746,7 @@
 
 Cursor is left at start position.
 
-Use this instead of obsolete 'outline-exposure'.
+Use this instead of obsolete `outline-exposure'.
 
 Examples:
 \(outline-exposure (-1 () () () 1) 0)
@@ -3757,7 +3756,7 @@
 \(outline-exposure : -1 0)
 	Close all topics at current level to expose only their
 	immediate children, except for the last topic at the current
-	level, in which even its' immediate children are hidden.
+	level, in which even its immediate children are hidden.
 \(outline-exposure -2 : -1 *)
         Expose children and grandchildren of first topic at current
 	level, and expose children of subsequent topics at current
@@ -3769,7 +3768,7 @@
 	(list 'outline-expose-topic (list 'quote spec))))
 ;;;_   > outline-exposure '()
 (defmacro outline-exposure (&rest spec)
-  "Being deprecated - use more recent 'outline-new-exposure' instead.
+  "Being deprecated - use more recent `outline-new-exposure' instead.
 
 Literal frontend for `outline-old-expose-topic', doesn't evaluate arguments
 and retains start position."
@@ -3794,7 +3793,7 @@
 Used by isearch-terminate/outline-provisions and
 isearch-done/outline-provisions")
 
-           
+
 ;;;_  > outline-enwrap-isearch ()
 (defun outline-enwrap-isearch ()
   "Impose outline-mode isearch-mode wrappers for dynamic exposure in isearch.
@@ -3817,7 +3816,7 @@
                                         ; Ensure load of isearch-mode:
     (if (or (and (fboundp 'isearch-mode)
                  (fboundp 'isearch-quote-char))
-            (condition-case error 
+            (condition-case error
                 (load-library outline-enwrap-isearch-mode)
               (file-error (message "Skipping isearch-mode provisions - %s '%s'"
                                    (car (cdr error))
@@ -3827,17 +3826,17 @@
                           (setq outline-enwrap-isearch-mode nil))))
         ;; Isearch-mode loaded, encapsulate specific entry points for
         ;; outline dynamic-exposure business:
-        (progn 
-                
+        (progn
+
 	  ;; stash crucial isearch-mode funcs under known, private
 	  ;; names, then register wrapper functions under the old
-	  ;; names, in their stead: 'isearch-quit' is pre isearch v 1.2.
+	  ;; names, in their stead: `isearch-quit' is pre isearch v 1.2.
           (fset 'real-isearch-terminate
-                                        ; 'isearch-quit is pre v 1.2:
+                                        ; `isearch-quit' is pre v 1.2:
                 (or (if (fboundp 'isearch-quit)
                         (symbol-function 'isearch-quit))
                     (if (fboundp 'isearch-abort)
-                                        ; 'isearch-abort' is v 1.2 and on:
+                                        ; `isearch-abort' is v 1.2 and on:
                         (symbol-function 'isearch-abort))))
           (fset 'isearch-quit 'isearch-terminate/outline-provisions)
           (fset 'isearch-abort 'isearch-terminate/outline-provisions)
@@ -4008,7 +4007,7 @@
   "Express line for exact \(literal\) representation across latex processing.
 
 Adjust line contents so it is unaltered \(from the original line)
-across latex processing, within the context of a 'verbatim'
+across latex processing, within the context of a `verbatim'
 environment.  Leaves point at the end of the line."
   (beginning-of-line)
   (let ((beg (point))
@@ -4112,7 +4111,7 @@
 	 (curr-line)
 	 body-content bop)
 					; Do the head line:
-    (insert-string (concat "\\OneHeadLine{\\verb\1 " 
+    (insert-string (concat "\\OneHeadLine{\\verb\1 "
 			   (outline-latex-verb-quote bullet)
 			   "\1}{"
 			   depth
@@ -4240,7 +4239,7 @@
       (message "%s" new-prompt)
 
       ;; We do our own reading here, so we can circumvent, eg, special
-      ;; treatment for '?' character.  (Might oughta change minibuffer
+      ;; treatment for `?' character.  (Might oughta change minibuffer
       ;; keymap instead, oh well.)
       (setq got
             (char-to-string (let ((cursor-in-echo-area nil)) (read-char))))
@@ -4291,7 +4290,7 @@
 (if (not (fboundp 'add-hook))
     (defun add-hook (hook function &optional append)
       "Add to the value of HOOK the function FUNCTION unless already present.
-\(It becomes the first hook on the list unless optional APPEND is non-nil, in 
+\(It becomes the first hook on the list unless optional APPEND is non-nil, in
 which case it becomes the last).  HOOK should be a symbol, and FUNCTION may be
 any valid function.  HOOK's value should be a list of functions, not a single
 function.  If HOOK is void, it is first set to nil."
@@ -4302,7 +4301,7 @@
 	      (let ((tail (assoc (cdr function) (symbol-value hook))))
 		(equal function tail))
 	    (memq function (symbol-value hook)))
-	  (set hook 
+	  (set hook
 	       (if append
 		   (nconc (symbol-value hook) (list function))
 		 (cons function (symbol-value hook)))))))
@@ -4316,7 +4315,7 @@
       (setq bullet (solicit-char-in-string
 		    "ISearch for topic with bullet: "
 		    (regexp-sans-escapes outline-bullets-string))))
-       
+
   (let ((isearch-regexp t)
 	(isearch-string (concat "^"
 				outline-header-prefix
@@ -4325,7 +4324,7 @@
     (isearch-repeat 'forward)
     (isearch-mode t)))
 ;;;_  ? Re hooking up with isearch - use isearch-op-fun rather than
-;;;	wrapping the isearch functions. 
+;;;	wrapping the isearch functions.
 
 ;;;_* Local emacs vars.
 ;;; The following `outline-layout' local variable setting: