[PATCH] emacs docstrings: consistent indentation, newlines, periods

2020-05-03 Thread Tomi Ollila
Fixed emacs docstrings to be consistent. No functional change.

- removed some (accidental) indentation
- removed some trailing newlines
- added trailing periods where missing (some exclusions)
---
 emacs/notmuch-address.el | 21 -
 emacs/notmuch-draft.el   |  8 ++--
 emacs/notmuch-hello.el   | 11 ++---
 emacs/notmuch-jump.el|  3 +-
 emacs/notmuch-lib.el | 10 ++--
 emacs/notmuch-maildir-fcc.el |  4 +-
 emacs/notmuch-message.el |  4 +-
 emacs/notmuch-mua.el |  2 +-
 emacs/notmuch-query.el   | 13 +++---
 emacs/notmuch-show.el| 24 +-
 emacs/notmuch-tag.el |  8 ++--
 emacs/notmuch-tree.el| 88 ++--
 emacs/notmuch-wash.el|  2 +-
 emacs/notmuch.el | 34 +++---
 14 files changed, 114 insertions(+), 118 deletions(-)

diff --git a/emacs/notmuch-address.el b/emacs/notmuch-address.el
index 64887a43..0d56fba7 100644
--- a/emacs/notmuch-address.el
+++ b/emacs/notmuch-address.el
@@ -29,11 +29,11 @@
 (declare-function company-manual-begin "company")
 
 (defvar notmuch-address-last-harvest 0
-  "Time of last address harvest")
+  "Time of last address harvest.")
 
 (defvar notmuch-address-completions (make-hash-table :test 'equal)
   "Hash of email addresses for completion during email composition.
-  This variable is set by calling `notmuch-address-harvest'.")
+This variable is set by calling `notmuch-address-harvest'.")
 
 (defvar notmuch-address-full-harvest-finished nil
   "t indicates that full completion address harvesting has been
@@ -73,11 +73,11 @@ (defcustom notmuch-address-internal-completion '(sent nil)
   "Determines how internal address completion generates candidates.
 
 This should be a list of the form '(DIRECTION FILTER), where
- DIRECTION is either sent or received and specifies whether the
- candidates are searched in messages sent by the user or received
- by the user (note received by is much faster), and FILTER is
- either nil or a filter-string, such as \"date:1y..\" to append
- to the query."
+DIRECTION is either sent or received and specifies whether the
+candidates are searched in messages sent by the user or received
+by the user (note received by is much faster), and FILTER is
+either nil or a filter-string, such as \"date:1y..\" to append
+to the query."
   :type '(list :tag "Use internal address completion"
   (radio
:tag "Base completion on messages you have"
@@ -126,8 +126,7 @@ (defcustom notmuch-address-post-completion-functions nil
 
 The completed address is passed as an argument to each function.
 Note that this hook will be invoked for completion in headers
-matching `notmuch-address-completion-headers-regexp'.
-"
+matching `notmuch-address-completion-headers-regexp'."
   :type 'hook
   :group 'notmuch-address
   :group 'notmuch-hooks)
@@ -147,7 +146,7 @@ (defun notmuch-address-message-insinuate ()
   (message "calling notmuch-address-message-insinuate is no longer needed"))
 
 (defcustom notmuch-address-use-company t
-  "If available, use company mode for address completion"
+  "If available, use company mode for address completion."
   :type 'boolean
   :group 'notmuch-send
   :group 'notmuch-address)
@@ -285,7 +284,7 @@ (defun notmuch-address-harvest-filter (proc string)
 (defvar notmuch-address-harvest-procs '(nil . nil)
   "The currently running harvests.
 
-The car is a partial harvest, and the cdr is a full harvest")
+The car is a partial harvest, and the cdr is a full harvest.")
 
 (defun notmuch-address-harvest ( addr-prefix synchronous callback)
   "Collect addresses completion candidates.
diff --git a/emacs/notmuch-draft.el b/emacs/notmuch-draft.el
index 504b33be..531666d0 100644
--- a/emacs/notmuch-draft.el
+++ b/emacs/notmuch-draft.el
@@ -45,7 +45,7 @@ (defcustom notmuch-draft-tags '("+draft")
 For example, if you wanted to give the message a \"draft\" tag
 but not the (normally added by default) \"inbox\" tag, you would
 set:
-(\"+draft\" \"-inbox\")"
+(\"+draft\" \"-inbox\")."
   :type '(repeat string)
   :group 'notmuch-draft)
 
@@ -76,7 +76,7 @@ (defcustom notmuch-draft-quoted-tags '()
 
 (defcustom notmuch-draft-save-plaintext 'ask
   "Should notmuch save/postpone in plaintext messages that seem
-  like they are intended to be sent encrypted
+like they are intended to be sent encrypted
 (i.e with an mml encryption tag in it)."
   :type '(radio
  (const :tag "Never" nil)
@@ -87,10 +87,10 @@ (defcustom notmuch-draft-save-plaintext 'ask
 
 (defvar notmuch-draft-encryption-tag-regex
   "<#\\(part encrypt\\|secure.*mode=.*encrypt>\\)"
-  "Regular expression matching mml tags indicating encryption of part or 
message")
+  "Regular expression matching mml tags indicating encryption of part or 
message.")
 
 (defvar notmuch-draft-id nil
-  "Message-id of the most recent saved draft of this message")
+  "Message-id of the most recent saved draft of this message.")
 (make-variable-buffer-local 

Re: waiting tag

2020-05-03 Thread Keegan Carruthers-Smith
Chris Tennant  writes:

> I would like to have emails that I am waiting on a response for to have a
> special tag that is removed once I get a reply.  There are other products
> that do this, but I would much rather do it all from NotMuchMail.

You can add a "post-new" hook which does this. Assuming you are use
"waiting" as the special tag and notmuch's default "new" tag this could work
for you:

  notmuch tag -waiting -- tag:waiting and 'thread:{tag:new}'

Just ensure you are clearing out the new tag to get the correct
behaviour. For example by running "notmuch tag -new -- tag:new" at the
end of your post-new hook.

Cheers,
Keegan
___
notmuch mailing list
notmuch@notmuchmail.org
https://notmuchmail.org/mailman/listinfo/notmuch


waiting tag

2020-05-03 Thread Chris Tennant
I would like to have emails that I am waiting on a response for to have a
special tag that is removed once I get a reply.  There are other products
that do this, but I would much rather do it all from NotMuchMail.

---
Chris Tennant
___
notmuch mailing list
notmuch@notmuchmail.org
https://notmuchmail.org/mailman/listinfo/notmuch


Re: notmuch and mailing lists

2020-05-03 Thread Sean Whitton
Hello Reto,

On Sat 02 May 2020 at 03:13pm +02, Reto wrote:

> On Fri, May 01, 2020 at 12:30:28PM -0700, Sean Whitton wrote:
>> I've not yet used NNTP to read mailing lists myself, but I think there
>> are limitations to the way I currently read lists
>
> What are you missing exactly?
> If we know what your actual problems are there might be better solutions 
> forthcoming.

Well, I would like to be able to handle a higher volume of messages
faster.  I think that I am typically reluctant to subscribe to new lists
because I know that I'm not efficient at processing the mail.

People who use NNTP to read mailing lists talk about the following sorts
of things which speed things up:

- efficient killfiles/filters
- manually killing subthreads
- expiration/catching up
- browsing lists without going through the process of subscription
  and/or downloading archives

I'd be interested to hear what techniques people have for making notmuch
capable of getting through mailing list mail faster.  I find that
notmuch is great for practising Inbox Zero on personal mail, and for
searching to find old mail, but I haven't made it especially good for
dealing with discussion forums yet.

I've come up with a few ideas myself in the past few days but they're
fairly simple.

-- 
Sean Whitton
___
notmuch mailing list
notmuch@notmuchmail.org
https://notmuchmail.org/mailman/listinfo/notmuch


Re: [PATCH] emacs: split-window-sensibly in tree mode with open message

2020-05-03 Thread David Bremner
Radu Butoi  writes:

> Also, should I update the NEWS file? I see its latest changes are in
> November and there's been user-visible changes since.

We seem to have got into the habit of updating the NEWS file right
before release. This seems to work OK, and avoids some conflicts between
patch series.

d
___
notmuch mailing list
notmuch@notmuchmail.org
https://notmuchmail.org/mailman/listinfo/notmuch