From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: Re: doc string of insert-default-directory is unclear Date: Sat, 09 Feb 2008 18:35:11 +0200 Message-ID: References: <001301c86604$8c9e5c30$2c49908d@us.oracle.com> <001301c86b34$b882f240$a350908d@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1202574935 6596 80.91.229.12 (9 Feb 2008 16:35:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Feb 2008 16:35:35 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org To: "Drew Adams" , Luc Teirlinck Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 09 17:35:57 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 1JNsgE-0001MK-30 for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Feb 2008 17:35:54 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNsfk-0002Im-WE for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Feb 2008 11:35:25 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JNsfh-0002IV-GM for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 11:35:21 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JNsfg-0002IH-4q for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 11:35:21 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNsff-0002IE-VB for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 11:35:19 -0500 Original-Received: from nitzan.inter.net.il ([213.8.233.22]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JNsff-0005mT-Ha for bug-gnu-emacs@gnu.org; Sat, 09 Feb 2008 11:35:19 -0500 Original-Received: from HOME-C4E4A596F7 (IGLD-83-130-218-44.inter.net.il [83.130.218.44]) by nitzan.inter.net.il (MOS 3.7.3a-GA) with ESMTP id JCP67367 (AUTH halo1); Sat, 9 Feb 2008 18:32:42 +0200 (IST) In-reply-to: <001301c86b34$b882f240$a350908d@us.oracle.com> (drew.adams@oracle.com) X-detected-kernel: by monty-python.gnu.org: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) 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:17517 Archived-At: > From: "Drew Adams" > Cc: > Date: Sat, 9 Feb 2008 07:59:15 -0800 > > > > 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. > "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. > 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. > 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.