From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Sat, 16 Jul 2011 18:42:38 +0000 (+0200)
Subject: Document `auto-fill-function' in relation to `auto-fill-mode'
X-Git-Tag: emacs-pretest-24.0.90~104^2~226
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ca425c7c87bc939777a1dceea7fbe1fe563bc3ca;p=emacs.git

Document `auto-fill-function' in relation to `auto-fill-mode'

Fixes: debbugs:2470
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 06201dd4146..6ac0dd3d0b1 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -2,6 +2,8 @@
 
 	* simple.el (current-kill): Clarify what
 	`interprogram-paste-function' does (bug#7500).
+	(auto-fill-mode): Document `auto-fill-function' in relation to
+	`auto-fill-mode' (bug#2470).
 
 2011-07-16  Lawrence Mitchell  <wence@gmx.li>
 
diff --git a/lisp/simple.el b/lisp/simple.el
index 5dbe1e39794..7fd7e20b499 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -5237,14 +5237,16 @@ Some major modes set this.")
 ;; auto-fill-function to nil in a file-local setting is safe and
 ;; can be useful to prevent auto-filling.
 (put 'auto-fill-function 'safe-local-variable 'null)
-;; FIXME: turn into a proper minor mode.
-;; Add a global minor mode version of it.
+
 (define-minor-mode auto-fill-mode
   "Toggle Auto Fill mode.
 With ARG, turn Auto Fill mode on if and only if ARG is positive.
 In Auto Fill mode, inserting a space at a column beyond `current-fill-column'
 automatically breaks the line at a previous space.
 
+When `auto-fill-mode' is on, the `auto-fill-function' variable is
+non-`nil'.
+
 The value of `normal-auto-fill-function' specifies the function to use
 for `auto-fill-function' when turning Auto Fill mode on."
   :variable (eq auto-fill-function normal-auto-fill-function))