diff lisp/nxml/nxml-outln.el @ 96496:e374c747704b

Fix typos, and general docstring cleanup. * nxml/nxml-glyph.el (nxml-glyph-set-hook): * nxml/nxml-uchnm.el (nxml-unicode-blocks) (nxml-unicode-block-char-name-set): * nxml/nxml-util.el (nxml-debug, nxml-make-namespace): * nxml/rng-nxml.el (rng-set-state-after): * nxml/rng-uri.el (rng-file-name-uri): Fix typo in docstring. * nxml/rng-cmpct.el (rng-c-lookup-create, rng-c-parse-primary) (rng-c-parse-annotation-body): * nxml/rng-dt.el (rng-dt-namespace-context-getter): Reflow docstrings. * nxml/nxml-mode.el (nxml, nxml-mode, nxml-after-change1) (nxml-extend-region, nxml-merge-indent-context-type, nxml-complete) (nxml-forward-balanced-item, nxml-dynamic-markup-word) (nxml-define-char-name-set, nxml-toggle-char-ref-extra-display): Fix typos in docstrings. (nxml-attribute-indent): Reflow docstring. (nxml-bind-meta-tab-to-complete-flag, nxml-last-fontify-end) (nxml-default-buffer-file-coding-system): Doc fixes. * nxml/nxml-ns.el (nxml-ns-state, nxml-ns-initial-state) (nxml-ns-set-prefix): Fix typos in docstrings. (nxml-ns-push-state, nxml-ns-pop-state, nxml-ns-set-default): Reflow docstring. (nxml-ns-get-prefix, nxml-ns-get-default): Doc fixes. * nxml/nxml-outln.el (nxml-hide-all-text-content) (nxml-show-direct-text-content, nxml-show-direct-subheadings) (nxml-hide-direct-text-content, nxml-hide-subheadings) (nxml-hide-text-content, nxml-show-subheadings, nxml-hide-other) (nxml-outline-display-rest, nxml-outline-set-overlay) (nxml-section-tag-forward, nxml-section-tag-backward) (nxml-back-to-section-start): Fix typos in docstrings. * nxml/nxml-parse.el (nxml-validate-function, nxml-parse-file): Doc fixes. * nxml/nxml-rap.el (nxml-scan-end, nxml-move-tag-backwards) (nxml-scan-element-forward, nxml-scan-element-backward): Doc fixes. (nxml-scan-after-change): Fix typo in docstring. * nxml/rng-match.el (rng-being-compiled, rng-normalize-choice-list) (rng-name-class-possible-names): Doc fixes. (rng-memo-map-add, rng-intern-group, rng-match-possible-namespace-uris) (rng-match-possible-start-tag-names, rng-match-possible-value-strings): Fix typos in docstrings. (rng-intern-group-shortcut, rng-intern-choice-shortcut): Reflow docstrings. * nxml/rng-util.el (rng-uniquify-eq, rng-uniquify-equal): Doc fixes. (rng-substq, rng-complete-before-point): Fix typos in docstrings. * nxml/rng-xsd.el (rng-xsd-make-date-time-regexp) (rng-xsd-convert-date-time): Reflow docstrings. (rng-xsd-compile): Fix typo in docstring. * nxml/rng-loc.el (rng-current-schema-file-name) (rng-locate-schema-file-using, rng-locate-schema-file-from-type-id): Doc fixes. (rng-set-schema-file): Fix typo in docstring. * nxml/rng-valid.el (rng-error-count, rng-validate-mode) (rng-do-some-validation, rng-process-start-tag, rng-process-text): Fix typos in docstrings. (rng-message-overlay, rng-conditional-up-to-date-start) (rng-conditional-up-to-date-end): Doc fixes. (rng-next-error, rng-previous-error): Reflow docstrings. * nxml/xmltok.el (xmltok-attribute-raw-normalized-value): Doc fix. (xmltok-dtd, xmltok-dependent-regions, xmltok-attribute-refs) (xmltok-valid-char-p, xmltok-standalone, xmltok-forward-prolog) (xmltok-merge-attributes): Fix typos in docstrings. (xmltok-make-attribute, xmltok-forward-special) (xmltok-get-declared-encoding-position): Reflow docstrings. * nxml/xsd-regexp.el (xsdre-char-class-to-range-list): Doc fix. (xsdre-range-list-union, xsdre-check-range-list, xsdre-current-regexp): Fix typos in docstrings.

--- a/lisp/nxml/nxml-outln.el	Wed Jul 02 16:23:35 2008 +0000
+++ b/lisp/nxml/nxml-outln.el	Thu Jul 03 12:25:23 2008 +0000
@@ -161,7 +161,7 @@
 (defun nxml-hide-all-text-content ()
   "Hide all text content in the buffer.
 Anything that is in a section but is not a heading will be hidden.
-The visibility of headings at any level will not be changed. See the
+The visibility of headings at any level will not be changed.  See the
 variable `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -170,8 +170,8 @@
 (defun nxml-show-direct-text-content ()
   "Show the text content that is directly part of the section containing point.
 Each subsection will be shown according to its individual state, which
-will not be changed. The section containing point is the innermost
-section that contains the character following point. See the variable
+will not be changed.  The section containing point is the innermost
+section that contains the character following point.  See the variable
 `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -183,7 +183,7 @@
 (defun nxml-show-direct-subheadings ()
   "Show the immediate subheadings of the section containing point.
 The section containing point is the innermost section that contains
-the character following point. See the variable
+the character following point.  See the variable
 `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -197,7 +197,7 @@
   "Hide the text content that is directly part of the section containing point.
 The heading of the section will remain visible.  The state of
 subsections will not be changed.  The section containing point is the
-innermost section that contains the character following point. See the
+innermost section that contains the character following point.  See the
 variable `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -212,7 +212,7 @@
 The text content will also be hidden, leaving only the heading of the
 section itself visible.  The state of the subsections will also be
 changed to hide their headings, so that \\[nxml-show-direct-text-content]
-would show only the heading of the subsections. The section containing
+would show only the heading of the subsections.  The section containing
 point is the innermost section that contains the character following
 point.  See the variable `nxml-section-element-name-regexp' for more
 details on how to customize which elements are recognized as sections
@@ -235,7 +235,7 @@
 (defun nxml-hide-text-content ()
   "Hide text content at all levels in the section containing point.
 The section containing point is the innermost section that contains
-the character following point. See the variable
+the character following point.  See the variable
 `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -245,7 +245,7 @@
   "Show the subheadings at all levels of the section containing point.
 The visibility of the text content at all levels in the section is not
 changed.  The section containing point is the innermost section that
-contains the character following point. See the variable
+contains the character following point.  See the variable
 `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -255,7 +255,7 @@
   "Hide text content other than that directly in the section containing point.
 Hide headings other than those of ancestors of that section and their
 immediate subheadings.  The section containing point is the innermost
-section that contains the character following point. See the variable
+section that contains the character following point.  See the variable
 `nxml-section-element-name-regexp' for more details on how to
 customize which elements are recognized as sections and headings."
   (interactive)
@@ -349,7 +349,7 @@
     (when change
       (nxml-set-outline-state section-start-pos
 			      (cdr change)))))
-  
+
 (defun nxml-section-tag-transform-outline-state (startp
 						 section-start-pos
 						 &optional
@@ -418,7 +418,7 @@
   (or (eq xmltok-type 'end-tag)
       (eq xmltok-type 'partial-end-tag)))
 
-(defun nxml-refresh-outline () 
+(defun nxml-refresh-outline ()
   "Refresh the outline to correspond to the current XML element structure."
   (interactive)
   (save-excursion
@@ -438,7 +438,7 @@
 indent of the start-tag of the current element, or nil if no
 containing element has a non-nil OUTLINE-STATE.  TAG-QNAMES is a list
 of the qnames of the open elements.  Point is after the title content.
-Leave point after the closing end-tag Return t if we had a
+Leave point after the closing end-tag.  Return t if we had a
 non-transparent child section."
   (let ((last-pos (point))
 	(transparent-depth 0)
@@ -661,7 +661,7 @@
 					 t)
 	       'display
 	       nxml-highlighted-empty-end-tag))
-    
+
 (defun nxml-outline-display-multi-line-end-tag (last-pos start-tag-indent)
   (let ((indentp (save-excursion
 		   (goto-char last-pos)
@@ -765,12 +765,12 @@
 				 &optional
 				 front-advance
 				 rear-advance)
-  "Replace any nxml-outline-display overlays between START and END.
+  "Replace any `nxml-outline-display' overlays between START and END.
 Overlays are removed if they overlay the region between START and END,
-and have a non-nil nxml-outline-display property (typically via their
-category). If CATEGORY is non-nil, they will be replaced with a new overlay
-with that category from START to END. If CATEGORY is nil, no new
-overlay will be created."
+and have a non-nil `nxml-outline-display' property (typically via their
+category).  If CATEGORY is non-nil, they will be replaced with a new
+overlay with that category from START to END.  If CATEGORY is nil,
+no new overlay will be created."
   (when (< start end)
     (let ((overlays (overlays-in start end))
 	  overlay)
@@ -837,7 +837,7 @@
 
 (defun nxml-section-tag-forward ()
   "Move forward past the first tag that is a section start- or end-tag.
-Return xmltok-type for tag.
+Return `xmltok-type' for tag.
 If no tag found, return nil and move to the end of the buffer."
   (let ((case-fold-search nil)
 	(tag-regexp (nxml-make-section-tag-regexp))
@@ -866,10 +866,10 @@
 		  nil)
 		 (t))))
     xmltok-type)
-	 
+
 (defun nxml-section-tag-backward ()
   "Move backward to the end of a tag that is a section start- or end-tag.
-The position of the end of the tag must be <= point
+The position of the end of the tag must be <= point.
 Point is at the end of the tag.  `xmltok-start' is the start."
   (let ((case-fold-search nil)
 	(start (point))
@@ -922,7 +922,7 @@
   "Try to move back to the start of the section containing point.
 The start of the section must be <= point.
 Only visible sections are included unless INVISIBLE-OK is non-nil.
-If found, return t.  Otherwise move to point-min and return nil.
+If found, return t.  Otherwise move to `point-min' and return nil.
 If unbalanced section tags are found, signal an `nxml-outline-error'."
   (when (or (nxml-after-section-start-tag)
 	    (nxml-section-tag-backward))
@@ -970,7 +970,7 @@
 	(heading-regexp (concat "\\`\\("
 				nxml-heading-element-name-regexp
 				"\\)\\'"))
-	
+
 	(section-regexp (concat "\\`\\("
 				nxml-section-element-name-regexp
 				"\\)\\'"))