<div class="SECT1">
<h1 class="SECT1"><a name="DOCUMENTATION" id="DOCUMENTATION">3. Documentation Guidelines</a></h1>
<p>All formal documents are maintained in Docbook SGML and located in the <samp class=
- "COMPUTEROUTPUT">doc/source/*</samp> directory. You will need <a href="http://www.docbook.org" target=
+ "COMPUTEROUTPUT">doc/source/*</samp> directory. You will need <a href="https://www.docbook.org/" target=
"_top">Docbook</a>, the Docbook DTD's and the Docbook modular stylesheets (or comparable alternatives), and either
<span class="APPLICATION">jade</span> or <span class="APPLICATION">openjade</span> (recommended) installed in order
to build docs from source. Currently there is <a href="../user-manual/index.html" target="_top"><i class=
<p><tt class="FILENAME">config</tt> requires some special handling. The reason it is maintained this way is so that
the extensive comments in the file mirror those in <i class="CITETITLE">user-manual</i>. But the conversion process
requires going from SGML to HTML to text to special formatting required for the embedded comments. Some of this
- does not survive so well. Especially some of the examples that are longer than 80 characters. The build process for
- this file outputs to <tt class="FILENAME">config.new</tt>, which should be reviewed for errors and mis-formatting.
- Once satisfied that it is correct, then it should be hand copied to <tt class="FILENAME">config</tt>.</p>
+ does not survive so well. Especially some of the examples that are longer than 80 characters.</p>
<p>Other, less formal documents (e.g. <tt class="FILENAME">LICENSE</tt>) are maintained as plain text files in the
top-level source directory.</p>
<p>Packagers are encouraged to include this documentation. For those without the ability to build the docs locally,
</li>
<li>
<p>Run <samp class="COMPUTEROUTPUT">make webserver</samp> which copies all files from <samp class=
- "COMPUTEROUTPUT">doc/webserver</samp> to the sourceforge webserver via scp.</p>
+ "COMPUTEROUTPUT">doc/webserver</samp> to the sourceforge webserver via ssh.</p>
</li>
</ol>
<p>Finished docs should be occasionally submitted to Git (<tt class="FILENAME">doc/webserver/*/*.html</tt>) so that
</ul>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN206" id="AEN206">3.3. Privoxy Custom Entities</a></h2>
+ <h2 class="SECT2"><a name="AEN205" id="AEN205">3.3. Privoxy Custom Entities</a></h2>
<p><span class="APPLICATION">Privoxy</span> documentation is using a number of customized <span class=
"QUOTE">"entities"</span> to facilitate documentation maintenance.</p>
<p>We are using a set of <span class="QUOTE">"boilerplate"</span> files with generic text, that is used by
<dt>3.1. <a href="documentation.html#SGML">Quickstart to Docbook and SGML</a></dt>
<dt>3.2. <a href="documentation.html#DOCSTYLE"><span class="APPLICATION">Privoxy</span> Documentation
Style</a></dt>
- <dt>3.3. <a href="documentation.html#AEN206">Privoxy Custom Entities</a></dt>
+ <dt>3.3. <a href="documentation.html#AEN205">Privoxy Custom Entities</a></dt>
</dl>
</dd>
<dt>4. <a href="coding.html">Coding Guidelines</a></dt>
<div class="SECT2">
<h2 class="SECT2"><a name="QUICKSTART" id="QUICKSTART">1.1. Quickstart to Privoxy Development</a></h2>
<p>The first step is to join the <a href="https://lists.privoxy.org/mailman/listinfo/privoxy-devel" target=
- "_top">privoxy-devel mailing list</a>. You can submit your ideas or, even better, patches. Patches are best
- submitted to the Sourceforge tracker set up for this purpose, but can be sent to the list for review too.</p>
+ "_top">privoxy-devel mailing list</a>. You can submit your ideas or, even better, patches. Patches can also be
+ submitted to the <a href="https://sourceforge.net/p/ijbswa/patches/" target="_top">Sourceforge patch
+ tracker</a>.</p>
<p>You will also need to have a git package installed, in order to access the git repository. Having the GNU
build tools is also going to be important (particularly, autoconf and gmake).</p>
<p>For the time being (read, this section is under construction), you can also refer to the extensive comments in
important that great care is taken to ensure that everything runs fine, and not to introduce problems in the very
last minute.</p>
<p>So when releasing a new version, please adhere exactly to the procedure outlined in this chapter.</p>
- <p>The following programs are required to follow this process: <tt class="FILENAME">ncftpput</tt> (ncftp),
- <tt class="FILENAME">scp, ssh</tt> (ssh), <tt class="FILENAME">gmake</tt> (GNU's version of make), autoconf,
- cvs.</p>
+ <p>The following programs are required to follow this process: <tt class="FILENAME">ssh</tt>, <tt class=
+ "FILENAME">gmake</tt> (GNU's version of make), autoconf, git, a web browser.</p>
<div class="SECT2">
<h2 class="SECT2"><a name="VERSIONNUMBERS" id="VERSIONNUMBERS">6.1. Version numbers</a></h2>
<p>First you need to determine which version number the release will have. <span class=
<li>
<p>X, the version major, is rarely ever changed. It is increased by one if turning a development branch into
stable substantially changes the functionality, user interface or configuration syntax. Majors 1 and 2 were
- <span class="APPLICATION">Junkbuster</span>, and 3 will be the first stable <span class=
+ <span class="APPLICATION">Junkbuster</span>, and 3 is the first stable <span class=
"APPLICATION">Privoxy</span> release.</p>
</li>
<li>
is version sensitive, so that the user will get appropriate help for his/her release. So with each release a
fresh version should be uploaded to the webserver (this is in addition to the main <i class="CITETITLE">User
Manual</i> link from the main page since we need to keep manuals for various versions available). The CGI
- pages will link to something like <tt class="LITERAL">http://privoxy.org/$(VERSION)/user-manual/</tt>. This
- will need to be updated for each new release. There is no Makefile target for this at this time!!! It needs
- to be done manually.</p>
+ pages will link to something like <tt class="LITERAL">https://www.privoxy.org/$(VERSION)/user-manual/</tt>.
+ This will need to be updated for each new release. There is no Makefile target for this at this time!!! It
+ needs to be done manually.</p>
</li>
<li>
<p>Tag all files in Git with the version number with <span class="QUOTE">"<b class="COMMAND">git tag
<h3 class="SECT3"><a name="NEWRELEASE-MACOSX" id="NEWRELEASE-MACOSX">6.3.7. Mac OS X</a></h3>
<p>First, <span class="emphasis"><i class="EMPHASIS">make sure that you have freshly exported the right version
into an empty directory</i></span>. (See "Building and releasing packages" above).</p>
- <p>There are three modules available in the Git repository for use on Mac OS X, though technically only two of
- them generate a release (the other can be used to install from source).</p>
+ <p>There are three modules available in the CVS repository backups for use on Mac OS X, though technically only
+ two of them generate a release (the other can be used to install from source).</p>
<div class="SECT4">
<h4 class="SECT4"><a name="OS-X-OSXPACKAGEBUILDER-MODULE" id="OS-X-OSXPACKAGEBUILDER-MODULE">6.3.7.1.
- OSXPackageBuilder module</a></h4>
+ OSXPackageBuilder module (Documentation out of date)</a></h4>
<p>The OSXPackageBuilder module generates OS X installer packages supporting all Macs running OS X 10.4 and
- above. Obtain it from Git as follows into a folder parallel to the exported privoxy source:</p>
+ above. Obtain it from CVS as follows into a folder parallel to the exported privoxy source:</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
</div>
<div class="SECT4">
<h4 class="SECT4"><a name="OS-X-OSXSETUP-MODULE" id="OS-X-OSXSETUP-MODULE">6.3.7.2. osxsetup module
- (DEPRECATED)</a></h4>
+ (DEPRECATED) (Documentation out of date)</a></h4>
<p><span class="emphasis"><i class="EMPHASIS">This module is deprecated since the installer it generates
places all Privoxy files in one folder in a non-standard location, and supports only Intel Macs running OS X
10.6 or higher.</i></span></p>
- <p>Check out the module from Git as follows into a folder parallel to the exported privoxy source:</p>
+ <p>Check out the module from CVS as follows into a folder parallel to the exported privoxy source:</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
package supports.</p>
</div>
<div class="SECT4">
- <h4 class="SECT4"><a name="OS-X-MACSETUP-MODULE" id="OS-X-MACSETUP-MODULE">6.3.7.3. macsetup module</a></h4>
+ <h4 class="SECT4"><a name="OS-X-MACSETUP-MODULE" id="OS-X-MACSETUP-MODULE">6.3.7.3. macsetup module
+ (Documentation out of date)</a></h4>
<p>The macsetup module is ideal if you wish to build and install Privoxy from source on a single machine.</p>
- <p>Check out the module from Git as follows into a folder parallel to the exported privoxy source:</p>
+ <p>Check out the module from CVS as follows into a folder parallel to the exported privoxy source:</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
</td>
</tr>
</table>
- <p>This will do the upload to <a href="https://www.privoxy.org/" target="_top">the webserver</a> (www.privoxy.org)
- and ensure all files and directories there are group writable.</p>
+ <p>This will do the upload to the SourceForge webserver (which is manually syncronized with <a href=
+ "https://www.privoxy.org/" target="_top">www.privoxy.org</a>) and ensure all files and directories there are group
+ writable.</p>
<p>Please do <span class="emphasis"><i class="EMPHASIS">NOT</i></span> use any other means of transferring files to
the webserver to avoid permission problems. Also, please do not upload docs from development branches or versions.
The publicly posted docs should be in sync with the last official release.</p>
pattern</a> basis, i.e. for single URLs, whole web sites, groups or parts thereof etc. Actions can also be
grouped together and then applied to requests matching one or more patterns. There are many possible actions that
might apply to any given site. As an example, if you are blocking <a href=
- "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a> as one of your default actions, but need
+ "https://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a> as one of your default actions, but need
to accept cookies from a given site, you would need to define an exception for this site in one of your actions
files, preferably in <tt class="FILENAME">user.action</tt>.</p>
</div>
<div class="SECT2">
<h3 class="SECT2"><a name="YAHOO" id="YAHOO">3.8. How can I make my Yahoo/Hotmail/Gmail account work?</a></h3>
<p>The default configuration shouldn't impact the usability of any of these services. It may, however, make all
- <a href="http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a> temporary, so that your browser
+ <a href="https://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a> temporary, so that your browser
will forget your login credentials in between browser sessions. If you would like not to have to log in manually
each time you access those websites, simply turn off all cookie handling for them in the <tt class=
"FILENAME">user.action</tt> file. An example for yahoo might look like:</p>
</td>
</tr>
</table>
- <p>These kinds of sites are often quite complex and heavy with <a href="http://en.wikipedia.org/wiki/Javascript"
+ <p>These kinds of sites are often quite complex and heavy with <a href="https://en.wikipedia.org/wiki/Javascript"
target="_top">Javascript</a> and thus <span class="QUOTE">"fragile"</span>. So if <span class=
"emphasis"><i class="EMPHASIS">still</i></span> a problem, we have an <a href=
"../user-manual/actions-file.html#ALIASES" target="_top">alias</a> just for such sticky situations:</p>
<h3 class="SECT2"><a name="TRANSPARENT" id="TRANSPARENT">3.19. Can Privoxy run as a <span class=
"QUOTE">"transparent"</span> proxy?</a></h3>
<p>The whole idea of Privoxy is to modify client requests and server responses in all sorts of ways and therefore
- it's not a transparent proxy as described in <a href="http://tools.ietf.org/html/rfc2616" target="_top">RFC
+ it's not a transparent proxy as described in <a href="https://tools.ietf.org/html/rfc2616" target="_top">RFC
2616</a>.</p>
<p>However, some people say <span class="QUOTE">"transparent proxy"</span> when they mean <span class=
"QUOTE">"intercepting proxy"</span>. If you are one of them, please read the <a href=
<div class="SECT2">
<h3 class="SECT2"><a name="SNEAKY-COOKIES" id="SNEAKY-COOKIES">3.23. I sometimes notice cookies sneaking through.
How?</a></h3>
- <p><a href="http://en.wikipedia.org/wiki/Browser_cookie" target="_top">Cookies</a> can be set in several ways.
+ <p><a href="https://en.wikipedia.org/wiki/Browser_cookie" target="_top">Cookies</a> can be set in several ways.
The classic method is via the <tt class="LITERAL">Set-Cookie</tt> HTTP header. This is straightforward, and an
easy one to manipulate, such as the <span class="APPLICATION">Privoxy</span> concept of <a href=
"../user-manual/actions-file.html#SESSION-COOKIES-ONLY" target="_top">session-cookies-only</a>. There is also the
- possibility of using <a href="http://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a> to set
+ possibility of using <a href="https://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a> to set
cookies (<span class="APPLICATION">Privoxy</span> calls these <tt class="LITERAL">content-cookies</tt>). This is
trickier because the syntax can vary widely, and thus requires a certain amount of guesswork. It is not realistic
to catch all of these short of disabling Javascript, which would break many sites. And lastly, if the cookies are
</div>
<div class="SECT2">
<h3 class="SECT2"><a name="EVIL-COOKIES" id="EVIL-COOKIES">3.24. Are all cookies bad? Why?</a></h3>
- <p>No, in fact there are many beneficial uses of <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
+ <p>No, in fact there are many beneficial uses of <a href="https://en.wikipedia.org/wiki/Browser_cookie" target=
"_top">cookies</a>. Cookies are just a method that browsers can use to store data between pages, or between
browser sessions. Sometimes there is a good reason for this, and the user's life is a bit easier as a result. But
there is a long history of some websites taking advantage of this layer of trust, and using the data they glean
from you and your browsing habits for their own purposes, and maybe to your potential detriment. Such sites are
using you and storing their data on your system. That is why the privacy conscious watch from whom those cookies
come, and why they really <span class="emphasis"><i class="EMPHASIS">need</i></span> to be there.</p>
- <p>See the <a href="http://en.wikipedia.org/wiki/Browser_cookie" target="_top">Wikipedia cookie definition</a>
+ <p>See the <a href="https://en.wikipedia.org/wiki/Browser_cookie" target="_top">Wikipedia cookie definition</a>
for more.</p>
</div>
<div class="SECT2">
Please don't bother to add an email address when using the tracker. If you prefer to communicate through email,
just use one of the mailing lists directly.</p>
<p>If you are new to reporting problems, you might be interested in <a href=
- "http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target="_top">How to Report Bugs Effectively</a>.</p>
+ "https://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target="_top">How to Report Bugs Effectively</a>.</p>
<p>The <a href="https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target="_top">appendix of the
Privoxy User Manual</a> also has helpful information on understanding <tt class="LITERAL">actions</tt>, and
<tt class="LITERAL">action</tt> debugging.</p>
autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the <span class=
"APPLICATION">Internet Junkbuster</span> did not. Version 2.0.2, published in 1998, was the last official
release, available from Junkbusters Corporation. Fortunately, it had been released under the GNU <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
+ "https://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
by others.</p>
<p>So Stefan Waldherr started maintaining an improved version of the software, to which eventually a number of
people contributed patches. It could already replace banners with a transparent image, and had a first version of
installation will benefit the most.</p>
<p>One of <span class="APPLICATION">Privoxy's</span> strengths is that it is highly configurable giving you the
ability to completely personalize your installation. Being familiar with, or at least having an interest in
- learning about <a href="http://en.wikipedia.org/wiki/Http" target="_top">HTTP</a> and other networking protocols,
-
<a href="http://en.wikipedia.org/wiki/Html" target="_top">HTML</a>, and <a href=
- "http://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
+ learning about <a href="https://en.wikipedia.org/wiki/Http" target="_top">HTTP</a> and other networking
+
protocols, <a href="https://en.wikipedia.org/wiki/Html" target="_top">HTML</a>, and <a href=
+ "https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
Expressions"</span></a> will be a big plus and will help you get the most out of <span class=
"APPLICATION">Privoxy</span>. A new installation just includes a very basic configuration. The user should take
this as a starting point only, and enhance it as he or she sees fit. In fact, the user is encouraged, and
expected to, fine-tune the configuration.</p>
<p>Much of <span class="APPLICATION">Privoxy's</span> configuration can be done with a <a href=
- "http://en.wikipedia.org/wiki/Web_browser" target="_top">Web browser</a>. But there are areas where configuration
- is done using a <a href="http://en.wikipedia.org/wiki/Text_editors" target="_top">text editor</a> to edit
- configuration files. Also note that the web-based action editor doesn't use authentication and should only be
- enabled in environments where all clients with access to <span class="APPLICATION">Privoxy</span> listening port
- can be trusted.</p>
+ "https://en.wikipedia.org/wiki/Web_browser" target="_top">Web browser</a>. But there are areas where
+ configuration is done using a <a href="https://en.wikipedia.org/wiki/Text_editors" target="_top">text editor</a>
+ to edit configuration files. Also note that the web-based action editor doesn't use authentication and should
+ only be enabled in environments where all clients with access to <span class="APPLICATION">Privoxy</span>
+ listening port can be trusted.</p>
</div>
<div class="SECT2">
<h3 class="SECT2"><a name="PROXYMORON" id="PROXYMORON">1.3. What is a <span class="QUOTE">"proxy"</span>? How
does Privoxy work?</a></h3>
- <p>A <a href="http://en.wikipedia.org/wiki/Proxy_server" target="_top">web proxy</a> is a service, based on a
+ <p>A <a href="https://en.wikipedia.org/wiki/Proxy_server" target="_top">web proxy</a> is a service, based on a
software such as <span class="APPLICATION">Privoxy</span>, that clients (i.e. browsers) can use instead of
connecting to web servers directly. The clients then ask the proxy to request objects (web pages, images, movies
etc) on their behalf and to forward the data to the clients. It is a <span class="QUOTE">"go-between"</span>. For
- details, see <a href="http://en.wikipedia.org/wiki/Proxy_server" target="_top">Wikipedia's proxy
+ details, see <a href="https://en.wikipedia.org/wiki/Proxy_server" target="_top">Wikipedia's proxy
definition</a>.</p>
<p>There are many reasons to use web proxies, such as security (firewalling), efficiency (caching) and others,
and there are any number of proxies to accommodate those needs.</p>
autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the <span class=
"APPLICATION">Internet Junkbuster</span> did not. Version 2.0.2, published in 1998, was the last official
release, available from Junkbusters Corporation. Fortunately, it had been released under the GNU <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
+ "https://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
by others.</p>
<p>So Stefan Waldherr started maintaining an improved version of the software, to which eventually a number of
people contributed patches. It could already replace banners with a transparent image, and had a first version of
<h3 class="SECT2"><a name="DIFFERS" id="DIFFERS">1.7. How does Privoxy differ from the old Junkbuster?</a></h3>
<p><span class="APPLICATION">Privoxy</span> picks up where <span class="APPLICATION">Junkbuster</span> left off.
<span class="APPLICATION">Privoxy</span> still blocks ads and banners, still manages <a href=
- "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a>, and still helps protect your privacy.
+ "https://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a>, and still helps protect your privacy.
But, most of these features have been enhanced, and many new ones have been added, all in the same vein.</p>
<p><span class="APPLICATION">Privoxy</span>'s new features include:</p>
<ul>
<div class="SECT2">
<h3 class="SECT2"><a name="LICENSE" id="LICENSE">1.14. Is there is a license or fee? What about a warranty?
Registration?</a></h3>
- <p><span class="APPLICATION">Privoxy</span> is free software and licensed under the <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GNU General Public License (GPL) version
- 2</a>. It is free to use, copy, modify or distribute as you wish under the terms of this license. Please see the
- <a href="copyright.html">Copyright</a> section for more information on the license and copyright. Or the
- <tt class="FILENAME">LICENSE</tt> file that should be included.</p>
+ <p><span class="APPLICATION">Privoxy</span> is free software. It is free to use, copy, modify or distribute as
+ you wish under the terms of its license. Please see the <a href="copyright.html">Copyright</a> section for more
+ information on the license and copyright.</p>
<p>There is <span class="emphasis"><i class="EMPHASIS">no warranty</i></span> of any kind, expressed, implied or
otherwise. That is something that would cost real money ;-) There is no registration either.</p>
</div>
client isn't explicitly configured to use <span class="APPLICATION">Privoxy</span>, but where possible,
configuring the client is recommended. See <a href="../user-manual/startup.html" target="_top">the User Manual
for more details</a>. You should also flush your browser's memory and disk cache to get rid of any cached junk
- items, and remove any stored <a href="http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a>.</p>
+ items, and remove any stored <a href="https://en.wikipedia.org/wiki/Browser_cookie" target=
+ "_top">cookies</a>.</p>
</div>
<div class="SECT2">
<h3 class="SECT2"><a name="LOCALHOST" id="LOCALHOST">2.5. What is the proxy address of Privoxy?</a></h3>
<h3 class="SECT2"><a name="CACHING" id="CACHING">4.12. Can Privoxy act as a <span class="QUOTE">"caching"</span>
proxy to speed up web browsing?</a></h3>
<p>No, it does not have this ability at all. You want something like <a href="http://www.squid-cache.org/"
- target="_top">Squid</a> or <a href="http://www.pps.jussieu.fr/~jch/software/polipo/" target="_top">Polipo</a> for
+ target="_top">Squid</a> or <a href="https://www.irif.fr/~jch//software/polipo/" target="_top">Polipo</a> for
this. And, yes, before you ask, <span class="APPLICATION">Privoxy</span> can co-exist with other kinds of proxies
like <span class="APPLICATION">Squid</span>. See the <a href="../user-manual/config.html#FORWARDING" target=
"_top">forwarding chapter</a> in the <a href="../user-manual/index.html" target="_top">user manual</a> for
<h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I keep seeing <span class=
"QUOTE">"PrivoxyWindowOpen()"</span> in raw source code?</a></h3>
<p><span class="APPLICATION">Privoxy</span> is attempting to disable malicious <a href=
- "http://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a> in this case, with the <tt class=
+ "https://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a> in this case, with the <tt class=
"LITERAL">unsolicited-popups</tt> filter. <span class="APPLICATION">Privoxy</span> cannot tell very well
<span class="QUOTE">"good"</span> code snippets from <span class="QUOTE">"bad"</span> code snippets.</p>
<p>If you see this in HTML source, and the page displays without problems, then this is good, and likely some
"QUOTE">"Preferences"</span>, click the <span class="QUOTE">"Settings"</span> button located on the <span class=
"QUOTE">"Network"</span> tab in the <span class="QUOTE">"Advanced"</span> section, and add <span class=
"QUOTE">"127.0.0.1:0"</span> in the <span class="QUOTE">"No Proxy for:"</span> field.</p>
+ <p>You can also prevent the problem by enabling <a href="../user-manual/actions-file.html#HTTPS-INSPECTION"
+ target="_top">https-inspection</a> in which case Privoxy's error messages are delivered encrypted.</p>
</div>
<div class="SECT2">
<h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux error messages. How can I fix
Privoxy bug.</p>
<p>To prevent the crashes you can rewrite your filter to use less resources, increase the relevant memory limit
or recompile pcre to use less stack space. For details please see the <a href=
- "http://pcre.org/original/doc/html/pcrestack.html" target="_top">pcrestack man page</a> and the documentation of
+ "https://pcre.org/original/doc/html/pcrestack.html" target="_top">pcrestack man page</a> and the documentation of
your operating system.</p>
</div>
<div class="SECT2">
already!</p>
<p>The pattern matching syntax is different for the host and path parts of the URL. The host part uses a simple
globbing type matching technique, while the path part uses more flexible <a href=
- "http://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
+ "https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
Expressions"</span></a> (POSIX 1003.2).</p>
<p>The port part of a pattern is a decimal port number preceded by a colon (<tt class="LITERAL">:</tt>). If the
host part contains a numerical IPv6 address, it has to be put into angle brackets (<tt class="LITERAL"><</tt>,
</div>
<p>Additionally, there are wild-cards that you can use in the domain names themselves. These work similarly to
shell globbing type wild-cards: <span class="QUOTE">"*"</span> represents zero or more arbitrary characters
- (this is equivalent to the <a href="http://en.wikipedia.org/wiki/Regular_expressions" target=
+ (this is equivalent to the <a href="https://en.wikipedia.org/wiki/Regular_expressions" target=
"_top"><span class="QUOTE">"Regular Expression"</span></a> based syntax of <span class="QUOTE">".*"</span>),
<span class="QUOTE">"?"</span> represents any single character (this is equivalent to the regular expression
syntax of a simple <span class="QUOTE">"."</span>), and you can define <span class="QUOTE">"character
<div class="SECT3">
<h3 class="SECT3"><a name="PATH-PATTERN" id="PATH-PATTERN">8.4.2. The Path Pattern</a></h3>
<p><span class="APPLICATION">Privoxy</span> uses <span class="QUOTE">"modern"</span> POSIX 1003.2 <a href=
- "http://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
+ "https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
Expressions"</span></a> for matching the path portion (after the slash), and is thus more flexible.</p>
<p>There is an <a href="appendix.html#REGEX">Appendix</a> with a brief quick-start into regular expressions,
you also might want to have a look at your operating system's documentation on regular expressions (try
completely rendered doesn't change much, but it may be perceived as slower since the page is not
incrementally displayed.) This effect will be more noticeable on slower connections.</p>
<p><span class="QUOTE">"Rolling your own"</span> filters requires a knowledge of <a href=
- "http://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
- Expressions"</span></a> and <a href="http://en.wikipedia.org/wiki/Html" target="_top"><span class=
+ "https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class="QUOTE">"Regular
+ Expressions"</span></a> and <a href="https://en.wikipedia.org/wiki/Html" target="_top"><span class=
"QUOTE">"HTML"</span></a>. This is very powerful feature, and potentially very intrusive. Filters should
be used with caution, and where an equivalent <span class="QUOTE">"action"</span> is not available.</p>
<p>The amount of data that can be filtered is limited to the <tt class="LITERAL"><a href=
occasionally useful to forge this in order to access sites that won't let you in otherwise (though there
may be a good reason in some cases).</p>
<p>More information on known user-agent strings can be found at <a href="http://www.user-agents.org/"
- target="_top">http://www.user-agents.org/</a> and <a href="http://en.wikipedia.org/wiki/User_agent"
+ target="_top">http://www.user-agents.org/</a> and <a href="https://en.wikipedia.org/wiki/User_agent"
target="_top">http://en.wikipedia.org/wiki/User_agent</a>.</p>
</dd>
<dt>Example usage:</dt>
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="AEN6379" id="AEN6379"></a>
+ <p>Privoxy main page:</p><a name="AEN6380" id="AEN6380"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target="_top">http://config.privoxy.org/</a></p>
</blockquote>
"APPLICATION">Privoxy</span>)</p>
</li>
<li>
- <p>View and toggle client tags:</p><a name="AEN6387" id="AEN6387"></a>
+ <p>View and toggle client tags:</p><a name="AEN6388" id="AEN6388"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/client-tags" target=
"_top">http://config.privoxy.org/client-tags</a></p>
</li>
<li>
<p>Show information about the current configuration, including viewing and editing of actions
- files:</p><a name="AEN6392" id="AEN6392"></a>
+ files:</p><a name="AEN6393" id="AEN6393"></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="AEN6397" id="AEN6397"></a>
+ <p>Show the browser's request headers:</p><a name="AEN6398" id="AEN6398"></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="AEN6402" id="AEN6402"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN6403" id="AEN6403"></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>
<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="AEN6410" id="AEN6410"></a>
+ but only as a pass-through proxy, with no actions taking place:</p><a name="AEN6411" id="AEN6411"></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="AEN6414" id="AEN6414"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN6415" id="AEN6415"></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="AEN6417" id="AEN6417"></a>
+ </blockquote><a name="AEN6418" id="AEN6418"></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>
target="_top">https-inspection</a></tt> action.</p>
<p><span class="APPLICATION">Privoxy</span> clients should import the certificate so that they can
validate the generated certificates.</p>
- <p>The file can be generated with: openssl req -new -x509 -extensions v3_ca -keyout cakey.pem -out
- cacert.crt -days 3650</p>
+ <p>The file can be generated with: <b class="COMMAND">openssl req -new -x509 -extensions v3_ca -keyout
+ cakey.pem -out cacert.crt -days 3650</b></p>
</dd>
<dt>Example:</dt>
<dd>
Please don't bother to add an email address when using the tracker. If you prefer to communicate through email,
just use one of the mailing lists directly.</p>
<p>If you are new to reporting problems, you might be interested in <a href=
- "http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target="_top">How to Report Bugs Effectively</a>.</p>
+ "https://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target="_top">How to Report Bugs Effectively</a>.</p>
<p>The <a href="https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target="_top">appendix of the
Privoxy User Manual</a> also has helpful information on understanding <tt class="LITERAL">actions</tt>, and
<tt class="LITERAL">action</tt> debugging.</p>
autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the <span class=
"APPLICATION">Internet Junkbuster</span> did not. Version 2.0.2, published in 1998, was the last official
release, available from Junkbusters Corporation. Fortunately, it had been released under the GNU <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
+ "https://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">GPL</a>, which allowed further development
by others.</p>
<p>So Stefan Waldherr started maintaining an improved version of the software, to which eventually a number of
people contributed patches. It could already replace banners with a transparent image, and had a first version of
'<' should be save, while '?' will sooner or later cause conflicts with $url.</p>
<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="http://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class=
+ <p>If you are new to <a href="https://en.wikipedia.org/wiki/Regular_expressions" target="_top"><span class=
"QUOTE">"Regular Expressions"</span></a>, you might want to take a look at the <a href=
"appendix.html#REGEX">Appendix on regular expressions</a>, and see the <a href=
"http://perldoc.perl.org/perlre.html" target="_top">Perl manual</a> for <a href=
3.0.29.</p>
<div class="SECT2">
<h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1. Features</a></h2>
- <p>In addition to the core features of ad blocking and <a href="http://en.wikipedia.org/wiki/Browser_cookie"
+ <p>In addition to the core features of ad blocking and <a href="https://en.wikipedia.org/wiki/Browser_cookie"
target="_top">cookie</a> management, <span class="APPLICATION">Privoxy</span> provides many supplemental
features, that give the end-user more control, more privacy and more freedom:</p>
<ul>
</li>
<li>
<p>Set your browser to use <span class="APPLICATION">Privoxy</span> as HTTP and HTTPS (SSL) <a href=
- "http://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a> by setting the proxy configuration for
+ "https://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a> by setting the proxy configuration for
address of <tt class="LITERAL">127.0.0.1</tt> and port <tt class="LITERAL">8118</tt>. <span class=
"emphasis"><i class="EMPHASIS">DO NOT</i></span> activate proxying for <tt class="LITERAL">FTP</tt> or any
protocols besides HTTP and HTTPS (SSL) unless you intend to prevent your browser from using these
</li>
<li>
<p>Flush your browser's disk and memory caches, to remove any cached ad images. If using <span class=
- "APPLICATION">Privoxy</span> to manage <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
+ "APPLICATION">Privoxy</span> to manage <a href="https://en.wikipedia.org/wiki/Browser_cookie" target=
"_top">cookies</a>, you should remove any currently stored cookies too.</p>
</li>
<li>
<h1 class="SECT1"><a name="STARTUP" id="STARTUP">5. Starting Privoxy</a></h1>
<p>Before launching <span class="APPLICATION">Privoxy</span> for the first time, you will want to configure your
browser(s) to use <span class="APPLICATION">Privoxy</span> as a HTTP and HTTPS (SSL) <a href=
- "http://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a>. The default is 127.0.0.1 (or localhost) for
+ "https://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a>. The default is 127.0.0.1 (or localhost) for
the proxy address, and port 8118 (earlier versions used port 8000). This is the one configuration step <span class=
"emphasis"><i class="EMPHASIS">that must be done</i></span>!</p>
<p>Please note that <span class="APPLICATION">Privoxy</span> can only proxy HTTP and HTTPS traffic. It will not
</div>
</div>
<p>After doing this, flush your browser's disk and memory caches to force a re-reading of all pages and to get rid
- of any ads that may be cached. Remove any <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
+ of any ads that may be cached. Remove any <a href="https://en.wikipedia.org/wiki/Browser_cookie" target=
"_top">cookies</a>, if you want <span class="APPLICATION">Privoxy</span> to manage that. You are now ready to start
enjoying the benefits of using <span class="APPLICATION">Privoxy</span>!</p>
<p><span class="APPLICATION">Privoxy</span> itself is typically started by specifying the main configuration file
projects / privoxy.git / commitdiff