Added or corrected Commentary sections

7 files changed, 26 insertions, 8 deletions

diff --git a/lisp/textmodes/bib-mode.el b/lisp/textmodes/bib-mode.el
index 5a9bd6e0e6f..d772ddcff1e 100644
--- a/lisp/textmodes/bib-mode.el
+++ b/lisp/textmodes/bib-mode.el
@@ -21,14 +21,15 @@
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
-;;; Code:
+;;; Commentary:
 
-;; Bib-Mode
 ;;   GNU Emacs code to help maintain databases compatible with (troff)
 ;;   refer and lookbib.  The file bib-file should be set to your 
 ;;   bibliography file.  Keys are automagically inserted as you type,
 ;;   and appropriate keys are presented for various kinds of entries.
 
+;;; Code:
+
 (defvar bib-file "~/my-bibliography.bib" 
    "Default name of file used by `addbib'.")
 
diff --git a/lisp/textmodes/bibtex.el b/lisp/textmodes/bibtex.el
index 851bf9f64d9..b441eaa9fbd 100644
--- a/lisp/textmodes/bibtex.el
+++ b/lisp/textmodes/bibtex.el
@@ -25,6 +25,13 @@
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; A major mode for entering and editing BibTex files, validating
+;; them, canonicalizing them, and sorting them.  Includes entry
+;; commands tailored to many different formats (book, master's this,
+;; journal article, etc).  Has loads of options.
+
 ;;; Change Log:
 
 ;;; alarson@src.honeywell.com 92-Jan-31
diff --git a/lisp/textmodes/fill.el b/lisp/textmodes/fill.el
index eb2ba5be696..a905bef78d1 100644
--- a/lisp/textmodes/fill.el
+++ b/lisp/textmodes/fill.el
@@ -20,6 +20,11 @@
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; All the commands for filling text.  These are documented in the Emacs
+;; manual.
+
 ;;; Code:
 
 (defconst fill-individual-varying-indent nil
diff --git a/lisp/textmodes/ispell4.el b/lisp/textmodes/ispell4.el
index ded85446595..4520ebcff0d 100644
--- a/lisp/textmodes/ispell4.el
+++ b/lisp/textmodes/ispell4.el
@@ -20,6 +20,11 @@
 ;;along with GNU Emacs; see the file COPYING.  If not, write to
 ;;the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; This package provides a graceful interface to ispell, the GNU
+;; spelling checker.
+
 ;;; Code:
 
 (defvar ispell-have-new-look t
diff --git a/lisp/textmodes/nroff-mode.el b/lisp/textmodes/nroff-mode.el
index bc2013412de..5c87ca567ff 100644
--- a/lisp/textmodes/nroff-mode.el
+++ b/lisp/textmodes/nroff-mode.el
@@ -67,8 +67,8 @@ closing requests for requests that are used in matched pairs."
   (setq comment-start-skip "\\\\\"[ \t]*")
   (make-local-variable 'comment-column)
   (setq comment-column 24)
-  (make-local-variable 'comment-indent-hook)
-  (setq comment-indent-hook 'nroff-comment-indent)
+  (make-local-variable 'comment-indent-function)
+  (setq comment-indent-function 'nroff-comment-indent)
   (run-hooks 'text-mode-hook 'nroff-mode-hook))
 
 ;;; Compute how much to indent a comment in nroff/troff source.
diff --git a/lisp/textmodes/sgml-mode.el b/lisp/textmodes/sgml-mode.el
index d03e631a91e..b6200ac0bc7 100644
--- a/lisp/textmodes/sgml-mode.el
+++ b/lisp/textmodes/sgml-mode.el
@@ -89,8 +89,8 @@ Use \\[sgml-validate] to validate your document with an SGML parser."
   (setq comment-start "<!-- ")
   (make-local-variable 'comment-end)
   (setq comment-end " -->")
-  (make-local-variable 'comment-indent-hook)
-  (setq comment-indent-hook 'sgml-comment-indent)
+  (make-local-variable 'comment-indent-function)
+  (setq comment-indent-function 'sgml-comment-indent)
   (make-local-variable 'comment-start-skip)
   ;; This will allow existing comments within declarations to be
   ;; recognized.
diff --git a/lisp/textmodes/tex-mode.el b/lisp/textmodes/tex-mode.el
index cee97ffa407..7835bfd120a 100644
--- a/lisp/textmodes/tex-mode.el
+++ b/lisp/textmodes/tex-mode.el
@@ -437,8 +437,8 @@ tex-shell-hook is called."
   (setq comment-start "%")
   (make-local-variable 'comment-start-skip)
   (setq comment-start-skip "\\(\\(^\\|[^\\]\\)\\(\\\\\\\\\\)*\\)\\(%+ *\\)")
-  (make-local-variable 'comment-indent-hook)
-  (setq comment-indent-hook 'tex-comment-indent)
+  (make-local-variable 'comment-indent-function)
+  (setq comment-indent-function 'tex-comment-indent)
   (make-local-variable 'compare-windows-whitespace)
   (setq compare-windows-whitespace 'tex-categorize-whitespace)
   (make-local-variable 'tex-command)