From 186529ef729b51b6151bb8d5b67c3a54f3cebc83 Mon Sep 17 00:00:00 2001
From: Chong Yidong <cyd@gnu.org>
Date: Sat, 24 Mar 2012 21:49:17 +0800
Subject: [PATCH] Commentary tweaks for csv-mode, ioccur, and nhexl-mode
 packages.

---
 packages/csv-mode/csv-mode.el     |  2 +-
 packages/ioccur/ioccur.el         | 21 ++++++++++-----------
 packages/nhexl-mode/nhexl-mode.el | 15 +++++++++------
 3 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/packages/csv-mode/csv-mode.el b/packages/csv-mode/csv-mode.el
index a3ba1fd06..3c9c4de65 100644
--- a/packages/csv-mode/csv-mode.el
+++ b/packages/csv-mode/csv-mode.el
@@ -1,4 +1,4 @@
-;;; csv-mode.el --- major mode for editing comma-separated value files
+;;; csv-mode.el --- major mode for editing comma/char separated values
 
 ;; Copyright (C) 2003, 2004, 2012  Free Software Foundation, Inc
 
diff --git a/packages/ioccur/ioccur.el b/packages/ioccur/ioccur.el
index 27bd4670e..aeab1ef8c 100644
--- a/packages/ioccur/ioccur.el
+++ b/packages/ioccur/ioccur.el
@@ -33,20 +33,19 @@
 
 ;;; Commentary:
 ;;
-;; This package provide similar functionality as occur but is incremental.
+;; This package provides the command M-x ioccur, which is similar to
+;; M-x occur, except that it is incremental.
 ;;
-;; You can jump and quit to an occurence or jump
-;; and save the search buffer (ioccur-buffer) for further use.
-;; It is possible to toggle literal and regexp searching while running.
-;; It is auto documented both in mode-line and tooltip.
-;; It have its own history `ioccur-history' which is a real ring.
-;; etc...
+;; You can jump and quit to an occurrence, or jump and save the search
+;; buffer (ioccur-buffer) for further use.  You can toggle literal and
+;; regexp searching while running.  It is auto documented both in
+;; mode-line and tooltip.  It has its own history, `ioccur-history',
+;; which is a real ring.
 ;;
-;; To save `ioccur-history', use desktop, adding that to your .emacs:
-;; (add-to-list 'desktop-globals-to-save 'ioccur-history)
+;; To save `ioccur-history' via the Desktop package, add this to your
+;; init file (see (info "(emacs) Saving Emacs Sessions") for details):
 ;;
-;; For more info See:
-;; [EVAL] (info "(emacs) Saving Emacs Sessions")
+;; (add-to-list 'desktop-globals-to-save 'ioccur-history)
 
 ;;; Code:
 (require 'derived)
diff --git a/packages/nhexl-mode/nhexl-mode.el b/packages/nhexl-mode/nhexl-mode.el
index 447b185fa..0faeda3de 100644
--- a/packages/nhexl-mode/nhexl-mode.el
+++ b/packages/nhexl-mode/nhexl-mode.el
@@ -21,15 +21,18 @@
 
 ;;; Commentary:
 
-;; This implements a similar functionality to `hexl-mode', but
-;; using a different implementation technique, which makes it usable
-;; as a "plain" minor mode.  I.e. it works on any buffer, does not
-;; mess with the undo boundary or even with the major mode.
+;; This package implements NHexl mode, a minor mode for editing binary
+;; files in hex dump format.  The mode command is called `nhexl-mode'.
+;;
+;; This minor mode implements similar functionality to `hexl-mode',
+;; but using a different implementation technique, which makes it
+;; usable as a "plain" minor mode.  It works on any buffer, and does
+;; not mess with the undo boundary or with the major mode.
 ;;
 ;; In theory it could also work just fine even on very large buffers,
 ;; although in practice it seems to make the display engine suffer.
 
-;; Todo:
+;;; Todo:
 ;; - Clicks on the hex side should put point at the right place.
 
 ;;; Code:
@@ -57,7 +60,7 @@
 
 ;;;###autoload
 (define-minor-mode nhexl-mode
-  "Minor mode to edit files via hex-dump format"
+  "Minor mode to edit binary files via hex-dump format"
   :lighter " NHexl"
   (if (not nhexl-mode)
       (progn
-- 
2.39.2