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: doc string of insert-default-directory is unclear Date: Sat, 2 Feb 2008 17:31:49 -0800 Message-ID: <001301c86604$8c9e5c30$2c49908d@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 1202002407 3016 80.91.229.12 (3 Feb 2008 01:33:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 3 Feb 2008 01:33:27 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 03 02:33:48 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 1JLTjv-0004Li-79 for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Feb 2008 02:33:47 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JLTjT-0002ds-3i for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Feb 2008 20:33:19 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JLTjP-0002dd-42 for bug-gnu-emacs@gnu.org; Sat, 02 Feb 2008 20:33:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JLTjM-0002dR-MR for bug-gnu-emacs@gnu.org; Sat, 02 Feb 2008 20:33:13 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JLTjM-0002dO-GR for bug-gnu-emacs@gnu.org; Sat, 02 Feb 2008 20:33:12 -0500 Original-Received: from rgminet01.oracle.com ([148.87.113.118]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JLTjM-00009r-78 for bug-gnu-emacs@gnu.org; Sat, 02 Feb 2008 20:33:12 -0500 Original-Received: from agmgw1.us.oracle.com (agmgw1.us.oracle.com [152.68.180.212]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m131X9pG032638 for ; Sat, 2 Feb 2008 18:33:09 -0700 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by agmgw1.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m12NgQ6a030240 for ; Sat, 2 Feb 2008 18:33:09 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt351.oracle.com with ESMTP id 3551487431202002302; Sat, 02 Feb 2008 17:31:42 -0800 Original-Received: from dradamslap1 (/141.144.73.44) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 02 Feb 2008 17:31:42 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AchmBIw350pFvcqLQ1GXJmiMcIA6/A== 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:17456 Archived-At: Don't ask me why it's unclear to me, if it's clear to you. In that case, just take it that at least one user finds this unclear. 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. But I find it totally confusing. In particular, the second sentence is not clear, I think: "If the initial minibuffer contents are non-empty, you can usually request a default filename by typing RETURN without editing." Please consider rephrasing the entire doc string. A good starting point could be to explain the significance of the initial contents being non-empty. The doc string should give you an idea when you might want to bind this to nil or non-nil. That is not the case now, IMO. In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600) of 2007-06-02 on RELEASE Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'