From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Juanma Barranquero" Newsgroups: gmane.emacs.devel Subject: Re: [drew.adams@oracle.com: RE: Customize doc strings and tagstrings do not respect \\<...> and \\[...]] Date: Sat, 17 Feb 2007 02:23:01 +0100 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1171675408 29191 80.91.229.12 (17 Feb 2007 01:23:28 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 17 Feb 2007 01:23:28 +0000 (UTC) Cc: drew.adams@oracle.com, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Feb 17 02:23:22 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1HIEIL-0004aj-6i for ged-emacs-devel@m.gmane.org; Sat, 17 Feb 2007 02:23:21 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HIEIK-00010Z-Hn for ged-emacs-devel@m.gmane.org; Fri, 16 Feb 2007 20:23:20 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HIEI8-0000wd-C4 for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:23:08 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HIEI6-0000ua-Q6 for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:23:07 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HIEI6-0000uT-Nk for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:23:06 -0500 Original-Received: from ug-out-1314.google.com ([66.249.92.174]) by monty-python.gnu.org with esmtp (Exim 4.52) id 1HIEI6-0001C5-Co for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:23:06 -0500 Original-Received: by ug-out-1314.google.com with SMTP id j3so362240ugf for ; Fri, 16 Feb 2007 17:23:05 -0800 (PST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=rBN1dtkrUQeF140+MCQrTCkWU/ymWOMVMWcCMnYT83tXraA7fLfvThmsFvOc7biP7QpDYXaSg2RmQ9lDpyD8Y3kgjfPN+WK32YEUpkFFejhfhZe87awXuZdp8vChSVco/IwxA/gllMHj10sIIcoEsBmG2VqHQ1bnep+5Y4gTP1E= Original-Received: by 10.114.182.1 with SMTP id e1mr2248252waf.1171675381644; Fri, 16 Feb 2007 17:23:01 -0800 (PST) Original-Received: by 10.114.234.16 with HTTP; Fri, 16 Feb 2007 17:23:01 -0800 (PST) In-Reply-To: Content-Disposition: inline X-detected-kernel: Linux 2.4-2.6 (Google crawlbot) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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:66470 Archived-At: On 2/17/07, Richard Stallman wrote: > Oh, now I see why: because Emacs knows the doc string initially, > even though the command has ever been run. Yes. > Therefore, the case of an autoload mode's doc string that refers to > the not-yet-loaded keymap is legitimate, so it ought to produce > nice-looking output. Agreed. In fact, cases like `checkdoc-minor-mode' were what prompted me to comment in this thread. > I think a good solution would be to make \\ generate > something friendly but clear, such as a note at the end rather than at > the beginning, saying that the keymap couldn't be displayed because > it isn't loaded yet. Fine by me. Juanma