[Top][All Lists]

[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) 
PE> benefit (in terms of useful information conveyed), and similarly for some 
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 
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!


reply via email to

[Prev in Thread] Current Thread [Next in Thread]