Re: [PATCH] Desktop mode saves mark-ring too verbosely

[Ivan Shmakov]

>>>>> Kelly Dean <address@hidden> writes:
>>>>> Ivan Shmakov wrote:

[…]

 >>> +(defvar desktop-var-serdes-funs

[…]

 >>> +  "Table of serdes functions for variables.

 >> 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.

        Incidentally, reading and development of digital circuits is one
        of my hobbies.  Yet, I don’t think I’ve ever seen such an
        abbreviation before in that domain, either.

 >> so I guess “serializer, deserializer” should rather be spelled in
 >> full.

 > This table is something that only programmers, not users, 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⌝.

        Still, their respective docstrings spell the term in full:

(fboundp SYMBOL): Return t if SYMBOL's function definition is not void.
(fmakunbound SYMBOL): Make SYMBOL's function definition be void.

        Contrary to the docstring proposed.

 > So if anything, ⌜funs⌝ isn't abbreviated _enough_. ;-)

        Then just drop that part.

[…]

 > BTW, you quoted only me, but you CCed only Stefan.

        It was unintended, sorry.  Unless under special circumstances,
        I post my followups strictly to the list, – not to the
        participants of the discussion directly.

 > I almost missed your message, until I checked the mailing list.

        (Hope you’ll check the mailing list this time, too.)

-- 
FSF associate member #7257  np. Birdeto — Helena Melnikova   … B6A0 230E 334A