From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Your commit 7409a79 Date: Tue, 09 Dec 2014 10:36:39 +0100 Message-ID: <874mt5b1w8.fsf@zigzag.favinet> References: <83h9x917il.fsf@gnu.org> <85k324h0hg.fsf@stephe-leake.org> <83k324yv44.fsf@gnu.org> <85tx17dqzy.fsf@stephe-leake.org> <83y4qixhq8.fsf@gnu.org> <85r3w9bu3y.fsf@stephe-leake.org> <878uihbq7q.fsf@zigzag.favinet> <858uih9rea.fsf@stephe-leake.org> Reply-To: emacs-devel@gnu.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1418117585 1099 80.91.229.3 (9 Dec 2014 09:33:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 9 Dec 2014 09:33:05 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 09 10:32:57 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 1XyHA8-0006EE-Qq for ged-emacs-devel@m.gmane.org; Tue, 09 Dec 2014 10:32:56 +0100 Original-Received: from localhost ([::1]:38696 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyHA8-00034j-C0 for ged-emacs-devel@m.gmane.org; Tue, 09 Dec 2014 04:32:56 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59823) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyH9x-0002rp-0o for emacs-devel@gnu.org; Tue, 09 Dec 2014 04:32:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XyH9q-0001g9-QD for emacs-devel@gnu.org; Tue, 09 Dec 2014 04:32:44 -0500 Original-Received: from smtp205.alice.it ([82.57.200.101]:40931) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyH9q-0001fR-G4 for emacs-devel@gnu.org; Tue, 09 Dec 2014 04:32:38 -0500 Original-Received: from zigzag.favinet (95.233.66.147) by smtp205.alice.it (8.6.060.28) id 547D8A4D01BC80F0 for emacs-devel@gnu.org; Tue, 9 Dec 2014 10:32:34 +0100 Original-Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1XyHDv-0002HH-7u for emacs-devel@gnu.org; Tue, 09 Dec 2014 10:36:51 +0100 Mail-Followup-To: emacs-devel@gnu.org In-Reply-To: <858uih9rea.fsf@stephe-leake.org> (Stephen Leake's message of "Tue, 09 Dec 2014 02:08:45 -0600") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.101 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:179540 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable () Stephen Leake () Tue, 09 Dec 2014 02:08:45 -0600 Ah, but why limit the exception to the TITLE? The rest of the commit entry is also describing changes. That's my problem :). That escape hatch is TITLE-only to conserve space, i suppose. In the entry BODY, an extra dot at the end (and quoting, YMMV) is no big deal. E.g.: Add abstraction: mumble =20 * foo.el (mumble): New func. (explain, extemporize, spew): Use it. Under pervasive axiom 3, this could have been written: Add abstraction: mumble =20 * foo.el (mumble): new func (explain, extemporize, spew): Use it. but that naked "new func" is jarring (i use lowercase "n" for emphasis) w/in the BODY context. All IMHO, of course. Actually, for this case, to reduce redundancy, i might instead settle on: Add abstraction: mumble =20 * foo.el (mumble): ...here. (explain, extemporize, spew): Use it. as long as i'm comfortable equating "abstraction" w/ "func". Anyway, writing a style guide is tough work, so kudos to those who Do It. I like style guides that include rationale, personally. "this will be here for posterity" was _not_ true for the NASA projects I worked on; it is true for Emacs. I think that will be sufficient motivation for me. It's very possible that Emacs will outlast NASA. I don't think i'll be around to find out, though... :-D =2D-=20 Thien-Thi Nguyen GPG key: 4C807502 (if you're human and you know it) read my lisp: (responsep (questions 'technical) (not (via 'mailing-list))) =3D> nil --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlSGwqsACgkQZwMiJEyAdQKDwACgwxbh6dQwKxUNa3h5+SQaNsT9 1UMAmweDWK0ggegV3cHnVn8uc0Dr4s6U =tBXO -----END PGP SIGNATURE----- --=-=-=--