-;; There are two hooks used by `highlight-changes-mode':
-;; `highlight-changes-enable-hook' - is run when Highlight Changes mode
-;; is enabled for a buffer.
-;; `highlight-changes-disable-hook' - is run when Highlight Changes mode
-;; is disabled for a buffer.
-
-;; Example usage:
-;; (defun my-highlight-changes-enable-hook ()
-;; (add-hook 'write-file-functions 'highlight-changes-rotate-faces nil t)
-;; )
+;; The hook `highlight-changes-mode-hook' is called when
+;; Highlight Changes mode is turned on or off.
+;; When it called, variable `highlight-changes-mode' has been updated
+;; to the new value.