From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Ted Zlatanov Newsgroups: gmane.emacs.devel Subject: Re: GnuTLS and zeroing keys in Emacs Date: Mon, 17 Jul 2017 10:07:11 -0400 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <87lgnndunk.fsf@lifelogs.com> References: <9ee79781-8de0-06ef-6477-28af9852a92b@cs.ucla.edu> <877ez9frug.fsf@lifelogs.com> <40a0b98c-fa93-2183-a4fb-141683f8a042@cs.ucla.edu> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1500300513 6144 195.159.176.226 (17 Jul 2017 14:08:33 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 17 Jul 2017 14:08:33 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jul 17 16:08:24 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dX6h9-0000x6-MS for ged-emacs-devel@m.gmane.org; Mon, 17 Jul 2017 16:08:19 +0200 Original-Received: from localhost ([::1]:50650 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dX6hF-0000sG-7U for ged-emacs-devel@m.gmane.org; Mon, 17 Jul 2017 10:08:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52851) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dX6gQ-0000K1-3W for emacs-devel@gnu.org; Mon, 17 Jul 2017 10:07:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dX6gN-0000KG-0F for emacs-devel@gnu.org; Mon, 17 Jul 2017 10:07:34 -0400 Original-Received: from [195.159.176.226] (port=34444 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dX6gM-0000Js-PS for emacs-devel@gnu.org; Mon, 17 Jul 2017 10:07:30 -0400 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1dX6gB-0006cd-SM for emacs-devel@gnu.org; Mon, 17 Jul 2017 16:07:19 +0200 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: emacs-devel@gnu.org Original-Lines: 18 Original-X-Complaints-To: usenet@blaine.gmane.org X-Face: bd.DQ~'29fIs`T_%O%C\g%6jW)yi[zuz6; d4V0`@y-~$#3P_Ng{@m+e4o<4P'#(_GJQ%TT= D}[Ep*b!\e,fBZ'j_+#"Ps?s2!4H2-Y"sx" Mail-Copies-To: never Cancel-Lock: sha1:RATyd1qU5akiD1m7zaW7aEWgpy0= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:216775 Archived-At: On Sun, 16 Jul 2017 17:29:09 -0700 Paul Eggert 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