From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#10879: 24.0.93;
	doc for `find-file' et al is missing the return value
Date: Mon, 10 Feb 2014 15:30:23 -0800 (PST)
Message-ID: <b52f77f0-1bdf-4760-bd5a-90919d566cff@default>
References: <73CE0A02B9B0423CA105B7BF7417831B@us.oracle.com>
	<87wr7by3di.fsf@gnu.org>
	<ACE482DEE46E466DA018FBCC9E905152@us.oracle.com>
	<jwvk43bmego.fsf-monnier+emacs@gnu.org>
	<0A371FF1256B461F9D58E0D784C4751F@us.oracle.com>
	<87y51kc1o0.fsf@building.gnus.org>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: ger.gmane.org 1392075078 22801 80.91.229.3 (10 Feb 2014 23:31:18 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Mon, 10 Feb 2014 23:31:18 +0000 (UTC)
Cc: 10879@debbugs.gnu.org, Chong Yidong <cyd@gnu.org>
To: Lars Ingebrigtsen <larsi@gnus.org>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 11 00:31:25 2014
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([208.118.235.17])
	by plane.gmane.org with esmtp (Exim 4.69)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1WD0Jw-00049o-B9
	for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Feb 2014 00:31:24 +0100
Original-Received: from localhost ([::1]:58688 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1WD0Jv-0000Qk-Me
	for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Feb 2014 18:31:23 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46440)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WD0Jj-0000DI-Ll
	for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 18:31:20 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WD0Jb-0008Ho-3K
	for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 18:31:11 -0500
Original-Received: from debbugs.gnu.org ([140.186.70.43]:34204)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WD0Ja-0008Hj-P8
	for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 18:31:03 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WD0Ja-000196-3e
	for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 18:31:02 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Drew Adams <drew.adams@oracle.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Mon, 10 Feb 2014 23:31:02 +0000
Resent-Message-ID: <handler.10879.B10879.13920750402855@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 10879
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: wontfix
Original-Received: via spool by 10879-submit@debbugs.gnu.org id=B10879.13920750402855
	(code B ref 10879); Mon, 10 Feb 2014 23:31:02 +0000
Original-Received: (at 10879) by debbugs.gnu.org; 10 Feb 2014 23:30:40 +0000
Original-Received: from localhost ([127.0.0.1]:42099 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1WD0JB-0000hF-0u
	for submit@debbugs.gnu.org; Mon, 10 Feb 2014 18:30:37 -0500
Original-Received: from userp1040.oracle.com ([156.151.31.81]:33369)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <drew.adams@oracle.com>) id 1WD0J7-0000Wh-C7
	for 10879@debbugs.gnu.org; Mon, 10 Feb 2014 18:30:33 -0500
Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238])
	by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with
	ESMTP id s1ANUQux002930
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Mon, 10 Feb 2014 23:30:27 GMT
Original-Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86])
	by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	s1ANUOv9027653
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Mon, 10 Feb 2014 23:30:25 GMT
Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21])
	by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id
	s1ANUOmv007784; Mon, 10 Feb 2014 23:30:24 GMT
In-Reply-To: <87y51kc1o0.fsf@building.gnus.org>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8  (707110) [OL
	12.0.6680.5000 (x86)]
X-Source-IP: acsinet22.oracle.com [141.146.126.238]
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x
X-Received-From: 140.186.70.43
X-BeenThere: bug-gnu-emacs@gnu.org
List-Id: "Bug reports for GNU Emacs,
	the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.bugs:85334
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/85334>

> > And each time the code was rewritten/updated, the maintainers
> > again made sure to return the buffer(s).  Not just some inadvertent
> > mistake, this crap.
>=20
> `find-file' now apparently returns either a list or a buffer now, so
> the missing return value is correct.  Closing.

Huh?  It has _always_ returned a list of buffers or a buffer.

That changes nothing.  Look at the doc string of `find-file-noselect'.
That's what returns the list or buffer.  And we document its return
value as that list or buffer.  As we should.  And as we should for
`find-file' et al. =20

Nothing changed; nothing fixed.  Reopening.