From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: "Richard M. Stallman" <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: checkdoc: URLs in docstrings with lisp symbols
Date: Fri, 28 Oct 2005 12:17:08 -0400
Message-ID: <E1EVWui-0002hY-93@fencepost.gnu.org>
References: <31877.1130453516@olgas.newt.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 1130516883 12365 80.91.229.2 (28 Oct 2005 16:28:03 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Fri, 28 Oct 2005 16:28:03 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 28 18:28:02 2005
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Original-Received: from lists.gnu.org ([199.232.76.165])
	by ciao.gmane.org with esmtp (Exim 4.43)
	id 1EVX2y-000790-It
	for ged-emacs-devel@m.gmane.org; Fri, 28 Oct 2005 18:25:40 +0200
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1EVX2x-0006YV-Eg
	for ged-emacs-devel@m.gmane.org; Fri, 28 Oct 2005 12:25:39 -0400
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1EVWuk-0002OV-G4
	for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:17:10 -0400
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1EVWuj-0002O2-DD
	for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:17:10 -0400
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1EVWuj-0002Nx-5U
	for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:17:09 -0400
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1EVWuj-00047p-1X
	for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:17:09 -0400
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34)
	id 1EVWui-0002hY-93; Fri, 28 Oct 2005 12:17:08 -0400
Original-To: Bill Wohler <wohler@newt.com>
In-reply-to: <31877.1130453516@olgas.newt.com> (message from Bill Wohler on
	Thu, 27 Oct 2005 15:51:56 -0700)
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:45036
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/45036>

    checkdoc ignores the make-face string but complains that the make-face
    bit in the URL should be quoted `'. The Info node (elisp)Documentation
    Tips doesn't say how URLs should be treated.

The right way to treat them would be in a way that enables
the help facility to follow the link and display the URL.
I tend to think that `' quoting is the natural way to implement that.
Would you like to implement that?