From: hal9 Date: Sat, 21 Mar 2009 11:46:54 +0000 (+0000) Subject: Updated HTML docs for 3.0.12. X-Git-Tag: v_3_0_12~7 X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=commitdiff_plain;h=345a4d0bce0d40df7255eb1aeb2c1473dcb11f47 Updated HTML docs for 3.0.12. --- diff --git a/doc/webserver/developer-manual/contact.html b/doc/webserver/developer-manual/contact.html index 3d8ddc03..ce1c7db5 100644 --- a/doc/webserver/developer-manual/contact.html +++ b/doc/webserver/developer-manual/contact.html @@ -98,13 +98,13 @@ NAME="CONTACT-SUPPORT" >

For casual users, our support forum at SourceForge is probably best suited: http://sourceforge.net/tracker/?group_id=11118&atid=211118

default.action file, to http://sourceforge.net/tracker/?group_id=11118&atid=460288, @@ -228,7 +228,7 @@ NAME="CONTACT-BUGS" >

Please report all bugs through our bug tracker: http://sourceforge.net/tracker/?group_id=11118&atid=111118.

and observe the additional hints at the top of the submit form You are welcome to submit ideas on new features or other proposals for improvement through our feature request tracker at http://sourceforge.net/tracker/?atid=361118&group_id=11118.

But the web, its protocols and standards, and with it, the techniques for - forcing ads on users, give up autonomy over their browsing, and + forcing ads on users, give up autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the Internet @@ -198,19 +198,14 @@ TARGET="_top" >. Fortunately, it had been released under the GNU GPL, which allowed further - development by others.

GPL, + which allowed further development by others.

So Stefan Waldherr started maintaining an - improved version of the - software, to which eventually a number of people contributed patches. +> 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 pop-up killing, but it was still very closely based on the original, with all its limitations, such as the lack of HTTP/1.1 support, diff --git a/doc/webserver/developer-manual/cvs.html b/doc/webserver/developer-manual/cvs.html index db1fb9e9..30f3f694 100644 --- a/doc/webserver/developer-manual/cvs.html +++ b/doc/webserver/developer-manual/cvs.html @@ -255,7 +255,7 @@ CLASS="EMPHASIS" >

Note that near a major public release, we get more cautious. There is always the possibility to submit a patch to the patch tracker version string, e.g. "3.0.11""3.0.12".

Please note that this document is constantly evolving. This copy represents - the state at the release of version 3.0.11. + the state at the release of version 3.0.12. You can find the latest version of the this manual at

  debchange -v 3.0.11-stable-1 "New upstream version"
debchange -v 3.0.12-stable-1 "New upstream version" This will create ../privoxy_3.0.11-stable-1_i386.deb../privoxy_3.0.12-stable-1_i386.deb which can be uploaded. To upload the package to Sourceforge, simply issue @@ -1823,7 +1823,7 @@ CLASS="LITERAL" CLASS="emphasis" >3.0.11 +>3.0.12 (beta). diff --git a/doc/webserver/developer-manual/seealso.html b/doc/webserver/developer-manual/seealso.html index a614fe31..c17f538a 100644 --- a/doc/webserver/developer-manual/seealso.html +++ b/doc/webserver/developer-manual/seealso.html @@ -133,6 +133,29 @@ BORDER="0" > http://www.privoxy.org/developer-manual/, + the Privoxy developer manual. +

+

https://sourceforge.net/projects/ijbswa/
https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit

- -

http://www.privoxy.org/developer-manual/, - the Privoxy developer manual. -

1.17.3. Software

is developed by unpaid volunteers + and thus our current running costs are pretty low. Nevertheless, we + have plans that will cost money in the future. We would like to get + this money through donations made by our users.

If you are a vendor of a web-related software like a browser, web server - or proxy, and would like us to ensure that Privoxy has therefore become an associated + project of Software in the Public + Interest, which allows us to receive tax-deductible donations + in most western countries. Before donating you should probably read on, + though, to learn what we want your money for.

First of all we intend to transfer our domain to SPI to make sure + there's no single point of failure and the bill gets paid and the + site keeps running even if a some of the currently active developers + were to suddenly disappear for a while.

We would also like to spend some money on more reliable hosting, + on hardware to help make sure Privoxy - runs smoothly with your product, you might consider supplying us with a - copy or license. We can't, however, guarantee that we will fix all potential - compatibility issues as a result.

If you enjoy our software and feel like helping out with a donation, + please have a look at + SPI's donation page + to see what the options are. Small donations help too.


$Id: faq.sgml,v 2.56 2009/02/19 17:05:05 fabiankeil Exp $

$Id: faq.sgml,v 2.57 2009/03/19 19:07:49 fabiankeil Exp $

What is Privoxy?

Privoxy is a non-caching - web proxy - with advanced filtering capabilities for enhancing privacy, - modifying web page data, managing HTTP - cookies, - controlling access, and removing ads, banners, pop-ups and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. Privoxy has application for - both stand-alone systems and multi-user networks.

Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.

Privoxy is based on Internet Junkbuster (tm).

Privoxy is Free Software and licensed under the GPL2.

Please note that this document is a work in progress. This copy represents - the state at the release of version 3.0.11. + the state at the release of version 3.0.12. You can find the latest version of the document at

1.6. Why "Privoxy"
1.9. Can Privoxy make mistakes? This does not sound very scientific.
1.10. Will I have to configure Privoxy before I can use it?
1.17.2. Contribute!
1.17.3. SoftwareDonating
3.1. What exactly is an "actions"
3.3. How are actions files configured? What is the easiest way to do this?
3.4. There are several different "actions"
3.11. What is the default.filter
3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.
3.14. Why would anybody want to see a checkerboard pattern?
3.15. I see some images being replaced with text instead of the checkerboard image. Why and how do I get rid of this?
4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.
4.8. Can Privoxy guarantee I am anonymous?
4.9. A test site says I am not using a Proxy.
4.11. Might some things break because header information or content is being altered?
4.12. Can Privoxy act as a "caching"
4.13. What about as a firewall? Can Privoxy protect me?
4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?
4.15. How can Privoxy filter Secure (HTTPS) URLs?
4.16. Privoxy runs as a "server"
5.1. I cannot connect to any websites. Or, I am getting
5.3. I just added a new rule, but the steenkin ad is still getting through. How?
7.1. License
7.2. History

4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.

4.8. Can Privoxy guarantee I am anonymous?

4.9. A test site says I am not using a Proxy.

4.11. Might some things break because header information or content is being altered?

4.12. Can Privoxy act as a "caching"

4.13. What about as a firewall? Can Privoxy protect me?

4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?

4.15. How can Privoxy filter Secure (HTTPS) URLs?

4.16. Privoxy runs as a "server"

http://www.privoxy.org/developer-manual/, + the Privoxy developer manual. +

+

Privoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User Manual
https://sourceforge.net/projects/ijbswa/
https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit

- -

http://www.privoxy.org/developer-manual/, - the Privoxy developer manual. -

5.1. I cannot connect to any websites. Or, I am getting

5.3. I just added a new rule, but the steenkin ad is still getting through. How?

Privoxy is a non-caching - web proxy - with advanced filtering capabilities for enhancing privacy, - modifying web page data, managing HTTP - cookies, - controlling access, and removing ads, banners, pop-ups and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. Privoxy has application for - both stand-alone systems and multi-user networks.

Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.

Privoxy is based on Internet Junkbuster (tm).

Privoxy is Free Software and licensed under the GPL2.

The most recent release is 3.0.11 (stable)3.0.12 (stable).


+SRC="http://sourceforge.net/sflogo.php?group_id=11118&type=1&dummy=.gif">

Project Index Page v3.0.11

Project Index Page v3.0.12

Privoxy is a non-caching - web proxy - with advanced filtering capabilities for enhancing privacy, - modifying web page data, managing HTTP - cookies, - controlling access, and removing ads, banners, pop-ups and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. Privoxy has application for - both stand-alone systems and multi-user networks.

Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.

Privoxy is based on Internet Junkbuster (tm).

Privoxy is Free Software and licensed under the GPL2.


Privoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User Manual
Privoxy 3.0.11 User Manual
Privoxy 3.0.11 User Manual

14.2. Privoxy's Internal Pages

Short cuts. Turn off, then on:

  • Privoxy - Enable @@ -1030,7 +1030,7 @@ TARGET="_top" >

  • Privoxy - Disable @@ -1039,7 +1039,7 @@ TARGET="_top" >

  • Privoxy - Toggle Privoxy (Toggles between enabled and disabled) diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index 7967f84c..05e19b30 100644 --- a/doc/webserver/user-manual/config.html +++ b/doc/webserver/user-manual/config.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">

  • Privoxy 3.0.11 User Manual
    Privoxy 3.0.11 User Manual

    6.1. Controlling Privoxy with Your Web Browser

        Privoxy Menu

            ▪  Documentation diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 87fc244a..ae0ef224 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -8,7 +8,7 @@ RequestsPrivoxy 3.0.11 User Manual

    For casual users, our support forum at SourceForge is probably best suited: http://sourceforge.net/tracker/?group_id=11118&atid=211118

    default.action file, to http://sourceforge.net/tracker/?group_id=11118&atid=460288, @@ -232,7 +232,7 @@ NAME="CONTACT-BUGS" >

    Please report all bugs through our bug tracker: http://sourceforge.net/tracker/?group_id=11118&atid=111118.

    and observe the additional hints at the top of the submit form You are welcome to submit ideas on new features or other proposals for improvement through our feature request tracker at http://sourceforge.net/tracker/?atid=361118&group_id=11118.

    Privoxy 3.0.11 User Manual

    12.1. License

    But the web, its protocols and standards, and with it, the techniques for - forcing ads on users, give up autonomy over their browsing, and + forcing ads on users, give up autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the Internet @@ -201,19 +201,14 @@ TARGET="_top" >. Fortunately, it had been released under the GNU GPL, which allowed further - development by others.

    GPL, + which allowed further development by others.

    So Stefan Waldherr started maintaining an - improved version of the - software, to which eventually a number of people contributed patches. +> 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 pop-up killing, but it was still very closely based on the original, with all its limitations, such as the lack of HTTP/1.1 support, diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index 4bb6c5d4..b54c1825 100644 --- a/doc/webserver/user-manual/filter-file.html +++ b/doc/webserver/user-manual/filter-file.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">

    Privoxy 3.0.11 User Manual

    9.1. Filter File Tutorial

    Privoxy 3.0.11 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.11 User ManualPrivoxy 3.0.12 User Manual


    $Id: user-manual.sgml,v 2.100 2009/02/19 17:14:11 fabiankeil Exp $

    $Id: user-manual.sgml,v 2.103 2009/03/21 10:49:05 fabiankeil Exp $

    .

    Privoxy is a non-caching - web proxy - with advanced filtering capabilities for enhancing privacy, - modifying web page data, managing HTTP - cookies, - controlling access, and removing ads, banners, pop-ups and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. Privoxy has application for - both stand-alone systems and multi-user networks.

    Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.

    Privoxy is based on Internet Junkbuster (tm).

    Privoxy is Free Software and licensed under the GPL2.

    You can find the latest version of the

    6.1. Controlling Privoxy with Your Web Browser
    8.1. Finding the Right Mix
    8.2. How to Edit
    8.4.1. The Domain Pattern
    8.4.2. The Path Pattern
    8.5.34. Summary
    8.7.1. match-all.action
    8.7.2. default.action
    8.7.3. user.action
    9.1. Filter File Tutorial
    12.1. License
    14.2. Privoxy's Internal Pages
    Privoxy 3.0.11 User Manual

    RPMs can be installed with rpm -Uvh privoxy-3.0.11-1.rpmrpm -Uvh privoxy-3.0.12-1.rpm, and will use If you have problems with failed dependencies, try rebuilding the SRC RPM: rpm --rebuild privoxy-3.0.11-1.src.rpmrpm --rebuild privoxy-3.0.12-1.src.rpm. This will use your locally installed libraries and RPM version.

    , the documentation is in /usr/share/doc/privoxy-3.0.11/usr/share/doc/privoxy-3.0.12 and the Log directory is in sources is to download the source tarball from our project download page

     tar xzvf privoxy-3.0.11-stable-src* [.tgz or .tar.gz]
    - cd privoxy-3.0.11
    tar xzvf privoxy-3.0.12-stable-src.tar.gz + cd privoxy-3.0.12-stable
    For more detailed instructions on how to build Redhat RPMs, Windows self-extracting installers, building on platforms with special requirements etc, please consult the developer manual.

    actions file (as a separate package
    +> \ No newline at end of file diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index 9f7619aa..aad9cc05 100644 --- a/doc/webserver/user-manual/introduction.html +++ b/doc/webserver/user-manual/introduction.html @@ -7,10 +7,10 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">
    Privoxy 3.0.11 User Manual
    Privoxy, v.3.0.11.

    , v.3.0.12.

    Privoxy 3.0.11 User Manual

    Privoxy 3.0.11 User Manual

    Privoxy 3.0.11 User Manual
    http://www.privoxy.org/developer-manual/, + the Privoxy developer manual. +

    +

    Privoxy 3.0.12 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.12 User Manual
    https://sourceforge.net/projects/ijbswa/
    https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit

    - -

    http://www.privoxy.org/developer-manual/, - the Privoxy developer manual. -

    Privoxy 3.0.11 User Manual

    Privoxy 3.0.11 User Manual
    Privoxy 3.0.11 User Manual
    3. What's New in this Release

    There are only a few improvements and new features since - Privoxy 3.0.10, the last stable release:

    Privoxy 3.0.12 is mainly a bugfix release:

    • On most platforms, outgoing connections can be kept alive and - reused if the server supports it. Whether or not this improves - things depends on the connection. +> The socket-timeout option now also works on platforms whose + select() implementation modifies the timeout structure. + Previously the timeout was triggered even if the connection + didn't stall. Reported by cyberpatrol.

    • When dropping privileges, membership in supplementary groups - is given up as well. Not doing that can lead to Privoxy running - with more rights than necessary and violates the principle of - least privilege. Users of the --user option are advised to update. - Thanks to Matthias Drochner for reporting the problem, - providing the initial patch and testing the final version. +> The Connection: keep-alive code properly deals with files + larger than 2GB. Previously the connection was closed too + early.

    • Passing invalid users or groups with the --user option - didn't lead to program exit. Regression introduced in 3.0.7. +> The content length for files above 2GB is logged correctly.

    • The match all section has been moved from default.action - to a new file called match-all.action. As a result the - default.action no longer needs to be touched by the user - and can be safely overwritten by updates. +> The user-manual directive on the show-status page links to + the documentation location specified with the directive, + not to the Privoxy website.

    • The standard.action file has been removed. Its content - is now part of the default.action file. +> When running in daemon mode, Privoxy doesn't log anything + to the console unless there are errors before the logfile + has been opened.

    • In some situations the logged content length was slightly too low. +> The show-status page prints warnings about invalid directives + on the same line as the directives themselves.

    • Crunched requests are logged with their own log level. - If you used "debug 1" in the past, you'll probably want - to additionally enable "debug 1024", otherwise only passed - requests will be logged. If you only care about crunched - requests, simply replace "debug 1" with "debug 1024". +> Fixed several justified (but harmless) compiler warnings, + mostly on 64 bit platforms.

    • The crunch reason has been moved to the beginning of the - crunch message. For HTTP URLs, the protocol is logged as well. +> The mingw32 version explicitly requests the default charset + to prevent display problems with some fonts available on more + recent Windows versions. Patch by Burberry.

    • Log messages are shortened by printing the thread id on its - own (as opposed to putting it inside the string "Privoxy()"). +> The mingw32 version uses the Privoxy icon in the alt-tab + windows. Patch by Burberry.

    • The config option socket-timeout has been added to control - the time Privoxy waits for data to arrive on a socket. +> The timestamp and the thread id is omitted in the "Fatal error" + message box on mingw32.

    • Support for remote toggling is controlled by the configure - option --disable-toggle only. In previous versions it also - depended on the action editor and thus configuring with the - --disable-editor option would disable remote toggling support - as well. +> Fixed two related mingw32-only buffer overflows. Triggering + them required control over the configuration file, therefore + this isn't seen as a security issue.

    • Requests with invalid HTTP versions are rejected. -

    • The template symbol @date@ can be used to include a date(1)-like - time string. Initial patch submitted by Endre Szabo. -

    • Responses from shoutcast servers are accepted again. - Problem reported and fix suggested by Stefan. -

    • The hide-forwarded-for-headers action has been replaced with - the change-x-forwarded-for{} action which can also be used to - add X-Forwarded-For headers. The latter functionality already - existed in Privoxy versions prior to 3.0.7 but has been removed - as it was often used unintentionally (by not using the - hide-forwarded-for-headers action). -

    • A "clear log" view option was added to the mingw32 version - to clear out all of the lines in the Privoxy log window. - Based on a patch submitted by T Ford. -

    • The mingw32 version uses "critical sections" now, which prevents - log message corruption under load. As a side effect, the - "no thread-safe PRNG" warning could be removed as well. -

    • The mingw32 version's task bar icon is crossed out and - the color changed to gray if Privoxy is toggled off. +> In verbose mode, or if the new option --show-skipped-tests + is used, Privoxy-Regression-Test logs skipped tests and the + skip reason.

    This release marks a departure for Privoxy development.

    Previously, odd numbered releases were considered beta versions and - were only released at the end of the development cycle when the code - was already believed to be stable. Usually it was, so the stable release - contained pretty much the same code, but got a higher version number. - In the future we intend to release several snapshots between stable releases. - There will probably still be about two stable releases per year, - but hopefully about six snapshots instead of the two betas we have now. - The intentions is to make testing without CVS access easier.