[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: GnuTLS and zeroing keys in Emacs
|
From: |
Ted Zlatanov |
|
Subject: |
Re: GnuTLS and zeroing keys in Emacs |
|
Date: |
Mon, 17 Jul 2017 10:07:11 -0400 |
|
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) |
On Sun, 16 Jul 2017 17:29:09 -0700 Paul Eggert <address@hidden> wrote:
PE> I restored those particular comments by installing the attached patch. That
PE> being said, I found the comments to have more cost (in terms of clutter)
than
PE> benefit (in terms of useful information conveyed), and similarly for some
nearby
PE> comments that I also removed.
Understood. I think this is a balancing act for sure. Thank you for
restoring some of the comments.
PE> Doc strings for functions should use the imperative form, as it is typically
PE> shorter and less likely to be misunderstood. For example the doc string for
the
PE> 'length' function begins "Return the length of ...".
I had never noticed that in the docs, and it's explained already in
doc/lispref/tips.texi so I'll make sure to re-read those tips :) Thanks!
Ted