Update FAQ

This commit is contained in:
M66B 2024-04-18 08:44:38 +02:00
parent 785387955f
commit bd60de816c
2 changed files with 63 additions and 0 deletions

36
FAQ.md
View File

@ -2692,6 +2692,10 @@ If a rule is part of a group, stop processing means stop processing the group.
Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx. Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx.
<br>
**Conditions**
The following rule conditions are available: The following rule conditions are available:
* Sender (from, reply-to) contains or sender is contact * Sender (from, reply-to) contains or sender is contact
@ -2702,6 +2706,7 @@ The following rule conditions are available:
* Text contains (since version 1.1785) * Text contains (since version 1.1785)
* Absolute time (received) between (since version 1.1540) * Absolute time (received) between (since version 1.1540)
* Relative time (received) between * Relative time (received) between
* Expression (since version 1.2174)
All the conditions of a rule need to be true for the rule action to be executed. All the conditions of a rule need to be true for the rule action to be executed.
All conditions are optional, but there needs to be at least one condition, to prevent matching all messages. All conditions are optional, but there needs to be at least one condition, to prevent matching all messages.
@ -2744,6 +2749,31 @@ Note that a regular expression supports an *or* operator, so if you want to matc
Note that [dot all mode](https://developer.android.com/reference/java/util/regex/Pattern#DOTALL) is enabled Note that [dot all mode](https://developer.android.com/reference/java/util/regex/Pattern#DOTALL) is enabled
to be able to match [unfolded headers](https://tools.ietf.org/html/rfc2822#section-3.2.3). to be able to match [unfolded headers](https://tools.ietf.org/html/rfc2822#section-3.2.3).
Since version 1.2174 it is possible to use expression conditions, which is [experimental](#faq125) for now.
Please [see here](https://ezylang.github.io/EvalEx/references/references.html) about which constants, operators and functions are available.
The following extra variables are available:
* from (array)
* to (array)
* subject (array)
* text (array)
* hasAttachments (boolean)
The following extra operators are available:
* (array) contains
* (array) matches (=regex)
The following extra functions are available:
* header(name)
<br>
**Actions**
You can select one of these actions to apply to matching messages: You can select one of these actions to apply to matching messages:
* No action (useful for *not*) * No action (useful for *not*)
@ -4044,6 +4074,12 @@ Composing messages using [Markdown](https://en.wikipedia.org/wiki/Markdown) can
<br /> <br />
*Rule expression condition (1.2174+)*
See [this FAQ](#faq71)
<br />
<a name="faq126"></a> <a name="faq126"></a>
**(126) Can message previews be sent to my smartwatch?** **(126) Can message previews be sent to my smartwatch?**

View File

@ -1468,6 +1468,8 @@ X-Google-Original-From: Somebody &lt;somebody+extra@example.org&gt;</code></pre>
<p>You can disable a rule and you can stop processing other rules after a rule has been executed, which can be used to create a <em>not</em> condition.</p> <p>You can disable a rule and you can stop processing other rules after a rule has been executed, which can be used to create a <em>not</em> condition.</p>
<p>Since version 1.2061 rules can be part of a named group. Group names will be displayed in the list of rules. If a rule is part of a group, stop processing means stop processing the group.</p> <p>Since version 1.2061 rules can be part of a named group. Group names will be displayed in the list of rules. If a rule is part of a group, stop processing means stop processing the group.</p>
<p>Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx.</p> <p>Since version 1.2018 there is a rule option to run rules daily on messages (around 1:00am) older than xxx.</p>
<p><br></p>
<p><strong>Conditions</strong></p>
<p>The following rule conditions are available:</p> <p>The following rule conditions are available:</p>
<ul> <ul>
<li>Sender (from, reply-to) contains or sender is contact</li> <li>Sender (from, reply-to) contains or sender is contact</li>
@ -1478,6 +1480,7 @@ X-Google-Original-From: Somebody &lt;somebody+extra@example.org&gt;</code></pre>
<li>Text contains (since version 1.1785)</li> <li>Text contains (since version 1.1785)</li>
<li>Absolute time (received) between (since version 1.1540)</li> <li>Absolute time (received) between (since version 1.1540)</li>
<li>Relative time (received) between</li> <li>Relative time (received) between</li>
<li>Expression (since version 1.2174)</li>
</ul> </ul>
<p>All the conditions of a rule need to be true for the rule action to be executed. All conditions are optional, but there needs to be at least one condition, to prevent matching all messages.</p> <p>All the conditions of a rule need to be true for the rule action to be executed. All conditions are optional, but there needs to be at least one condition, to prevent matching all messages.</p>
<p>If you want to match all senders or all recipients, you can just use the @ character as condition because all email addresses will contain this character. If you want to match a domain name, you can use as a condition something like <em><span class="citation" data-cites="example.org">@example.org</span></em></p> <p>If you want to match all senders or all recipients, you can just use the @ character as condition because all email addresses will contain this character. If you want to match a domain name, you can use as a condition something like <em><span class="citation" data-cites="example.org">@example.org</span></em></p>
@ -1492,6 +1495,27 @@ X-Google-Original-From: Somebody &lt;somebody+extra@example.org&gt;</code></pre>
<p>Note that a regular expression supports an <em>or</em> operator, so if you want to match multiple senders, you can do this:</p> <p>Note that a regular expression supports an <em>or</em> operator, so if you want to match multiple senders, you can do this:</p>
<p><code>.*alice@example\.org.*|.*bob@example\.org.*|.*carol@example\.org.*</code></p> <p><code>.*alice@example\.org.*|.*bob@example\.org.*|.*carol@example\.org.*</code></p>
<p>Note that <a href="https://developer.android.com/reference/java/util/regex/Pattern#DOTALL">dot all mode</a> is enabled to be able to match <a href="https://tools.ietf.org/html/rfc2822#section-3.2.3">unfolded headers</a>.</p> <p>Note that <a href="https://developer.android.com/reference/java/util/regex/Pattern#DOTALL">dot all mode</a> is enabled to be able to match <a href="https://tools.ietf.org/html/rfc2822#section-3.2.3">unfolded headers</a>.</p>
<p>Since version 1.2174 it is possible to use expression conditions, which is <a href="#faq125">experimental</a> for now.</p>
<p>Please <a href="https://ezylang.github.io/EvalEx/references/references.html">see here</a> about which constants, operators and functions are available.</p>
<p>The following extra variables are available:</p>
<ul>
<li>from (array)</li>
<li>to (array)</li>
<li>subject (array)</li>
<li>text (array)</li>
<li>hasAttachments (boolean)</li>
</ul>
<p>The following extra operators are available:</p>
<ul>
<li>(array) contains</li>
<li>(array) matches (=regex)</li>
</ul>
<p>The following extra functions are available:</p>
<ul>
<li>header(name)</li>
</ul>
<p><br></p>
<p><strong>Actions</strong></p>
<p>You can select one of these actions to apply to matching messages:</p> <p>You can select one of these actions to apply to matching messages:</p>
<ul> <ul>
<li>No action (useful for <em>not</em>)</li> <li>No action (useful for <em>not</em>)</li>
@ -2088,6 +2112,9 @@ $NotDisplayed</code></pre>
<p><em>Markdown (1.2061+)</em></p> <p><em>Markdown (1.2061+)</em></p>
<p>Composing messages using <a href="https://en.wikipedia.org/wiki/Markdown">Markdown</a> can be enabled via the three-dots overflow menu of the message editor.</p> <p>Composing messages using <a href="https://en.wikipedia.org/wiki/Markdown">Markdown</a> can be enabled via the three-dots overflow menu of the message editor.</p>
<p><br /></p> <p><br /></p>
<p><em>Rule expression condition (1.2174+)</em></p>
<p>See <a href="#faq71">this FAQ</a></p>
<p><br /></p>
<p><a name="faq126"></a> <strong>(126) Can message previews be sent to my smartwatch?</strong></p> <p><a name="faq126"></a> <strong>(126) Can message previews be sent to my smartwatch?</strong></p>
<p>🌎 <a href="https://translate.google.com/translate?sl=en&amp;u=https%3A%2F%2Fm66b.github.io%2FFairEmail%2F%23faq126">Google Translate</a></p> <p>🌎 <a href="https://translate.google.com/translate?sl=en&amp;u=https%3A%2F%2Fm66b.github.io%2FFairEmail%2F%23faq126">Google Translate</a></p>
<p>FairEmail fetches a message in two steps:</p> <p>FairEmail fetches a message in two steps:</p>