From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: RE: doc string of insert-default-directory is unclear Date: Sat, 9 Feb 2008 11:17:20 -0800 Message-ID: <001501c86b50$64c8dc20$a350908d@us.oracle.com> References: <001301c86604$8c9e5c30$2c49908d@us.oracle.com> <001301c86b34$b882f240$a350908d@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1202584645 9855 80.91.229.12 (9 Feb 2008 19:17:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Feb 2008 19:17:25 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org To: "'Eli Zaretskii'" , "'Luc Teirlinck'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 09 20:17:47 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JNvCs-0005DU-1o for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Feb 2008 20:17:46 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNvCO-0002y2-Ti for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Feb 2008 14:17:16 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JNvCJ-0002vv-Te for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 14:17:11 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JNvCI-0002u5-CJ for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 14:17:11 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNvCI-0002tu-07 for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 14:17:10 -0500 Original-Received: from agminet01.oracle.com ([141.146.126.228]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JNvCE-00029W-4T; Sat, 09 Feb 2008 14:17:06 -0500 Original-Received: from agmgw1.us.oracle.com (agmgw1.us.oracle.com [152.68.180.212]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m19JH29n008570; Sat, 9 Feb 2008 13:17:03 -0600 Original-Received: from acsmt350.oracle.com (acsmt350.oracle.com [141.146.40.150]) by agmgw1.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m19IIFBF029546; Sat, 9 Feb 2008 12:17:01 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt351.oracle.com with ESMTP id 3567891881202584619; Sat, 09 Feb 2008 11:16:59 -0800 Original-Received: from dradamslap1 (/141.144.80.163) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 09 Feb 2008 11:16:59 -0800 X-Mailer: Microsoft Office Outlook 11 In-reply-to: Thread-Index: AchrOgShrD+zX7u4QDSrrNLTy1LjBAAFbwUA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:17520 Archived-At: > > > > In previous releases, the doc string said only what its > > > > first line says. The rest was presumably added in Emacs 22 > > > > to clarify the meaning and use. > > > > > > Not just clarify, to document its different semantics. > > > > That semantic difference is not clear to me from the new > > doc string you propose. Sorry. Could you point out the difference? > > I did not mean my changes, I meant the addition of the text that you > complained about: it was added when the effects of the value of this > variable were changed a few years ago. I understood that. I should have said that the semantic difference is not clear to me from either the Emacs 22 doc string or your proposed text. What is the semantic difference from pre-Emacs 22? What behavior has changed? > > "Typing RETURN without editing will leave the minibuffer > > empty." No, it will exit the minibuffer > > Well, that's ambiguity of the work "leave": it also means "exit", > which was my intent. Right. Exit is less ambiguous. > > I hate to say it, but I think that, in general, the added > > text just adds confusion. > > If you mean my changes, then I didn't add anything. I just rearranged > the text a bit and made some minor wording changes. I meant both the Emacs 22 text and your proposed text. I don't think either clarifies things. > > What is the problem that adding this text is intended to > > solve? If you tell me what the problem we are solving is, perhaps > > I can help some more with the wording. > > I didn't have enough time for researching all the users of this > variable's value, unfortunately. So I simply don't know. Perhaps Luc > Teirlinck (cc'ed), who is the author of the doc string, could help. OK, understood; I appreciate your trying to help. If someone lets me know, I'll try to suggest an improvement. For the moment, IMO, we were better off with just the one-liner.