Added or corrected Commentary sections

3 files changed, 16 insertions, 0 deletions

diff --git a/lisp/mail/emacsbug.el b/lisp/mail/emacsbug.el
index 3af19d75ab3..8f64f8f8da7 100644
--- a/lisp/mail/emacsbug.el
+++ b/lisp/mail/emacsbug.el
@@ -23,6 +23,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:
+
+;; `M-x report-emacs-bug ' starts an email note to the Emacs maintainers
+;; describing a problem.  Here's how it's done...
+
 ;;; Code:
 
 ;; >> This should be an address which is accessible to your machine,
diff --git a/lisp/mail/mail-utils.el b/lisp/mail/mail-utils.el
index d165dc6d756..63757511013 100644
--- a/lisp/mail/mail-utils.el
+++ b/lisp/mail/mail-utils.el
@@ -21,6 +21,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:
+
+;; Utility functions for maol and netnews handling.  These handle fine
+;; points of header parsing.
+
 ;;; Code:
 
 ;;; We require lisp-mode to make sure that lisp-mode-syntax-table has
diff --git a/lisp/mail/mailalias.el b/lisp/mail/mailalias.el
index b07725a5a7c..3918a520e04 100644
--- a/lisp/mail/mailalias.el
+++ b/lisp/mail/mailalias.el
@@ -21,6 +21,12 @@
 ;; along with GNU Emacs; see the file COPYING.  If not, write to
 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
+;;; Commentary:
+
+;; Basic functions for defining and expanding mail aliases.
+;; These seal off the interface to the alias-definition parts of a
+;; .mailrc file formatted for BSD's Mail or USL's mailx.
+
 ;;; Code:
 
 (defvar mail-aliases t