[Privoxy-commits] [privoxy] 17/18: Regenerate user-manual
User Git
git at git.privoxy.org
Tue Mar 31 09:21:10 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 180d011b0ef137ac558b0ffd6f5cc922c208c1d9
Author: Fabian Keil <fk at fabiankeil.de>
AuthorDate: Tue Mar 31 09:18:27 2026 +0200
Regenerate user-manual
---
doc/webserver/user-manual/actions-file.html | 99 +++++++++++++++++------------
doc/webserver/user-manual/appendix.html | 16 ++---
doc/webserver/user-manual/config.html | 14 ++--
3 files changed, 76 insertions(+), 53 deletions(-)
diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html
index ec050214..24093eed 100644
--- a/doc/webserver/user-manual/actions-file.html
+++ b/doc/webserver/user-manual/actions-file.html
@@ -1718,7 +1718,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse.</pre>
+ "SCREEN"> +filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse.</pre>
</td>
</tr>
</table>
@@ -1727,7 +1727,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{js-events} # Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites).</pre>
+ "SCREEN"> +filter{js-events} # Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites).</pre>
</td>
</tr>
</table>
@@ -1736,7 +1736,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{html-annoyances} # Get rid of particularly annoying HTML abuse.</pre>
+ "SCREEN"> +filter{html-annoyances} # Get rid of particularly annoying HTML abuse.</pre>
</td>
</tr>
</table>
@@ -1745,7 +1745,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{content-cookies} # Kill cookies that come in the HTML or JS content.</pre>
+ "SCREEN"> +filter{content-cookies} # Kill cookies that come in the HTML or JS content.</pre>
</td>
</tr>
</table>
@@ -1754,7 +1754,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{refresh-tags} # Kill automatic refresh tags if refresh time is larger than 9 seconds.</pre>
+ "SCREEN"> +filter{refresh-tags} # Kill automatic refresh tags if refresh time is larger than 9 seconds.</pre>
</td>
</tr>
</table>
@@ -1762,7 +1762,8 @@
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{unsolicited-popups} # Disable only unsolicited pop-up windows.</pre>
+ <pre class=
+ "SCREEN"> +filter{unsolicited-popups} # Disable only unsolicited pop-up windows.</pre>
</td>
</tr>
</table>
@@ -1770,7 +1771,8 @@
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{all-popups} # Kill all popups in JavaScript and HTML.</pre>
+ <pre class=
+ "SCREEN"> +filter{all-popups} # Kill all popups in JavaScript and HTML.</pre>
</td>
</tr>
</table>
@@ -1779,7 +1781,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective.</pre>
+ "SCREEN"> +filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective.</pre>
</td>
</tr>
</table>
@@ -1787,7 +1789,7 @@
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{banners-by-size} # Kill banners by size.</pre>
+ <pre class="SCREEN"> +filter{banners-by-size} # Kill banners by size.</pre>
</td>
</tr>
</table>
@@ -1796,7 +1798,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{banners-by-link} # Kill banners by their links to known clicktrackers.</pre>
+ "SCREEN"> +filter{banners-by-link} # Kill banners by their links to known clicktrackers.</pre>
</td>
</tr>
</table>
@@ -1805,7 +1807,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking).</pre>
+ "SCREEN"> +filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking).</pre>
</td>
</tr>
</table>
@@ -1814,7 +1816,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap.</pre>
+ "SCREEN"> +filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap.</pre>
</td>
</tr>
</table>
@@ -1823,7 +1825,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{jumping-windows} # Prevent windows from resizing and moving themselves.</pre>
+ "SCREEN"> +filter{jumping-windows} # Prevent windows from resizing and moving themselves.</pre>
</td>
</tr>
</table>
@@ -1832,7 +1834,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{frameset-borders} # Give frames a border and make them resizable.</pre>
+ "SCREEN"> +filter{frameset-borders} # Give frames a border and make them resizable.</pre>
</td>
</tr>
</table>
@@ -1841,7 +1843,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{iframes} # Removes all detected iframes. Should only be enabled for individual sites.</pre>
+ "SCREEN"> +filter{iframes} # Removes all detected iframes. Should only be enabled for individual sites.</pre>
</td>
</tr>
</table>
@@ -1850,7 +1852,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{demoronizer} # Fix MS's non-standard use of standard charsets.</pre>
+ "SCREEN"> +filter{demoronizer} # Fix MS's non-standard use of standard charsets.</pre>
</td>
</tr>
</table>
@@ -1858,7 +1860,7 @@
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{shockwave-flash} # Kill embedded Shockwave Flash objects.</pre>
+ <pre class="SCREEN"> +filter{shockwave-flash} # Kill embedded Shockwave Flash objects.</pre>
</td>
</tr>
</table>
@@ -1866,7 +1868,7 @@
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{quicktime-kioskmode} # Make Quicktime movies saveable.</pre>
+ <pre class="SCREEN"> +filter{quicktime-kioskmode} # Make Quicktime movies saveable.</pre>
</td>
</tr>
</table>
@@ -1875,7 +1877,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{fun} # Text replacements for subversive browsing fun!</pre>
+ "SCREEN"> +filter{fun} # Text replacements for subversive browsing fun!</pre>
</td>
</tr>
</table>
@@ -1884,7 +1886,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{crude-parental} # Crude parental filtering. Note that this filter doesn't work reliably.</pre>
+ "SCREEN"> +filter{crude-parental} # Crude parental filtering. Note that this filter doesn't work reliably.</pre>
</td>
</tr>
</table>
@@ -1893,7 +1895,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{site-specifics} # Cure for site-specific problems. Don't apply generally!</pre>
+ "SCREEN"> +filter{site-specifics} # Cure for site-specific problems. Don't apply generally!</pre>
</td>
</tr>
</table>
@@ -1902,16 +1904,16 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{no-ping} # Removes non-standard ping attributes in <a> and <area> tags.</pre>
+ "SCREEN"> +filter{no-ping} # Removes non-standard ping attributes in <a> and <area> tags.</pre>
</td>
</tr>
</table>
- <p><a name="FILTER-BUNDESWEHR.DE" id="FILTER-BUNDESWEHR.DE"></a></p>
+ <p><a name="FILTER-ALLOW-AUTOCOMPLETION" id="FILTER-ALLOW-AUTOCOMPLETION"></a></p>
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
<pre class=
- "SCREEN"> +filter{bundeswehr.de} # Hide the cookie and privacy info banner on bundeswehr.de.</pre>
+ "SCREEN"> +filter{allow-autocompletion} # Changes autocomplete="off" on form and input fields to "on" to allow autocompletion.</pre>
</td>
</tr>
</table>
@@ -1920,24 +1922,24 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{github} # Removes the annoying "Sign-Up" banner and the Cookie disclaimer.</pre>
+ "SCREEN"> +filter{github} # Removes the annoying "Sign-Up" banner and the Cookie disclaimer.</pre>
</td>
</tr>
</table>
- <p><a name="FILTER-GOOGLE" id="FILTER-GOOGLE"></a></p>
+ <p><a name="FILTER-IMDB" id="FILTER-IMDB"></a></p>
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class=
- "SCREEN"> +filter{google} # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.</pre>
+ <pre class="SCREEN"> +filter{imdb} # Removes some ads on IMDb.</pre>
</td>
</tr>
</table>
- <p><a name="FILTER-IMDB" id="FILTER-IMDB"></a></p>
+ <p><a name="FILTER-GOOGLE" id="FILTER-GOOGLE"></a></p>
<table border="0" bgcolor="#E0E0E0" width="90%">
<tr>
<td>
- <pre class="SCREEN"> +filter{imdb} # Removes some ads on IMDb.</pre>
+ <pre class=
+ "SCREEN"> +filter{google} # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.</pre>
</td>
</tr>
</table>
@@ -1946,7 +1948,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{yahoo} # CSS-based block for Yahoo text ads. Also removes a width limitation.</pre>
+ "SCREEN"> +filter{yahoo} # CSS-based block for Yahoo text ads. Also removes a width limitation.</pre>
</td>
</tr>
</table>
@@ -1955,7 +1957,7 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{msn} # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.</pre>
+ "SCREEN"> +filter{msn} # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.</pre>
</td>
</tr>
</table>
@@ -1964,7 +1966,16 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{blogspot} # Cleans up some Blogspot blogs. Read the fine print before using this.</pre>
+ "SCREEN"> +filter{blogspot} # Cleans up some Blogspot blogs. Read the fine print before using this.</pre>
+ </td>
+ </tr>
+ </table>
+ <p><a name="FILTER-BUNDESWEHR.DE" id="FILTER-BUNDESWEHR.DE"></a></p>
+ <table border="0" bgcolor="#E0E0E0" width="90%">
+ <tr>
+ <td>
+ <pre class=
+ "SCREEN"> +filter{bundeswehr.de} # Hide the cookie and privacy info banner on bundeswehr.de</pre>
</td>
</tr>
</table>
@@ -1973,7 +1984,16 @@
<tr>
<td>
<pre class=
- "SCREEN"> +filter{sourceforge} # Reduces the amount of ads for proprietary software on SourceForge.</pre>
+ "SCREEN"> +filter{sourceforge} # Reduces the amount of ads for proprietary software on SourceForge.</pre>
+ </td>
+ </tr>
+ </table>
+ <p><a name="FILTER-TAZ.DE" id="FILTER-TAZ.DE"></a></p>
+ <table border="0" bgcolor="#E0E0E0" width="90%">
+ <tr>
+ <td>
+ <pre class=
+ "SCREEN"> +filter{taz.de} # Hides the 'paywahl' banner on taz.de by default without relying on cookies.</pre>
</td>
</tr>
</table>
@@ -2719,8 +2739,7 @@
<dl>
<dt>Typical use:</dt>
<dd>
- <p>Prevent abuse of <span class="APPLICATION">Privoxy</span> as a TCP proxy relay or disable SSL for
- untrusted sites</p>
+ <p>Prevent abuse of <span class="APPLICATION">Privoxy</span> as a TCP proxy relay</p>
</dd>
<dt>Effect:</dt>
<dd>
@@ -2744,9 +2763,11 @@
"QUOTE">"https://"</span> URLs) through proxies. It works very simply: the proxy connects to the server
on the specified port, and then short-circuits its connections to the client and to the remote server.
This means CONNECT-enabled proxies can be used as TCP relays very easily.</p>
- <p><span class="APPLICATION">Privoxy</span> relays HTTPS traffic without seeing the decoded content.
- Websites can leverage this limitation to circumvent <span class="APPLICATION">Privoxy</span>'s filters.
- By specifying an invalid port range you can disable HTTPS entirely.</p>
+ <p>If the CONNECT method is being used and the <a href=
+ "actions-file.html#HTTPS-INSPECTION">https-inspection</a> action is not enabled, <span class=
+ "APPLICATION">Privoxy</span> relays HTTPS or other traffic without seeing the decoded content. Websites
+ can leverage this limitation to circumvent <span class="APPLICATION">Privoxy</span>'s filters. By
+ specifying an invalid port range you can disallow the CONNECT method and prevent this.</p>
</dd>
<dt>Example usages:</dt>
<dd>
diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index 03c2e133..9ee95501 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="AEN6633" id="AEN6633"></a>
+ <p>Privoxy main page:</p><a name="AEN6642" id="AEN6642"></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="AEN6641" id="AEN6641"></a>
+ <p>View and toggle client tags:</p><a name="AEN6650" id="AEN6650"></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="AEN6646" id="AEN6646"></a>
+ files:</p><a name="AEN6655" id="AEN6655"></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="AEN6651" id="AEN6651"></a>
+ <p>Show the browser's request headers:</p><a name="AEN6660" id="AEN6660"></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="AEN6656" id="AEN6656"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN6665" id="AEN6665"></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="AEN6664" id="AEN6664"></a>
+ but only as a pass-through proxy, with no actions taking place:</p><a name="AEN6673" id="AEN6673"></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="AEN6668" id="AEN6668"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN6677" id="AEN6677"></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="AEN6671" id="AEN6671"></a>
+ </blockquote><a name="AEN6680" id="AEN6680"></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 8c38e13c..1a6116ce 100644
--- a/doc/webserver/user-manual/config.html
+++ b/doc/webserver/user-manual/config.html
@@ -2232,8 +2232,10 @@
as a result the last matching pattern wins. Tags that are created based on client or server headers are
evaluated later on and can overrule CLIENT-TAG and URL patterns!</p>
<p>The tag is set for all requests that come from clients that requested it to be set. Note that
- "clients" are differentiated by IP address, if the IP address changes the tag has to be requested
- again.</p>
+ "clients" are differentiated by IP address, if the IP address changes the tag has to be requested again.
+ The <tt class="LITERAL">listen-address</tt> used to reach <span class="APPLICATION">Privoxy</span> is
+ taken into account as well. This allows multiple clients running on the same system to request different
+ settings.</p>
<p>Clients can request tags to be set by using the CGI interface <a href=
"http://config.privoxy.org/client-tags" target="_top">http://config.privoxy.org/client-tags</a>. The
specific tag description is only used on the web page and should be phrased in away that the user
@@ -2574,9 +2576,9 @@
</dd>
<dt>Notes:</dt>
<dd>
- <p>This directive specifies the directory where generated TLS/SSL keys and certificates are saved when
- https inspection is enabled with the <tt class="LITERAL"><a href="actions-file.html#HTTPS-INSPECTION"
- target="_top">https-inspection</a></tt> action.</p>
+ <p>This directive specifies the directory where generated keys and certificates are saved when https
+ inspection is enabled with the <tt class="LITERAL"><a href="actions-file.html#HTTPS-INSPECTION" target=
+ "_top">https-inspection</a></tt> action.</p>
<p>The keys and certificates currently have to be deleted manually when changing the <a href=
"#CA-CERT-FILE" target="_top">ca-cert-file</a> and the <a href="#CA-CERT-KEY" target=
"_top">ca-cert-key</a>.</p>
@@ -2784,7 +2786,7 @@
<dt>Notes:</dt>
<dd>
<p>This directive specifies the trusted CAs file that is used when validating certificates for
- intercepted TLS/SSL requests.</p>
+ intercepted HTTPS requests.</p>
<p>An example file can be downloaded from <a href="https://curl.se/ca/cacert.pem" target=
"_top">https://curl.se/ca/cacert.pem</a>. If you want to create the file yourself, please see: <a href=
"https://curl.se/docs/caextract.html" target="_top">https://curl.se/docs/caextract.html</a>.</p>
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
More information about the Privoxy-commits
mailing list