From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: doc string for global-hl-line-mode should not mention M-x
	customize
Date: Mon, 28 Aug 2006 05:51:41 -0400
Message-ID: <E1GHdmP-0005Ks-6I@fencepost.gnu.org>
References: <MEEKKIABFKKDFJMPIOEBOEHGDEAA.drew.adams@oracle.com>
Reply-To: rms@gnu.org
NNTP-Posting-Host: main.gmane.org
Content-Type: text/plain; charset=ISO-8859-15
X-Trace: sea.gmane.org 1156758722 6895 80.91.229.2 (28 Aug 2006 09:52:02 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Mon, 28 Aug 2006 09:52:02 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Aug 28 11:51:59 2006
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane.org
Original-Received: from lists.gnu.org ([199.232.76.165])
	by ciao.gmane.org with esmtp (Exim 4.43)
	id 1GHdmd-0001qA-IN
	for ged-emacs-devel@m.gmane.org; Mon, 28 Aug 2006 11:51:55 +0200
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1GHdmc-0000sC-Sj
	for ged-emacs-devel@m.gmane.org; Mon, 28 Aug 2006 05:51:54 -0400
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1GHdmR-0000rn-J2
	for emacs-devel@gnu.org; Mon, 28 Aug 2006 05:51:43 -0400
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1GHdmQ-0000rb-5l
	for emacs-devel@gnu.org; Mon, 28 Aug 2006 05:51:42 -0400
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1GHdmQ-0000rY-0s
	for emacs-devel@gnu.org; Mon, 28 Aug 2006 05:51:42 -0400
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.52) id 1GHdvL-00016O-83
	for emacs-devel@gnu.org; Mon, 28 Aug 2006 06:00:55 -0400
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34)
	id 1GHdmP-0005Ks-6I; Mon, 28 Aug 2006 05:51:41 -0400
Original-To: "Drew Adams" <drew.adams@oracle.com>
In-reply-to: <MEEKKIABFKKDFJMPIOEBOEHGDEAA.drew.adams@oracle.com>
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.devel:58972
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/58972>

    C-h v already adds "You can customize this variable". The doc string
    should not also have this text: "use either M-x customize...".  The
    link on this occurrence of "customize" does not take you to the
    Customize buffer for the option; it takes you to the doc string of
    command `customize', which is undesirable here.

That text is generated by define-minor-mode when it constructs the
defvar.  So I think it will not be trivial to make it produce a
special kind of button.  Is there a way for a doc string to do that?
Anyway, someone can feel free to improve this.