all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Stephen J. Turnbull" <stephen@xemacs.org>
To: Kelly Dean <kelly@prtime.org>
Cc: Ivan Shmakov <ivan@siamics.net>, emacs-devel@gnu.org
Subject: Re: [PATCH] Desktop mode saves mark-ring too verbosely
Date: Sat, 24 Jan 2015 12:08:01 +0900	[thread overview]
Message-ID: <87r3ukub8u.fsf@uwakimon.sk.tsukuba.ac.jp> (raw)
In-Reply-To: <zAwK94ZYp8UIBiHHT99DSX1pkrO89cwvoYCvRsKoxr5@local>

Kelly Dean writes:

 > > It doesn’t look like a common abbreviation,
 > 
 > It's a common abbreviation for parallel↔serial conversion circuits,
 > which are reasonably analogous to functions that convert program
 > data to/from a text stream. And circuitry is a domain for which
 > it's common to share terminology with software.

Please don't add new abbreviations.  The docstring and/or comments can
indicate that "serializer" stands for both directions if you really
need a shorter variable name.  Or use "serialization", which is
somewhat more ambiguous about including "deserialization".

 > This table is something that only programmers, not users,

The point of free software is that there's no such distinction worth
making.  Whether one agrees philosphically or not, it makes sense to
take advantage of the "many eyes".

 > will need to understand or modify, so using a technical
 > abbreviation isn't a problem. Emacs already has abbreviated names
 > such as ⌜fboundp⌝ and ⌜fmakunbound⌝ for programmer-only things,
 > instead of ⌜function-bound-predicate⌝ and ⌜function-make-unbound⌝.

And the recent trend is to deprecate such ancient usage, including the
venerable `car', `cdr', and `cons'.

 > Spelling out
 > ⌜desktop-variable-serialization-deserialization-functions⌝ would be
 > ironic, considering the purpose of my patch.

I thought your patch was a refactoring.  That doesn't necessarily mean
code (or code components) are shorter, although it's often a happy
accidental outcome.




  parent reply	other threads:[~2015-01-24  3:08 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-05-22  3:44 [PATCH] Desktop mode saves mark-ring too verbosely Kelly Dean
2013-11-23 13:40 ` Stefan Monnier
2015-01-21 12:11   ` Kelly Dean
2015-01-21 15:04     ` Stefan Monnier
2015-01-22  5:43       ` Kelly Dean
2015-01-22  8:20         ` Ivan Shmakov
2015-01-23 13:20           ` Kelly Dean
2015-01-23 14:09             ` Ivan Shmakov
2015-01-24  3:08             ` Stephen J. Turnbull [this message]
2015-01-24 23:30               ` Elisp terminology (was: Re: [PATCH] Desktop mode saves mark-ring too verbosely) Kelly Dean
2015-01-25  9:49                 ` Elisp terminology David Kastrup
  -- strict thread matches above, loose matches on Subject: below --
2015-01-23  2:59 Rant - Elisp terminology is deceptive Kelly Dean
2015-01-23 20:15 ` Stefan Monnier
2015-01-24  0:41   ` Kelly Dean
2015-01-24  0:48     ` Óscar Fuentes
2015-01-24  3:28     ` Stephen J. Turnbull
2015-01-24  8:51       ` Eli Zaretskii
2015-01-24 10:32         ` Kelly Dean
2015-01-24 11:26           ` Eli Zaretskii
2015-01-24 10:30       ` Kelly Dean
2015-01-24 11:03         ` David Kastrup
2015-01-24 23:24           ` Kelly Dean
2015-01-25  9:16             ` David Kastrup
2015-01-26  3:52               ` Kelly Dean
2015-01-26  8:28                 ` Thien-Thi Nguyen

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=87r3ukub8u.fsf@uwakimon.sk.tsukuba.ac.jp \
    --to=stephen@xemacs.org \
    --cc=emacs-devel@gnu.org \
    --cc=ivan@siamics.net \
    --cc=kelly@prtime.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.