This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hop-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 923109f637 Website updated to 2ff35d7
923109f637 is described below
commit 923109f6371fda322c6d1facf1a3f23063c30be0
Author: jenkins <[email protected]>
AuthorDate: Sun Nov 1 09:43:04 2026 +0000
Website updated to 2ff35d7
---
manual/next/workflow/actions/getpop.html | 103 ++++++++++++--
manual/next/workflow/actions/mailvalidator.html | 70 +++++++++-
manual/next/workflow/actions/pgpdecryptfiles.html | 159 ++++++++++++++++++----
manual/next/workflow/actions/pgpencryptfiles.html | 151 +++++++++++++++++---
manual/next/workflow/actions/pgpverify.html | 38 ++++++
5 files changed, 458 insertions(+), 63 deletions(-)
diff --git a/manual/next/workflow/actions/getpop.html
b/manual/next/workflow/actions/getpop.html
index 7b59b9b29d..38636d990b 100644
--- a/manual/next/workflow/actions/getpop.html
+++ b/manual/next/workflow/actions/getpop.html
@@ -2978,14 +2978,14 @@
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock"><strong>Mail Server Connection</strong></p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Mail
Connection</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Mail
Server Connection</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">If a mail
server connection is selected here, the rest of this tab is ignored. The server
configuration will be taken from the <a
href="../../metadata-types/mail-server-connection.html" class="xref page">Mail
Server Connection</a> metadata item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Server Settings</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Workflow
action name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Action
name</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name
of the workflow action.</p></td>
</tr>
<tr>
@@ -3002,7 +3002,7 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Port</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The port
to run the SSL POP3 or IMAP connection over.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The port
of the POP3 or IMAP server, with or without SSL.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Username</p></td>
@@ -3133,10 +3133,6 @@
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">IMAP settings</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Option</p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
-</tr>
-<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">IMAP
folder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">the folder
on the IMAP server to retrieve messages from</p></td>
</tr>
@@ -3257,10 +3253,6 @@
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Content</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Option</p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
-</tr>
-<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Body</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">messages
will be filtered on the specified text in the email body</p></td>
</tr>
@@ -3268,10 +3260,6 @@
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Received date</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Option</p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock">Description</p></td>
-</tr>
-<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Condition</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
<p>Choose a date or date range. The available options are</p>
@@ -3296,6 +3284,10 @@
</ul>
</div></div></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Date 1,
Date 2</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The dates
for the condition, in the format <code>yyyy-MM-dd HH:mm:ss</code>.</p></td>
+</tr>
</tbody>
</table>
</div>
@@ -3315,6 +3307,87 @@
</ul>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="_result"><a class="link" href="#_result">Result</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What this action passes on to the next action. See <a
href="../action-results.html" class="xref page">Action results</a> for how
results travel through a workflow.</p>
+</div>
+<table class="tableblock frame-all grid-all" style="width: 90%;">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 75%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Result</th>
+<th class="tableblock halign-left valign-top">Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">True</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The action
connected and processed the selected messages, with 0 errors. No message to
process, for example an empty mailbox, is also true.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">False</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of errors is 1. <strong>Target directory</strong> is empty, or doesn’t
exist and <strong>Create folder</strong> is unchecked, <strong>Different folder
for attachment</strong> is checked and <strong>Attachment files folder</strong>
is empty, or doesn’t exist and <strong>Create folder</strong> is
unchecked, the server can’t be reached or refuses the login, the
<strong>Mail Server Connection</st [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
files</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged: the saved messages and attachments are not added.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
rows</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Lines
written</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of messages saved with <strong>Save message content</strong>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Files
retrieved</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of attachments saved.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Lines
deleted</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of messages deleted, by the <strong>Delete messages</strong> action,
<strong>Delete emails after retrieval</strong> or <strong>Delete
message</strong> after retrieval. A message moved on its own also counts here:
with <strong>Move message to folder</strong> after retrieval, or with the
<strong>Move messages to folder</strong> action and <strong>Retrieve the
first…​emails</strong>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Lines
updated</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of messages moved to another IMAP folder.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>When the action is false, these metrics keep the values of the previous
action.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The <code><mark>IdFile</mark></code> number in <strong>Target filename
pattern</strong> starts again in each folder: with <strong>Include
subfolders</strong>, a message of a subfolder can overwrite the file of a
message of the first folder.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<strong>Retrieve the first…​emails</strong> also applies to the
<strong>Delete messages</strong> and <strong>Move messages to folder</strong>
actions: only that number of messages is deleted or moved.
+</td>
+</tr>
+</table>
+</div>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
diff --git a/manual/next/workflow/actions/mailvalidator.html
b/manual/next/workflow/actions/mailvalidator.html
index 79732d07a6..48237246ff 100644
--- a/manual/next/workflow/actions/mailvalidator.html
+++ b/manual/next/workflow/actions/mailvalidator.html
@@ -2987,7 +2987,7 @@
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Settings</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">SMTP
check?</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">SMTP
check</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
<p>By default, Apache Hop will only check email address structure (using
regular expression).</p>
</div>
@@ -2995,17 +2995,17 @@
<p>If you want to perform a SMTP check, please select this option and fill
Email sender (see after).</p>
</div>
<div class="paragraph">
-<p>Hop will extract domain name from the supplied email address (to check) and
will try to get all exchangers from the domain name. Each exchanger will be
queried.</p>
+<p>Hop will extract domain name from the supplied email address (to check) and
will try to get all exchangers from the domain name. Each exchanger will be
queried on port 25.</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Time
out</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In order
to perform a SMTP check, Hop will open a socket on the target SMTP host.
-Specify here the socket time out (by default 0).</p></td>
+Specify here the socket time out in milliseconds (0, the default: no time
out).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Email
sender</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If you
select "SMTP check?" option, this field is mandatory.
+<td class="tableblock halign-left valign-top"><p class="tableblock">If you
select the "SMTP check" option, this field is mandatory.
Hop will need sender email address to query SMTP host.</p></td>
</tr>
<tr>
@@ -3015,6 +3015,68 @@ Hop will need sender email address to query SMTP
host.</p></td>
</tbody>
</table>
</div>
+</div>
+<div class="sect1">
+<h2 id="_result"><a class="link" href="#_result">Result</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What this action passes on to the next action. See <a
href="../action-results.html" class="xref page">Action results</a> for how
results travel through a workflow.</p>
+</div>
+<table class="tableblock frame-all grid-all" style="width: 90%;">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 75%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Result</th>
+<th class="tableblock halign-left valign-top">Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">True</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Every
address in <strong>Email address</strong> is valid, with 0 errors. With
<strong>SMTP check</strong>, a mail server also accepted <strong>Email
sender</strong> and each address.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">False</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of errors is 1. <strong>Email address</strong> is empty, an address is not a
valid email address, <strong>SMTP check</strong> is selected while
<strong>Email sender</strong> is empty, or with <strong>SMTP check</strong> the
mail server refuses <strong>Email sender</strong> or an address, the domain
doesn’t exist or has no MX record, or the server can’t be reached.
The addresses are checked one afte [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
files</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
rows</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The addresses must be separated by exactly one space: two spaces, or a comma,
make the check fail.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+<strong>SMTP check</strong> connects to port 25 of the mail servers of the
domain (its MX records), or of <strong>Default SMTP server</strong> when it is
set, and asks whether it accepts <strong>Email sender</strong> and the address.
Without <strong>Default SMTP server</strong>, an address of a domain that has
no MX record always fails, even when the domain has an A record: the check
fails with "Error getting machines : Index 1 out of bounds for length 1".
+</td>
+</tr>
+</table>
+</div>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
diff --git a/manual/next/workflow/actions/pgpdecryptfiles.html
b/manual/next/workflow/actions/pgpdecryptfiles.html
index 0b2645cf96..6ce13bf4a6 100644
--- a/manual/next/workflow/actions/pgpdecryptfiles.html
+++ b/manual/next/workflow/actions/pgpdecryptfiles.html
@@ -2986,12 +2986,12 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">The file
path of the GnuPG executable (e.g. <code>/usr/bin/gpg</code>).</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Include
subfolders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or
not to include subfolders.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Include
Subfolders</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Also
processes the files in the subfolders of a source folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy
previous results to args</p></td>
-<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Take the
files from the result rows of the previous action instead of from the list. The
fields are read by position: file/folder source, wildcard, passphrase,
file/folder destination.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">File/Folder source</p></td>
@@ -3006,6 +3006,10 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">A regex
wildcard.</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Passphrase</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The
passphrase of the private key the files are encrypted for.</p></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Files/Folders</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The files
to decrypt.</p></td>
</tr>
@@ -3013,7 +3017,7 @@
</table>
</div>
<div class="sect2">
-<h3 id="_destination_file_tab"><a class="link"
href="#_destination_file_tab">Destination File Tab</a></h3>
+<h3 id="_destination_file_tab"><a class="link"
href="#_destination_file_tab">Destination file tab</a></h3>
<table class="tableblock frame-all grid-all" style="width: 90%;">
<colgroup>
<col style="width: 25%;">
@@ -3039,7 +3043,7 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Do not
keep folder structure</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or
not to keep the folder structure. If unchecked, the folder structure is
flattened.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Writes the
files of subfolders directly in the destination folder. When unchecked, the
subfolders of the source are kept in the destination.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add date
to filename</p></td>
@@ -3063,13 +3067,16 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">If
destination file exists</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>What to do when the destination file already exists. See the WARNING under
<a href="#_result">Result</a>.</p>
+</div>
+<div class="ulist">
<ul>
<li>
-<p>Do nothing</p>
+<p>Do nothing (default)</p>
</li>
<li>
-<p>Overwrite the destination file</p>
+<p>Overwrite destination file</p>
</li>
<li>
<p>Create file with unique name</p>
@@ -3115,22 +3122,19 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">If file
exists in destination folder</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Used with <strong>Move source file to folder</strong>, when the file
already exists in <strong>Destination folder</strong>:</p>
+</div>
+<div class="ulist">
<ul>
<li>
-<p>Do nothing</p>
+<p>Do nothing (default)</p>
</li>
<li>
-<p>Overwrite the destination file</p>
+<p>Overwrite file</p>
</li>
<li>
-<p>Create file with unique name</p>
-</li>
-<li>
-<p>Delete source file</p>
-</li>
-<li>
-<p>Move source file to folder</p>
+<p>Unique name</p>
</li>
<li>
<p>Fail</p>
@@ -3142,7 +3146,7 @@
</table>
</div>
<div class="sect2">
-<h3 id="_destination_file_tab_2"><a class="link"
href="#_destination_file_tab_2">Destination File Tab</a></h3>
+<h3 id="_advanced_tab"><a class="link" href="#_advanced_tab">Advanced
tab</a></h3>
<table class="tableblock frame-all grid-all" style="width: 90%;">
<colgroup>
<col style="width: 25%;">
@@ -3166,7 +3170,7 @@
<div class="ulist">
<ul>
<li>
-<p>Success when all works (default)</p>
+<p>Success when all works fine (default)</p>
</li>
<li>
<p>Success when at least x files decrypted</p>
@@ -3178,20 +3182,129 @@
</div></div></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Nr error
lesser than</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Success if
errors lesser than.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Nr errors
lesser than</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The limit
used by the success condition: the number of errors, or the number of files for
<strong>Success when at least x files decrypted</strong> (default 10).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Result files name</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add files
to result files name</p></td>
-<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Adds the
decrypted files to the result files. See <a href="#_result">Result</a>.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="_result"><a class="link" href="#_result">Result</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What this action passes on to the next action. See <a
href="../action-results.html" class="xref page">Action results</a> for how
results travel through a workflow.</p>
+</div>
+<table class="tableblock frame-all grid-all" style="width: 90%;">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 75%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Result</th>
+<th class="tableblock halign-left valign-top">Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">True</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Depends on <strong>Success condition</strong> (Advanced tab):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Success when all works fine (default): no file failed. An empty
Files/Folders list, no file matching the wildcard, or <strong>Copy previous
results to args</strong> without previous result rows is also true.</p>
+</li>
+<li>
+<p>Success when at least x files decrypted: at least <strong>Nr errors lesser
than</strong> files were decrypted, whatever the number of errors.</p>
+</li>
+<li>
+<p>Success when number of errors lesser than: the number of errors is at most
<strong>Nr errors lesser than</strong>. When an entry of the list brings the
errors to that number and entries are left, the action stops and is false; when
the last entry does, the action is still true.</p>
+</li>
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">False</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The
success condition is not met. A file or an entry of the list fails, and counts
as an error, when its source doesn’t exist, the passphrase is wrong, the
file is not encrypted, or the destination file exists and <strong>If
destination file exists</strong> is <strong>Fail</strong>. It is also false,
before any file and whatever the success condition, when <strong>If destination
file exists</strong> is <strong>Move [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Errors</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of files and entries that failed. Inside a folder, when files are left after
the one that breaks the success condition, that failure counts as two
errors.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
files</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">With
<strong>Add files to result files name</strong>, a decrypted file that
didn’t exist yet in the destination is added unless <strong>If
destination file exists</strong> is <strong>Do nothing</strong> (the default)
or <strong>Fail</strong>: with the default, no file is added. When the
destination file already exists, a file is added only with <strong>Overwrite
destination file</strong> or <strong>Create file with [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
rows</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Lines
written</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of files decrypted. A file left in place by <strong>Do nothing</strong>,
deleted or moved is not counted. When the check of <strong>Destination
folder</strong> (Move to folder) fails, or the action stops on the success
condition between two entries of the list, the value of the previous action is
passed on.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The decrypted file keeps the name of the source file: <code>a.txt.gpg</code>
becomes <code>a.txt.gpg</code> in the destination folder.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+A <strong>GPG location</strong> that is empty or not found doesn’t make
the action false: the workflow stops with an error, and no hop from the action
is followed.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+<strong>If destination file exists</strong> doesn’t always do what its
name says. <strong>Delete source file</strong> deletes the existing destination
file, not the source, and decrypts nothing. <strong>Move source file to
folder</strong> moves the source file to <strong>Destination folder</strong>
without decrypting it.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+When the destination file exists, <strong>Create file with unique
name</strong> writes the decrypted file under a new name, with the date and
time added after the file name (for example
<code>a.txt.gpg30102026_140548429</code>), and <strong>Do nothing</strong>
keeps the existing file and doesn’t decrypt the source.
+</td>
+</tr>
+</table>
+</div>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
diff --git a/manual/next/workflow/actions/pgpencryptfiles.html
b/manual/next/workflow/actions/pgpencryptfiles.html
index 49c4703a40..ca9b31b146 100644
--- a/manual/next/workflow/actions/pgpencryptfiles.html
+++ b/manual/next/workflow/actions/pgpencryptfiles.html
@@ -2990,8 +2990,8 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or
not to use ASCII mode when encrypting.</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Include
subfolders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or
not to include subfolders.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Include
Subfolders</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Also
processes the files in the subfolders of a source folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy
previous results to args</p></td>
@@ -3055,7 +3055,7 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Do not
keep folder structure</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Whether or
not to keep the folder structure. If unchecked, the folder structure is
flattened.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Writes the
files of subfolders directly in the destination folder. When unchecked, the
subfolders of the source are kept in the destination.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add date
to filename</p></td>
@@ -3079,13 +3079,16 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">If
destination file exists</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>What to do when the destination file already exists. See the WARNING under
<a href="#_result">Result</a>.</p>
+</div>
+<div class="ulist">
<ul>
<li>
-<p>Do nothing</p>
+<p>Do nothing (default)</p>
</li>
<li>
-<p>Overwrite the destination file</p>
+<p>Overwrite destination file</p>
</li>
<li>
<p>Create file with unique name</p>
@@ -3131,22 +3134,19 @@
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">If file
exists in destination folder</p></td>
-<td class="tableblock halign-left valign-top"><div class="content"><div
class="ulist">
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Used with <strong>Move source file to folder</strong>, when the file
already exists in <strong>Destination folder</strong>:</p>
+</div>
+<div class="ulist">
<ul>
<li>
-<p>Do nothing</p>
-</li>
-<li>
-<p>Overwrite the destination file</p>
-</li>
-<li>
-<p>Create file with unique name</p>
+<p>Do nothing (default)</p>
</li>
<li>
-<p>Delete source file</p>
+<p>Overwrite file</p>
</li>
<li>
-<p>Move source file to folder</p>
+<p>Unique name</p>
</li>
<li>
<p>Fail</p>
@@ -3158,7 +3158,7 @@
</table>
</div>
<div class="sect2">
-<h3 id="_advanced_tab"><a class="link" href="#_advanced_tab">Advanced
Tab</a></h3>
+<h3 id="_advanced_tab"><a class="link" href="#_advanced_tab">Advanced
tab</a></h3>
<table class="tableblock frame-all grid-all" style="width: 90%;">
<colgroup>
<col style="width: 25%;">
@@ -3182,7 +3182,7 @@
<div class="ulist">
<ul>
<li>
-<p>Success when all works</p>
+<p>Success when all works fine (default)</p>
</li>
<li>
<p>Success when at least x files decrypted</p>
@@ -3194,20 +3194,129 @@
</div></div></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Nr error
lesser than</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Success if
errors lesser than.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Nr errors
lesser than</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The limit
used by the success condition: the number of errors, or the number of files for
<strong>Success when at least x files decrypted</strong> (default 10).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p
class="tableblock">Result files name</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add files
to result files name</p></td>
-<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Adds the
encrypted or signed files to the result files. See <a
href="#_result">Result</a>.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="_result"><a class="link" href="#_result">Result</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What this action passes on to the next action. See <a
href="../action-results.html" class="xref page">Action results</a> for how
results travel through a workflow.</p>
+</div>
+<table class="tableblock frame-all grid-all" style="width: 90%;">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 75%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Result</th>
+<th class="tableblock halign-left valign-top">Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">True</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Depends on <strong>Success condition</strong> (Advanced tab):</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Success when all works fine (default): no file failed. An empty
Files/Folders list, no file matching the wildcard, or <strong>Copy previous
results to args</strong> without previous result rows is also true.</p>
+</li>
+<li>
+<p>Success when at least x files decrypted: at least <strong>Nr errors lesser
than</strong> files were encrypted or signed, whatever the number of errors.</p>
+</li>
+<li>
+<p>Success when number of errors lesser than: the number of errors is at most
<strong>Nr errors lesser than</strong>. When an entry of the list brings the
errors to that number and entries are left, the action stops and is false; when
the last entry does, the action is still true.</p>
+</li>
+</ul>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">False</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The
success condition is not met. A file or an entry of the list fails, and counts
as an error, when its source doesn’t exist, the destination folder
doesn’t exist and <strong>Create destination folder</strong> is
unchecked, GnuPG fails (an unknown or empty <strong>User ID</strong>, a signing
key that needs a passphrase), the destination file exists and <strong>If
destination file exists</strong> is <strong>F [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Errors</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of files and entries that failed. Inside a folder, when files are left after
the one that breaks the success condition, that failure counts as two errors. A
<strong>GPG location</strong> that is empty or not found counts as 1 error,
before any file: the action is false with <strong>Success when all works
fine</strong> and <strong>Success when at least x files decrypted</strong>, and
true with <strong>Success w [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
files</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">With
<strong>Add files to result files name</strong>, an encrypted file that
didn’t exist yet in the destination is added unless <strong>If
destination file exists</strong> is <strong>Do nothing</strong> (the default)
or <strong>Fail</strong>: with the default, no file is added. When the
destination file already exists, a file is added only with <strong>Overwrite
destination file</strong> or <strong>Create file wit [...]
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
rows</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Lines
written</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of files encrypted or signed. A file left in place by <strong>Do
nothing</strong>, deleted or moved is not counted. When the check of
<strong>Destination folder</strong> (Move to folder) fails, or the action stops
on the success condition between two entries of the list, the value of the
previous action is passed on.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The encrypted or signed file keeps the name of the source file:
<code>a.txt</code> becomes <code>a.txt</code> in the destination folder, no
extension is added.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+<strong>If destination file exists</strong> doesn’t always do what its
name says. <strong>Create file with unique name</strong> builds a new name (the
date and time added after the file name, for example
<code>a.txt30102026_140920035</code>) but writes to the existing file, which is
overwritten; the new name, which doesn’t exist, is added to the result
files. <strong>Delete source file</strong> deletes the existing destination
file, not the source, and encrypts nothing. <stro [...]
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The action has no passphrase option: for <strong>Sign</strong> and
<strong>Sign and encrypt</strong>, GnuPG must be able to use the signing key
without asking for one, for example a key without passphrase or a passphrase
already held by <code>gpg-agent</code>. Otherwise the file fails.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+With <strong>Include Subfolders</strong> and <strong>Do not keep folder
structure</strong> unchecked, a file in a subfolder is written to the same
subfolder in the destination. GnuPG doesn’t create that subfolder, so the
file fails when it doesn’t exist.
+</td>
+</tr>
+</table>
+</div>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
diff --git a/manual/next/workflow/actions/pgpverify.html
b/manual/next/workflow/actions/pgpverify.html
index 78dea8d57c..9def830510 100644
--- a/manual/next/workflow/actions/pgpverify.html
+++ b/manual/next/workflow/actions/pgpverify.html
@@ -2998,6 +2998,44 @@
</tbody>
</table>
</div>
+</div>
+<div class="sect1">
+<h2 id="_result"><a class="link" href="#_result">Result</a></h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What this action passes on to the next action. See <a
href="../action-results.html" class="xref page">Action results</a> for how
results travel through a workflow.</p>
+</div>
+<table class="tableblock frame-all grid-all" style="width: 90%;">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 75%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Result</th>
+<th class="tableblock halign-left valign-top">Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">True</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">GnuPG
verified the signature, with 0 errors: a signed or clear-signed
<strong>Filename</strong>, or with <strong>Use detached signature</strong> the
<strong>Detached signature</strong> of <strong>Filename</strong>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">False</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The number
of errors is 1. <strong>Filename</strong> is empty or doesn’t exist, the
file is not signed, the signature doesn’t match the file (for example a
file changed after it was signed), the signing key is not in the keyring,
<strong>Use detached signature</strong> is checked while <strong>Detached
signature</strong> is empty, or <strong>GPG location</strong> is empty or not
found.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
files</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Result
rows</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Passed on
unchanged.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
</div>
</article>
<nav class="pagination" data-pagefind-ignore aria-label="Page">
