From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Robert J. Chassell" Newsgroups: gmane.emacs.devel Subject: Re: Suggestion: Simple way to make conditional key bindings. Date: Fri, 30 Aug 2002 06:27:07 -0400 (EDT) Sender: emacs-devel-admin@gnu.org Message-ID: References: <5x4rdlbx1i.fsf@kfs2.cua.dk> <200208260036.g7Q0aSR12388@wijiji.santafe.edu> <200208261621.g7QGLIE25159@rum.cs.yale.edu> Reply-To: bob@rattlesnake.com NNTP-Posting-Host: localhost.gmane.org X-Trace: main.gmane.org 1030751036 30971 127.0.0.1 (30 Aug 2002 23:43:56 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Fri, 30 Aug 2002 23:43:56 +0000 (UTC) Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 17kvQh-00083Q-00 for ; Sat, 31 Aug 2002 01:43:55 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17kvxg-0002zH-00 for ; Sat, 31 Aug 2002 02:18:00 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10) id 17kvS8-0007m0-00; Fri, 30 Aug 2002 19:45:24 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10) id 17kvP7-0007cK-00 for emacs-devel@gnu.org; Fri, 30 Aug 2002 19:42:17 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10) id 17kvP4-0007bq-00 for emacs-devel@gnu.org; Fri, 30 Aug 2002 19:42:16 -0400 Original-Received: from megalith.rattlesnake.com ([140.186.114.245] helo=localhost) by monty-python.gnu.org with esmtp (Exim 4.10) id 17kvP3-0007bA-00 for emacs-devel@gnu.org; Fri, 30 Aug 2002 19:42:14 -0400 Original-Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.114) Fri, 30 Aug 2002 06:27:07 -0400 (EDT) Original-To: emacs-devel@gnu.org In-Reply-To: <200208261621.g7QGLIE25159@rum.cs.yale.edu> (monnier+gnu/emacs@rum.cs.yale.edu) Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:7191 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:7191 > ... C-h k C-y will report yank or yank-with-properties > depending on the actual function taken if you hit C-y. .... > .... sometimes it will be better for C-h k to give the doc string > for the specific command that will be executed. Agreed. But in the example he gave I think that a docstring that describes the range of behavior rather than the specific command is better, because you can't expect the user to know that the current string is "special". Yes: the user may not know or remember the range. (At the moment, for example, I am in the middle of a long airplane flight and too exhausted to remember much, even though some of the time I am quite good.) At the same time, for this sort of command, which operates differently in different contexts, the docstring should describe what the command will do specifically in this situation. -- Robert J. Chassell bob@rattlesnake.com bob@gnu.org Rattlesnake Enterprises http://www.rattlesnake.com Free Software Foundation http://www.gnu.org GnuPG Key ID: 004B4AC8