From: Thien-Thi Nguyen <ttn@gnu.org>
To: emacs-devel@gnu.org
Subject: Re: Your commit 7409a79
Date: Tue, 09 Dec 2014 10:36:39 +0100 [thread overview]
Message-ID: <874mt5b1w8.fsf@zigzag.favinet> (raw)
In-Reply-To: <858uih9rea.fsf@stephe-leake.org> (Stephen Leake's message of "Tue, 09 Dec 2014 02:08:45 -0600")
[-- Attachment #1: Type: text/plain, Size: 1642 bytes --]
() Stephen Leake <stephen_leake@stephe-leake.org>
() 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
* foo.el (mumble): New func.
(explain, extemporize, spew): Use it.
Under pervasive axiom 3, this could have been written:
Add abstraction: mumble
* 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
* 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
--
Thien-Thi Nguyen
GPG key: 4C807502
(if you're human and you know it)
read my lisp: (responsep (questions 'technical)
(not (via 'mailing-list)))
=> nil
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 197 bytes --]
next prev parent reply other threads:[~2014-12-09 9:36 UTC|newest]
Thread overview: 52+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-12-06 8:56 Your commit 7409a79 Eli Zaretskii
2014-12-06 10:22 ` Andreas Schwab
2014-12-06 10:29 ` Eli Zaretskii
2014-12-06 10:32 ` Paul Eggert
2014-12-06 15:29 ` Yuri Khan
2014-12-06 23:01 ` Stefan Monnier
2014-12-06 16:14 ` Tom
2014-12-06 18:54 ` Eli Zaretskii
2014-12-06 22:43 ` Stephen Leake
2014-12-06 22:33 ` Stephen Leake
2014-12-07 3:52 ` Eli Zaretskii
2014-12-07 22:39 ` Stephen Leake
2014-12-08 1:57 ` Paul Eggert
2014-12-08 2:28 ` Stephen J. Turnbull
2014-12-08 15:58 ` Eli Zaretskii
2014-12-08 23:38 ` Stephen Leake
2014-12-08 15:58 ` Eli Zaretskii
2014-12-08 18:24 ` Paul Eggert
2014-12-08 15:51 ` Eli Zaretskii
2014-12-08 17:32 ` John Yates
2014-12-08 17:57 ` Eli Zaretskii
2014-12-08 18:14 ` Paul Eggert
2014-12-08 18:28 ` Eli Zaretskii
2014-12-08 18:37 ` Eli Zaretskii
2014-12-08 18:54 ` Paul Eggert
2014-12-08 19:00 ` Stefan Monnier
2014-12-08 18:54 ` John Yates
2014-12-08 23:27 ` Stephen Leake
2014-12-09 0:51 ` Thien-Thi Nguyen
2014-12-09 8:08 ` Stephen Leake
2014-12-09 9:36 ` Thien-Thi Nguyen [this message]
2014-12-09 16:57 ` Eli Zaretskii
2014-12-10 9:26 ` Stephen Leake
2014-12-10 16:17 ` Eli Zaretskii
2014-12-10 17:04 ` Stephen Leake
2014-12-10 18:02 ` Eli Zaretskii
2014-12-10 19:20 ` Paul Eggert
2014-12-07 5:45 ` Stephen J. Turnbull
2014-12-06 22:59 ` Stefan Monnier
2014-12-07 22:44 ` Stephen Leake
2014-12-07 23:28 ` Stefan Monnier
2014-12-08 9:34 ` Stephen Leake
2014-12-08 10:22 ` Thien-Thi Nguyen
2014-12-08 14:58 ` Stefan Monnier
2014-12-08 23:32 ` Stephen Leake
2014-12-09 11:00 ` Richard Stallman
2014-12-09 11:09 ` David Kastrup
2014-12-10 8:24 ` Richard Stallman
2014-12-10 17:05 ` Stephen Leake
2014-12-10 19:08 ` Stefan Monnier
2014-12-08 15:54 ` Eli Zaretskii
2014-12-08 23:33 ` Stephen Leake
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=874mt5b1w8.fsf@zigzag.favinet \
--to=ttn@gnu.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.