From: "Drew Adams" <drew.adams@oracle.com>
To: "'Juanma Barranquero'" <lekktu@gmail.com>
Cc: 2470@debbugs.gnu.org
Subject: bug#2470: 23.0.90; auto-fill-mode, :minor-mode-function
Date: Sun, 10 Jul 2011 02:54:55 -0700 [thread overview]
Message-ID: <A30F4D7AEA2848F1973A74001B2A958C@us.oracle.com> (raw)
In-Reply-To: <CAAeL0SQBcc+nQCAOMDjOfGO-8GNCouKTbCV49f5tdtCWEgLcBQ@mail.gmail.com>
> > That's really the question, I think. Are things
> > sufficiently clear (e.g. from
> > the doc) that a user would now know how to tell this?
>
> Likely not, though strictly speaking, a user that needs to know the
> variable name will usually be able to take a look at minor-mode-alist
> and deduce it by himself.
>
> In any case, could you please suggest a suitable change for the
> docstring of auto-fill-mode?
I don't see a problem with that doc string in particular.
What did you have in mind?
This part is a little unclear:
"The value of `normal-auto-fill-function' specifies the function to use
for `auto-fill-function' when turning Auto Fill mode on."
One wonders why it speaks of `auto-fill-function', as if it is something
understood (begs the question of its relation to `auto-fill-mode').
If you then click the `auto-fill-function' link you get doc on that function,
but it's not clear at all what it has to do with `auto-fill-mode'.
It does say also this: "auto-fill-function is also a variable." But the name is
neither quoted (`...') nor a link to help on that var. And there is nothing
saying anything about what you said: that the variable tells you whether
`auto-fill-mode' is on (which was the OP question).
Perhaps we should at least add something like this to the `auto-fill-mode' doc:
"When `auto-fill-mode' is on, variable `auto-fill-function' is non-`nil'."
next prev parent reply other threads:[~2011-07-10 9:54 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <AcmXctCJzHsFMr8USuWNNuSa9WxT6w==>
2009-02-25 17:59 ` bug#2470: 23.0.90; auto-fill-mode, :minor-mode-function Drew Adams
2009-02-25 19:56 ` Stefan Monnier
2009-02-25 20:02 ` Drew Adams
2011-07-09 22:16 ` Juanma Barranquero
2011-07-09 23:10 ` Drew Adams
2011-07-09 23:18 ` Juanma Barranquero
2011-07-10 9:54 ` Drew Adams [this message]
2011-07-16 18:43 ` Lars Magne Ingebrigtsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=A30F4D7AEA2848F1973A74001B2A958C@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=2470@debbugs.gnu.org \
--cc=lekktu@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.