From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Your commit 7409a79 Date: Wed, 10 Dec 2014 03:24:47 -0500 Message-ID: References: <83h9x917il.fsf@gnu.org> <85ppbvdqqu.fsf@stephe-leake.org> <85bnnecwnt.fsf@stephe-leake.org> <87bnndjd07.fsf@fencepost.gnu.org> Reply-To: rms@gnu.org NNTP-Posting-Host: plane.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: ger.gmane.org 1418199952 11619 80.91.229.3 (10 Dec 2014 08:25:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Dec 2014 08:25:52 +0000 (UTC) Cc: emacs-devel@gnu.org To: David Kastrup Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 10 09:25:48 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Xycag-0006Rh-Bu for ged-emacs-devel@m.gmane.org; Wed, 10 Dec 2014 09:25:46 +0100 Original-Received: from localhost ([::1]:43870 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xycaf-0003Jg-T7 for ged-emacs-devel@m.gmane.org; Wed, 10 Dec 2014 03:25:45 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XycZk-0002Re-UF for emacs-devel@gnu.org; Wed, 10 Dec 2014 03:24:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XycZj-0003OY-U0 for emacs-devel@gnu.org; Wed, 10 Dec 2014 03:24:48 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:49570) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XycZj-0003OU-QN for emacs-devel@gnu.org; Wed, 10 Dec 2014 03:24:47 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1XycZj-0004c1-9O; Wed, 10 Dec 2014 03:24:47 -0500 In-reply-to: <87bnndjd07.fsf@fencepost.gnu.org> (message from David Kastrup on Tue, 09 Dec 2014 12:09:28 +0100) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179628 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. ]]] > Write documentation strings in the active voice, not the passive, > and in the present tense, not the future. For instance, use > Return a list containing A and B. instead of A list containing A > and B will be returned. Thanks. I should probably move the advice from there into the GNU standards, since they are applicable to any manual. -- Dr Richard Stallman President, Free Software Foundation 51 Franklin St Boston MA 02110 USA www.fsf.org www.gnu.org Skype: No way! That's nonfree (freedom-denying) software. Use Ekiga or an ordinary phone call.