From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#34588: 27.0.50; Doc of write-contents-functions: arguments? Date: Thu, 21 Feb 2019 21:06:08 -0500 Message-ID: References: <87bm3715bu.fsf@web.de> <83y36agz88.fsf@gnu.org> <837edthkfd.fsf@gnu.org> <87y369ydil.fsf@web.de> <5C6E6C97.6000605@gmx.at> <87imxdxze6.fsf@web.de> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="267165"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 34588@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Feb 22 03:07:22 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gx0FG-0017HX-IW for geb-bug-gnu-emacs@m.gmane.org; Fri, 22 Feb 2019 03:07:22 +0100 Original-Received: from localhost ([127.0.0.1]:42643 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gx0FF-0001qd-Jd for geb-bug-gnu-emacs@m.gmane.org; Thu, 21 Feb 2019 21:07:21 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:34841) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gx0F6-0001nv-AI for bug-gnu-emacs@gnu.org; Thu, 21 Feb 2019 21:07:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gx0Ey-00079a-QS for bug-gnu-emacs@gnu.org; Thu, 21 Feb 2019 21:07:08 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:33941) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gx0Ex-00075c-Sp for bug-gnu-emacs@gnu.org; Thu, 21 Feb 2019 21:07:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gx0Ew-0002Ke-IU for bug-gnu-emacs@gnu.org; Thu, 21 Feb 2019 21:07:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 22 Feb 2019 02:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34588 X-GNU-PR-Package: emacs Original-Received: via spool by 34588-submit@debbugs.gnu.org id=B34588.15508011838908 (code B ref 34588); Fri, 22 Feb 2019 02:07:02 +0000 Original-Received: (at 34588) by debbugs.gnu.org; 22 Feb 2019 02:06:23 +0000 Original-Received: from localhost ([127.0.0.1]:47485 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gx0EG-0002Ja-Ip for submit@debbugs.gnu.org; Thu, 21 Feb 2019 21:06:22 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:48109) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gx0EA-0002JI-Bh for 34588@debbugs.gnu.org; Thu, 21 Feb 2019 21:06:15 -0500 Original-Received: from fencepost.gnu.org ([209.51.188.10]:52000) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gx0E4-0004lQ-IS; Thu, 21 Feb 2019 21:06:08 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1gx0E4-0000QR-Ba; Thu, 21 Feb 2019 21:06:08 -0500 In-Reply-To: <87imxdxze6.fsf@web.de> (message from Michael Heerdegen on Thu, 21 Feb 2019 10:29:53 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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: 209.51.188.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:155628 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > so the naming convention is preserved and everything should have been > > clear. I believe that due to how the documentation is written, > > readers intuitively pay less attention to the "or their return values > > are used in some way" and "or their return values are used" phrases. > Hmm, you're right, the explanation clearly tells it. Dunno how to > improve it to let people pay more attention - more jokes maybe? If people work on this, I think they will find a way. -- Dr Richard Stallman President, Free Software Foundation (https://gnu.org, https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)