From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED!not-for-mail
From: Paul Eggert <eggert@cs.ucla.edu>
Newsgroups: gmane.emacs.devel
Subject: Re: Predicate for true lists
Date: Sat, 7 Jul 2018 21:48:45 -0700
Organization: UCLA Computer Science Department
Message-ID: <6a48d13f-9d6b-f9a6-3b41-6ea0c8294d81@cs.ucla.edu>
References: <87fu3vdjjk.fsf@tcd.ie> <87bmcqhhsf.fsf@tcd.ie>
	<ed8ad1da-17da-6842-1e40-c833eb3070f4@cs.ucla.edu>
	<87in6xgtpb.fsf@tcd.ie>
	<2af892df-26cb-60b2-4fd8-067fcb3d32e9@cs.ucla.edu>
	<87r2kh9uwx.fsf@tcd.ie> <83h8lcnbxb.fsf@gnu.org>
	<6fc589d1-2c21-3e9b-be47-b7700f61642d@cs.ucla.edu>
	<831scflefs.fsf@gnu.org>
	<5d0d79d3-6291-fbf0-1028-064f86787483@cs.ucla.edu>
	<837em7jrag.fsf@gnu.org> <87k1q7ytmr.fsf@tcd.ie>
	<83o9fjhvnk.fsf@gnu.org>
	<87efgfyomt.fsf@tcd.ie> <83k1q7ht51.fsf@gnu.org>
	<17d4bfb6-4c14-901f-716f-4aa50386eb9d@cs.ucla.edu>
	<a085bb05-06b0-46de-8dba-514054704d21@default>
NNTP-Posting-Host: blaine.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: quoted-printable
X-Trace: blaine.gmane.org 1531025214 8914 195.159.176.226 (8 Jul 2018 04:46:54 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Sun, 8 Jul 2018 04:46:54 +0000 (UTC)
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
	Thunderbird/52.8.0
Cc: emacs-devel@gnu.org
To: Drew Adams <drew.adams@oracle.com>, Eli Zaretskii <eliz@gnu.org>,
	"Basil L. Contovounesios" <contovob@tcd.ie>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jul 08 06:46:49 2018
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@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 <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1fc1ay-0002DS-OL
	for ged-emacs-devel@m.gmane.org; Sun, 08 Jul 2018 06:46:48 +0200
Original-Received: from localhost ([::1]:35912 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1fc1d5-0002r5-SL
	for ged-emacs-devel@m.gmane.org; Sun, 08 Jul 2018 00:48:59 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59087)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eggert@cs.ucla.edu>) id 1fc1cz-0002qp-H9
	for emacs-devel@gnu.org; Sun, 08 Jul 2018 00:48:54 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <eggert@cs.ucla.edu>) id 1fc1cy-00083E-MC
	for emacs-devel@gnu.org; Sun, 08 Jul 2018 00:48:53 -0400
Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:49766)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <eggert@cs.ucla.edu>)
	id 1fc1cu-00081T-KA; Sun, 08 Jul 2018 00:48:48 -0400
Original-Received: from localhost (localhost [127.0.0.1])
	by zimbra.cs.ucla.edu (Postfix) with ESMTP id 39ABD1605B0;
	Sat,  7 Jul 2018 21:48:47 -0700 (PDT)
Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1])
	by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032)
	with ESMTP id h7Nk9bngoK5w; Sat,  7 Jul 2018 21:48:46 -0700 (PDT)
Original-Received: from localhost (localhost [127.0.0.1])
	by zimbra.cs.ucla.edu (Postfix) with ESMTP id 7A478160653;
	Sat,  7 Jul 2018 21:48:46 -0700 (PDT)
X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu
Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1])
	by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026)
	with ESMTP id 57f-aKnoadtm; Sat,  7 Jul 2018 21:48:46 -0700 (PDT)
Original-Received: from [192.168.1.9] (unknown [47.154.30.119])
	by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 1F99A1605B0;
	Sat,  7 Jul 2018 21:48:46 -0700 (PDT)
Openpgp: preference=signencrypt
Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata=
	xsFNBEyAcmQBEADAAyH2xoTu7ppG5D3a8FMZEon74dCvc4+q1XA2J2tBy2pwaTqfhpxxdGA9
	Jj50UJ3PD4bSUEgN8tLZ0san47l5XTAFLi2456ciSl5m8sKaHlGdt9XmAAtmXqeZVIYX/UFS
	96fDzf4xhEmm/y7LbYEPQdUdxu47xA5KhTYp5bltF3WYDz1Ygd7gx07Auwp7iw7eNvnoDTAl
	KAl8KYDZzbDNCQGEbpY3efZIvPdeI+FWQN4W+kghy+P6au6PrIIhYraeua7XDdb2LS1en3Ss
	mE3QjqfRqI/A2ue8JMwsvXe/WK38Ezs6x74iTaqI3AFH6ilAhDqpMnd/msSESNFt76DiO1ZK
	QMr9amVPknjfPmJISqdhgB1DlEdw34sROf6V8mZw0xfqT6PKE46LcFefzs0kbg4GORf8vjG2
	Sf1tk5eU8MBiyN/bZ03bKNjNYMpODDQQwuP84kYLkX2wBxxMAhBxwbDVZudzxDZJ1C2VXujC
	OJVxq2kljBM9ETYuUGqd75AW2LXrLw6+MuIsHFAYAgRr7+KcwDgBAfwhPBYX34nSSiHlmLC+
	KaHLeCLF5ZI2vKm3HEeCTtlOg7xZEONgwzL+fdKo+D6SoC8RRxJKs8a3sVfI4t6CnrQzvJbB
	n6gxdgCu5i29J1QCYrCYvql2UyFPAK+do99/1jOXT4m2836j1wARAQABzSBQYXVsIEVnZ2Vy
	dCA8ZWdnZXJ0QGNzLnVjbGEuZWR1PsLBfgQTAQIAKAUCTIByZAIbAwUJEswDAAYLCQgHAwIG
	FQgCCQoLBBYCAwECH 
In-Reply-To: <a085bb05-06b0-46de-8dba-514054704d21@default>
Content-Language: en-US
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy]
X-Received-From: 131.179.128.68
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-devel/>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Original-Sender: "Emacs-devel" <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.devel:227090
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/227090>

Drew Adams wrote:
> We should document the intended behavior, including
> the error behavior.

Documenting every function's behavior completely, in that function's doc =
string=20
or manual section, would waste not only our time, but also time spent by =
users=20
reading the documentation. Nobody does that, for any nontrivial GNU progr=
am I'm=20
aware of. Common sense should prevail, and "document every bit of behavio=
r"=20
absolutism would cause more trouble than it'd cure. Thank goodness we don=
't do=20
that, and have never done that.