[Privoxy-commits] [privoxy] 25/26: Regenerate user manual
User Git
git at git.privoxy.org
Sat Oct 10 09:01:51 CEST 2026
This is an automated email from the git hooks/post-receive script.
git pushed a commit to branch master
in repository privoxy.
commit 1672f79e6fc22a52c50acd13b55899581646bd07
Author: Fabian Keil <fk at fabiankeil.de>
AuthorDate: Sat Oct 10 07:57:27 2026 +0200
Regenerate user manual
---
doc/webserver/user-manual/appendix.html | 16 ++++-----
doc/webserver/user-manual/config.html | 58 ++++++++++++++++++++++++++++++
doc/webserver/user-manual/filter-file.html | 15 +++++++-
doc/webserver/user-manual/index.html | 1 +
4 files changed, 81 insertions(+), 9 deletions(-)
diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index a6768127..f21d908c 100644
--- a/doc/webserver/user-manual/appendix.html
+++ b/doc/webserver/user-manual/appendix.html
@@ -202,7 +202,7 @@
these. If not, you will get a friendly error message. Internet access is not necessary either.</p>
<ul>
<li>
- <p>Privoxy main page:</p><a name="AEN6652" id="AEN6652"></a>
+ <p>Privoxy main page:</p><a name="AEN6691" id="AEN6691"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target="_top">http://config.privoxy.org/</a></p>
</blockquote>
@@ -211,7 +211,7 @@
"APPLICATION">Privoxy</span>)</p>
</li>
<li>
- <p>View and toggle client tags:</p><a name="AEN6660" id="AEN6660"></a>
+ <p>View and toggle client tags:</p><a name="AEN6699" id="AEN6699"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/client-tags" target=
"_top">http://config.privoxy.org/client-tags</a></p>
@@ -219,21 +219,21 @@
</li>
<li>
<p>Show information about the current configuration, including viewing and editing of actions
- files:</p><a name="AEN6665" id="AEN6665"></a>
+ files:</p><a name="AEN6704" id="AEN6704"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-status" target=
"_top">http://config.privoxy.org/show-status</a></p>
</blockquote>
</li>
<li>
- <p>Show the browser's request headers:</p><a name="AEN6670" id="AEN6670"></a>
+ <p>Show the browser's request headers:</p><a name="AEN6709" id="AEN6709"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-request" target=
"_top">http://config.privoxy.org/show-request</a></p>
</blockquote>
</li>
<li>
- <p>Show which actions apply to a URL and why:</p><a name="AEN6675" id="AEN6675"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN6714" id="AEN6714"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-url-info" target=
"_top">http://config.privoxy.org/show-url-info</a></p>
@@ -242,15 +242,15 @@
<li>
<p>Toggle Privoxy on or off. This feature can be turned off/on in the main <tt class="FILENAME">config</tt>
file. When toggled <span class="QUOTE">"off"</span>, <span class="QUOTE">"Privoxy"</span> continues to run,
- but only as a pass-through proxy, with no actions taking place:</p><a name="AEN6683" id="AEN6683"></a>
+ but only as a pass-through proxy, with no actions taking place:</p><a name="AEN6722" id="AEN6722"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle" target="_top">http://config.privoxy.org/toggle</a></p>
</blockquote>
- <p>Short cuts. Turn off, then on:</p><a name="AEN6687" id="AEN6687"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN6726" id="AEN6726"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=disable" target=
"_top">http://config.privoxy.org/toggle?set=disable</a></p>
- </blockquote><a name="AEN6690" id="AEN6690"></a>
+ </blockquote><a name="AEN6729" id="AEN6729"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=enable" target=
"_top">http://config.privoxy.org/toggle?set=enable</a></p>
diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html
index 5f142e8b..1ecd8a1e 100644
--- a/doc/webserver/user-manual/config.html
+++ b/doc/webserver/user-manual/config.html
@@ -2392,6 +2392,64 @@
</dl>
</div>
</div>
+ <div class="SECT3">
+ <h4 class="SECT3"><a name="CONNECT-ATTEMPT-DELAY" id="CONNECT-ATTEMPT-DELAY">7.6.20.
+ connect-attempt-delay</a></h4>
+ <div class="VARIABLELIST">
+ <dl>
+ <dt>Specifies:</dt>
+ <dd>
+ <p>Number of milliseconds to wait before starting a connection attempt to the next address of a host
+ while previous attempts are still pending.</p>
+ </dd>
+ <dt>Type of value:</dt>
+ <dd>
+ <p><tt class="REPLACEABLE"><i>Time in milliseconds.</i></tt></p>
+ </dd>
+ <dt>Default value:</dt>
+ <dd>
+ <p>250</p>
+ </dd>
+ <dt>Effect if unset:</dt>
+ <dd>
+ <p>A default value of 250 milliseconds is used.</p>
+ </dd>
+ <dt>Notes:</dt>
+ <dd>
+ <p>If a host resolves to multiple addresses, <span class="APPLICATION">Privoxy</span> tries to connect to
+ them following the <span class="QUOTE">"Happy Eyeballs"</span> algorithm described in RFC 8305: the
+ addresses are sorted so that address families alternate, the first connection attempt is started right
+ away and additional attempts are started in parallel whenever a previous attempt fails or the <tt class=
+ "LITERAL">connect-attempt-delay</tt> expires. The first attempt to succeed wins, the other ones are
+ aborted.</p>
+ <p>This limits the delay caused by unreachable addresses, for example when a host has an IPv6 address but
+ the system only has working IPv4 connectivity, to the configured value instead of the connection
+ timeout.</p>
+ <p>RFC 8305 recommends a value between 100 and 2000 milliseconds. Setting the value to 0 disables
+ parallel connection attempts, so that the addresses are tried one after the other with the next attempt
+ only being started after the previous one failed.</p>
+ <p>Note that the addresses are resolved with a single synchronous lookup, the <span class=
+ "QUOTE">"Resolution Delay"</span> described in RFC 8305 doesn't apply. The first attempt is made to the
+ first address returned by the resolver, whichever family it belongs to, followed by an address of the
+ other family.</p>
+ <p>This directive has no effect if <span class="APPLICATION">Privoxy</span> has been compiled without
+ getaddrinfo() support. On platforms where the connection attempts can't be made non-blocking the
+ addresses are tried one after the other regardless of this setting.</p>
+ </dd>
+ <dt>Example:</dt>
+ <dd>
+ <table border="0" bgcolor="#E0E0E0" width="90%">
+ <tr>
+ <td>
+ <pre class="SCREEN"> # Give the first address a full second before trying the next one
+ connect-attempt-delay 1000</pre>
+ </td>
+ </tr>
+ </table>
+ </dd>
+ </dl>
+ </div>
+ </div>
</div>
<div class="SECT2">
<h2 class="SECT2"><a name="HTTPS-INSPECTION-DIRECTIVES" id="HTTPS-INSPECTION-DIRECTIVES">7.7. HTTPS
diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html
index 6eec684a..7e22be48 100644
--- a/doc/webserver/user-manual/filter-file.html
+++ b/doc/webserver/user-manual/filter-file.html
@@ -94,8 +94,21 @@
executed.</p>
<p>Note that '$' is a bad choice for a delimiter in a dynamic filter as you might end up with unintended variables
if you use a variable name directly after the delimiter. Variables will be resolved without escaping anything,
- therefore you also have to be careful not to chose delimiters that appear in the replacement text. For example
+ therefore you also have to be careful not to choose delimiters that appear in the replacement text. For example
'<' should be save, while '?' will sooner or later cause conflicts with $url.</p>
+ <div class="WARNING">
+ <table class="WARNING" border="1" width="100%">
+ <tr>
+ <td align="center"><b>Warning</b></td>
+ </tr>
+ <tr>
+ <td align="left">
+ <p>Using variables in the pattern part is not recommended, as special characters are not escaped and may
+ cause problems.</p>
+ </td>
+ </tr>
+ </table>
+ </div>
<p>The non-standard option letter <tt class="LITERAL">T</tt> (trivial) prevents parsing for backreferences in the
substitute. Use it if you want to include text like '$&' in your substitute without quoting.</p>
<p>If you are new to <a href="https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class=
diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html
index 1a6648d9..6a414ddb 100644
--- a/doc/webserver/user-manual/index.html
+++ b/doc/webserver/user-manual/index.html
@@ -191,6 +191,7 @@
<dt>7.6.17. <a href="config.html#CLIENT-TAG-LIFETIME">client-tag-lifetime</a></dt>
<dt>7.6.18. <a href="config.html#TRUST-X-FORWARDED-FOR">trust-x-forwarded-for</a></dt>
<dt>7.6.19. <a href="config.html#RECEIVE-BUFFER-SIZE">receive-buffer-size</a></dt>
+ <dt>7.6.20. <a href="config.html#CONNECT-ATTEMPT-DELAY">connect-attempt-delay</a></dt>
</dl>
</dd>
<dt>7.7. <a href="config.html#HTTPS-INSPECTION-DIRECTIVES">HTTPS Inspection</a></dt>
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
More information about the Privoxy-commits
mailing list