From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#33339: 26; doc string of `write-file` Date: Sat, 10 Nov 2018 14:42:16 -0800 (PST) Message-ID: <1c69fed6-2e30-46a2-92dd-7f8ae6d62928@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1541889673 26543 195.159.176.226 (10 Nov 2018 22:41:13 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 10 Nov 2018 22:41:13 +0000 (UTC) To: 33339@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 10 23:41:09 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLbwD-0006nx-Fa for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2018 23:41:09 +0100 Original-Received: from localhost ([::1]:40247 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLbyK-0000fA-2B for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2018 17:43:20 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46452) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLby5-0000Nl-8q for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:43:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLby2-0005im-2D for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:43:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40902) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gLby1-0005iV-S3 for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:43:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gLby1-00061h-Pm for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:43:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Nov 2018 22:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33339 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.154188977123142 (code B ref -1); Sat, 10 Nov 2018 22:43:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Nov 2018 22:42:51 +0000 Original-Received: from localhost ([127.0.0.1]:45160 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLbxq-00061B-0C for submit@debbugs.gnu.org; Sat, 10 Nov 2018 17:42:51 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLbxn-00060y-VU for submit@debbugs.gnu.org; Sat, 10 Nov 2018 17:42:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLbxg-0005Vz-QX for submit@debbugs.gnu.org; Sat, 10 Nov 2018 17:42:42 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:44720) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLbxd-0005TR-Gs for submit@debbugs.gnu.org; Sat, 10 Nov 2018 17:42:38 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46241) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLbxa-000786-97 for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:42:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLbxP-0005Ge-Dt for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:42:29 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:38736) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLbxP-0005Cr-2a for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 17:42:23 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wAAMd0BK010578 for ; Sat, 10 Nov 2018 22:42:18 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=yFzCu9JbDwG0tSsFAGflBjxdxpkKhfPY8PLIqtNfF5g=; b=SzexO0M8WsBBWZ7bP++IKzbEoEduvFt1BWlEFwzwXV/Uw7UwNaaGYBEc2ZM/pCD6sVvw gfOiLK9eM4m18cEicmQH1Bvmo1hUUI0SsEDNkmNPN9BBjzxas2t59+vucZ3Ik576dtdS Bk/B5EAQyqSJCtt/gGV5iPBHlHXbnOejGttRbCcBlxT3RRayTvlYqoZ3cor4+m7Bkik1 yBSzzBzyD1CUCDVX5I2n2kx/UgK+6YZ8k2HVF4YWP4qFARhcldmij7/EsfXfsOeWQlba INk8Htu2wwlsT2vHqCUd+okeh7xRcfw5w/K7yPGPmq1Xm27M1XdQKc7GAnwNQt6QTVPX sQ== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2120.oracle.com with ESMTP id 2nnwc08v44-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 10 Nov 2018 22:42:18 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id wAAMgHZs023505 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 10 Nov 2018 22:42:17 GMT Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id wAAMgHSg008695 for ; Sat, 10 Nov 2018 22:42:17 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4756.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9073 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=973 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1811100179 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:152282 Archived-At: "If you specify just a directory name as FILENAME, that means to use the default file name but in that directory. You can also yank the default file name into the minibuffer to edit it, using M-n." "The default file name" is undefined. How is a user to know what we mean? It turns out that in this particular case what we mean is this: (file-name-nondirectory (or buffer-file-name (buffer-name))) Not obvious from the description. To start with, the doc string should say that it prompts for a file name. If the current buffer is visiting a file then that file's name is the default file name for reading. Otherwise the buffer name is the default file name for reading. The last part could be more exact. The default name in that case is actually this: (expand-file-name (file-name-nondirectory (buffer-name)) default-directory)=20 In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''