From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: [drew.adams@oracle.com: RE: Customize doc strings and tagstrings do not respect \\<...> and \\[...]] Date: Fri, 16 Feb 2007 20:03:04 -0500 Message-ID: References: Reply-To: rms@gnu.org NNTP-Posting-Host: lo.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1171674305 26905 80.91.229.12 (17 Feb 2007 01:05:05 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 17 Feb 2007 01:05:05 +0000 (UTC) Cc: drew.adams@oracle.com, emacs-devel@gnu.org To: "Juanma Barranquero" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Feb 17 02:04:59 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 1HIE0W-0004t1-2i for ged-emacs-devel@m.gmane.org; Sat, 17 Feb 2007 02:04:56 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HIE0V-0001wX-F7 for ged-emacs-devel@m.gmane.org; Fri, 16 Feb 2007 20:04:55 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HIE05-0001k9-Fk for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:04:29 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HIE04-0001jc-R0 for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:04:28 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HIE04-0001jV-Fx for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:04:28 -0500 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.52) id 1HIE04-0007NP-1s for emacs-devel@gnu.org; Fri, 16 Feb 2007 20:04:28 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.60) (envelope-from ) id 1HIDyi-0006Gx-Sm; Fri, 16 Feb 2007 20:03:04 -0500 In-reply-to: (lekktu@gmail.com) X-detected-kernel: Linux 2.6, seldom 2.4 (older, 4) 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:66465 Archived-At: `checkdoc-minor-mode' is autoloaded, so it's a case like the ones I talk above. Why does it matter whether `checkdoc-minor-mode' is autoloaded? Oh, now I see why: because Emacs knows the doc string initially, even though the command has ever been run. This leads me to reconsider part of my previous conclusion. It is useful for modes to show their keymaps, and it is useful to autoload modes. Would be rather inconvenient to insist on preloading all files that define modes that show their keymaps. 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. So now I agree a change is called for -- similar to the one you proposed, but with slightly different details. 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.