From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Jonas Bernoulli Newsgroups: gmane.emacs.bugs Subject: bug#41277: [PATCH 5/9] Improve and add doc-strings Date: Thu, 14 May 2020 21:13:21 +0200 Message-ID: <20200514191325.22061-6-jonas@bernoul.li> References: <20200514191325.22061-1-jonas@bernoul.li> Mime-Version: 1.0 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="41783"; mail-complaints-to="usenet@ciao.gmane.io" To: 41277@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu May 14 21:19:56 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jZJOe-000Ann-31 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 14 May 2020 21:19:56 +0200 Original-Received: from localhost ([::1]:57346 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jZJOd-00044X-0O for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 14 May 2020 15:19:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56506) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZJJ2-0006Co-J9 for bug-gnu-emacs@gnu.org; Thu, 14 May 2020 15:14:08 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51608) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jZJJ2-0005Wc-AB for bug-gnu-emacs@gnu.org; Thu, 14 May 2020 15:14:08 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jZJJ2-0001Vu-69 for bug-gnu-emacs@gnu.org; Thu, 14 May 2020 15:14:08 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jonas Bernoulli Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 May 2020 19:14:07 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 41277 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15894836275642 (code B ref -1); Thu, 14 May 2020 19:14:07 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 May 2020 19:13:47 +0000 Original-Received: from localhost ([127.0.0.1]:34900 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jZJIh-0001Sr-0h for submit@debbugs.gnu.org; Thu, 14 May 2020 15:13:47 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:49268) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jZJIb-0001S3-MM for submit@debbugs.gnu.org; Thu, 14 May 2020 15:13:42 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56370) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZJIb-0005rt-Hs for bug-gnu-emacs@gnu.org; Thu, 14 May 2020 15:13:41 -0400 Original-Received: from mail.hostpark.net ([212.243.197.30]:50326) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jZJIV-0005PM-EX for bug-gnu-emacs@gnu.org; Thu, 14 May 2020 15:13:41 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by mail.hostpark.net (Postfix) with ESMTP id 5F63D166D2 for ; Thu, 14 May 2020 21:13:27 +0200 (CEST) X-Virus-Scanned: by Hostpark/NetZone Mailprotection at hostpark.net Original-Received: from mail.hostpark.net ([127.0.0.1]) by localhost (mail0.hostpark.net [127.0.0.1]) (amavisd-new, port 10124) with ESMTP id DW6i5xNW2c0D for ; Thu, 14 May 2020 21:13:26 +0200 (CEST) Original-Received: from customer (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mail.hostpark.net (Postfix) with ESMTPSA id 5D962166BD for ; Thu, 14 May 2020 21:13:26 +0200 (CEST) X-Mailer: git-send-email 2.26.0 In-Reply-To: <20200514191325.22061-1-jonas@bernoul.li> Received-SPF: none client-ip=212.243.197.30; envelope-from=jonas@bernoul.li; helo=mail.hostpark.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/14 15:13:27 X-ACL-Warn: Detected OS = ??? X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:180258 Archived-At: * lisp/epa-file.el (epa-file-select-keys), lisp/epa-hook.el (epa-file-name-regexp), lisp/epa.el (epa-exit-buffer): Improve doc-string. * lisp/epa-hook.el (epa-file-name-regexp-update): Add doc-string. --- lisp/epa-file.el | 4 ++-- lisp/epa-hook.el | 11 +++++++---- lisp/epa.el | 3 +-- 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/lisp/epa-file.el b/lisp/epa-file.el index 43399d2852..ede7177054 100644 --- a/lisp/epa-file.el +++ b/lisp/epa-file.el @@ -43,9 +43,9 @@ epa-file-cache-passphrase-for-symmetric-encryption (defcustom epa-file-select-keys nil "Control whether or not to pop up the key selection dialog. -If t, always asks user to select recipients. +If t, always ask user to select recipients. If nil, query user only when `epa-file-encrypt-to' is not set. -If neither t nor nil, doesn't ask user. In this case, symmetric +If neither t nor nil, don't ask user. In this case, symmetric encryption is used." :type '(choice (const :tag "Ask always" t) (const :tag "Ask when recipients are not set" nil) diff --git a/lisp/epa-hook.el b/lisp/epa-hook.el index 002f46ad27..6f12f8a6bf 100644 --- a/lisp/epa-hook.el +++ b/lisp/epa-hook.el @@ -36,10 +36,10 @@ epa-file--file-name-regexp-set (defcustom epa-file-name-regexp (purecopy "\\.gpg\\(~\\|\\.~[0-9]+~\\)?\\'") "Regexp which matches filenames to be encrypted with GnuPG. -If you set this outside Custom while epa-file is already enabled, you -have to call `epa-file-name-regexp-update' after setting it to -properly update file-name-handler-alist. Setting this through Custom -does that automatically." +If you set this outside Custom while epa-file is already enabled, +you have to call `epa-file-name-regexp-update' after setting it +to properly update `file-name-handler-alist'. Setting this +through Custom does that automatically." :type 'regexp :group 'epa-file :set 'epa-file--file-name-regexp-set) @@ -73,6 +73,9 @@ epa-file-auto-mode-alist-entry (list epa-file-name-regexp nil 'epa-file)) (defun epa-file-name-regexp-update () + "Update `file-name-handler-alist' after configuring outside Custom. +After setting `epa-file-name-regexp-update' outside the Custom +interface, update `file-name-handler-alist'." (interactive) (unless (equal (car epa-file-handler) epa-file-name-regexp) (setcar epa-file-handler epa-file-name-regexp))) diff --git a/lisp/epa.el b/lisp/epa.el index 62a4941f9d..b06b0ac8e4 100644 --- a/lisp/epa.el +++ b/lisp/epa.el @@ -347,8 +347,7 @@ epa-unmark-key ;;;; Quitting (defun epa-exit-buffer () - "Exit the current buffer. -`epa-exit-buffer-function' is called if it is set." + "Exit the current buffer using `epa-exit-buffer-function'." (interactive) (funcall epa-exit-buffer-function)) -- 2.26.0