Re: [Evolution] Option for search folder

[Martin Monperrus <martin monperrus gnieh org>]

Dear Ángel, all,

Thanks a lot for your very precise answer.

https://help.gnome.org/users/evolution/unstable/mail-searching.html.en
https://help.gnome.org/users/evolution/unstable/mail-search-folders-add.html.en
https://help.gnome.org/users/evolution/unstable/mail-search-folders-conditions.html.en

Is there a way to directly contribute to those pages?

Best regards,

--Martin

On 10/28/18 12:09 AM, Ángel wrote:

On 2018-10-25 at 18:50 +0200, Martin Monperrus wrote:

Hi all,

I don't understand the following configuration option for search
folders (https://wiki.gnome.org/Apps/Evolution/Search):
Include threads:

Where can I find a one-sentence description of each option?

Hello Martin

Thanks for your question.

The obvious places to find this would be on one of these locations:
https://help.gnome.org/users/evolution/unstable/mail-searching.html.en
https://help.gnome.org/users/evolution/unstable/mail-search-folders-add.html.en
https://help.gnome.org/users/evolution/unstable/mail-search-folders-conditions.html.en

But as they don't mention this piece at all, I will attempt to give my
own understanding of this setting.

First of all, we need to take into account that email can be grouped in
threads based on the reply-to relationship.¹

For example, we have your email, this reply to you, and eg. a future
email by André replying to this one, plus another of Milan replying to
that one.
These four emails would be in the same thread (we could call it the
"Option for search folder" thread, but emails on one thread may have
completely different subjects).

When searching, it may be useful to have some context, not just the
emails that exactly match your search (this setting is available both
for advanced search and search folders).

So, suppose you searched for all my emails. Which mails from that thread
would show, depending on this setting?

i) None 

Only the emails that match the search would match, ie. just my email.

ii) All related 

All emails in the same thread are included.

In the example thread, all the four emails would show as results, even
if only this one would exactly match the From: condition you set.

iii) Replies 

The result includes the email that match the rest of the query, as well
as all replies descendant of that email.

In the example thread, it would return three emails: my message and
replies by André and Milan.

iv) Replies and parents

The result includes the email that match the rest of the query, as well
as all parent emails and all replies descendant of that email.
However, siblings and their offspring are not included.

In the example thread, all four messages would be included, but if
someone else also replied to your original email, that reply would not
be included.

v) No reply or parent

The message will only be shown if it is not replying to anyone and there
is no reply to it, either.
The other options only augment the result set based on the thread, but
this is one a bit different, as it restricts the result to only messages
that are not part of a thread.

In the example thread, nothing would be returned.


Best regards


---


¹ This is constructed in the In-Reply-To and References headers.
Microsoft, its own header.


Note: that wiki page is misformatted, it probably stopped being rendered
as it used to be at a GNOME wiki update and nobody noticed. I can work
on fixing it, but my user (ÁngelGonzález) lacks write rights there, so
someone would need to give it edit rights (I'm quite sure that someone
had already marked it as "not a bot" a long time ago, but apparently it
got lost).




Implementation details:
-----------------------

These GUI options map to the _filter_threading_t enum defined on
src/e-util/e-filter-rule.h

/* threading, if the context supports it */
enum _filter_threading_t {
	E_FILTER_THREAD_NONE,	/* don't add any thread matching */
	E_FILTER_THREAD_ALL,	/* add all possible threads */
	E_FILTER_THREAD_REPLIES,	/* add only replies */
	E_FILTER_THREAD_REPLIES_PARENTS,	/* replies plus parents */
	E_FILTER_THREAD_SINGLE	/* messages with no replies or parents */
};

which themselves map to the match-threads options "all", "replies",
"replies_parents" and "single" in the internal language. Finally
translated in evolution-data-server src/camel/camel-folder-search.c to
ids 0 to 4 and applied accordingly (see function
folder_search_match_threads)

I am attaching a small patch that adds some comments to
folder_search_match_threads.


Kind regards

_______________________________________________
evolution-list mailing list
evolution-list gnome org
To change your list options or unsubscribe, visit ...
https://mail.gnome.org/mailman/listinfo/evolution-list