From 173d9755c86ab651bdbf5fb17762618b814c31ee Mon Sep 17 00:00:00 2001 From: Fabian Keil Date: Fri, 17 Apr 2009 13:11:18 +0000 Subject: [PATCH] Docs regenerated with the IPv6 changes. --- .../developer-manual/documentation.html | 4 +- doc/webserver/developer-manual/index.html | 4 +- .../developer-manual/newrelease.html | 8 +- doc/webserver/faq/configuration.html | 16 +- doc/webserver/faq/copyright.html | 6 +- doc/webserver/faq/general.html | 44 +-- doc/webserver/faq/index.html | 50 ++-- doc/webserver/faq/misc.html | 22 +- doc/webserver/faq/trouble.html | 6 +- doc/webserver/index.html | 4 +- doc/webserver/privoxy-index.html | 4 +- doc/webserver/user-manual/actions-file.html | 87 ++++-- doc/webserver/user-manual/appendix.html | 24 +- doc/webserver/user-manual/config.html | 277 +++++++++++++++++- doc/webserver/user-manual/configuration.html | 24 +- doc/webserver/user-manual/contact.html | 6 +- doc/webserver/user-manual/copyright.html | 8 +- doc/webserver/user-manual/filter-file.html | 8 +- doc/webserver/user-manual/index.html | 32 +- doc/webserver/user-manual/installation.html | 16 +- doc/webserver/user-manual/introduction.html | 32 +- doc/webserver/user-manual/quickstart.html | 8 +- doc/webserver/user-manual/seealso.html | 6 +- doc/webserver/user-manual/startup.html | 10 +- doc/webserver/user-manual/templates.html | 6 +- doc/webserver/user-manual/whatsnew.html | 6 +- 26 files changed, 519 insertions(+), 199 deletions(-) diff --git a/doc/webserver/developer-manual/documentation.html b/doc/webserver/developer-manual/documentation.html index d547c236..5cb88d7b 100644 --- a/doc/webserver/developer-manual/documentation.html +++ b/doc/webserver/developer-manual/documentation.html @@ -802,7 +802,7 @@ CLASS="APPLICATION" > version string, e.g. "3.0.12""3.0.13". \ No newline at end of file +> diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html index 124726b6..1ee064de 100644 --- a/doc/webserver/developer-manual/index.html +++ b/doc/webserver/developer-manual/index.html @@ -71,7 +71,7 @@ CLASS="APPLICATION" and may not be entirely correct. As always, patches are welcome.

Please note that this document is constantly evolving. This copy represents - the state at the release of version 3.0.12. + the state at the release of version 3.0.13. You can find the latest version of the this manual at \ No newline at end of file +> diff --git a/doc/webserver/developer-manual/newrelease.html b/doc/webserver/developer-manual/newrelease.html index 0cdb4851..8999d561 100644 --- a/doc/webserver/developer-manual/newrelease.html +++ b/doc/webserver/developer-manual/newrelease.html @@ -1351,7 +1351,7 @@ WIDTH="100%" >

  debchange -v 3.0.12-stable-1 "New upstream version"
debchange -v 3.0.13-UNRELEASED-1 "New upstream version" This will create ../privoxy_3.0.12-stable-1_i386.deb../privoxy_3.0.13-UNRELEASED-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.12 +>3.0.13 (beta). @@ -1953,4 +1953,4 @@ VALIGN="top" > \ No newline at end of file +> diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html index 01c001bd..a7963cbd 100644 --- a/doc/webserver/faq/configuration.html +++ b/doc/webserver/faq/configuration.html @@ -84,7 +84,7 @@ CLASS="SECT2" >

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?

\ No newline at end of file +> diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html index 39b71a6f..fd85b3ad 100644 --- a/doc/webserver/faq/copyright.html +++ b/doc/webserver/faq/copyright.html @@ -106,7 +106,7 @@ CLASS="SECT2" >

7.1. License

7.2. History

\ No newline at end of file +> diff --git a/doc/webserver/faq/general.html b/doc/webserver/faq/general.html index 7043b18b..83350b3a 100644 --- a/doc/webserver/faq/general.html +++ b/doc/webserver/faq/general.html @@ -898,7 +898,7 @@ CLASS="SECT2" >

1.17. I would like to help you, what can I do?

1.17.1. Would you like to participate?

. There are many other tasks available. In fact, the programmers often can't spend as much time programming because of some of the other, more mundane things that need to be done, like checking the - Tracker feedback sections. + Tracker feedback sections or responding to user questions on the mailing + lists.

So first thing, So first thing, subscribe to the Privoxy Users + or the Privoxy + Developers mailing list, join the discussion, help out other users, provide general + feedback or report problems you noticed. +

If you intend to help out with the trackers, you also might want to get an account on SourceForge.net - and mail your id to the developers - mailing list. Then, please read the

We also have a Developer's Manual, at least - the pertinent sections.

You can also start helping out without SourceForge.net account, - simply by showing up on the mailing list, helping out other users, - providing general feedback or reporting problems you noticed. -

. + While it is partly out of date, it's still worth reading.

\ No newline at end of file +> diff --git a/doc/webserver/faq/index.html b/doc/webserver/faq/index.html index 2bd672b8..0e0afcf2 100644 --- a/doc/webserver/faq/index.html +++ b/doc/webserver/faq/index.html @@ -48,7 +48,7 @@ TARGET="_top" >

$Id: faq.sgml,v 2.58 2009/03/21 12:27:44 fabiankeil Exp $

$Id: faq.sgml,v 2.60 2009/04/07 12:25:05 fabiankeil Exp $

\ No newline at end of file +> diff --git a/doc/webserver/faq/misc.html b/doc/webserver/faq/misc.html index 174722e6..7efb6a32 100644 --- a/doc/webserver/faq/misc.html +++ b/doc/webserver/faq/misc.html @@ -84,7 +84,7 @@ CLASS="SECT2" >

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.

#        forward-socks4a             /     127.0.0.1:9050 .
+>#        forward-socks5             /     127.0.0.1:9050 .
  

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"

\ No newline at end of file +> diff --git a/doc/webserver/faq/trouble.html b/doc/webserver/faq/trouble.html index 8bc5b709..da335e43 100644 --- a/doc/webserver/faq/trouble.html +++ b/doc/webserver/faq/trouble.html @@ -84,7 +84,7 @@ CLASS="SECT2" >

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?

\ No newline at end of file +> diff --git a/doc/webserver/index.html b/doc/webserver/index.html index 3afc2d95..e9528162 100644 --- a/doc/webserver/index.html +++ b/doc/webserver/index.html @@ -104,7 +104,7 @@ TARGET="_top" > The most recent release is 3.0.12 (stable)3.0.13 (UNRELEASED).

\ No newline at end of file +> diff --git a/doc/webserver/privoxy-index.html b/doc/webserver/privoxy-index.html index 22cec35b..8ce1e820 100644 --- a/doc/webserver/privoxy-index.html +++ b/doc/webserver/privoxy-index.html @@ -79,7 +79,7 @@ NAME="AEN2" >

Project Index Page v3.0.12

Project Index Page v3.0.13
\ No newline at end of file +> diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index be87aa77..f0f88ba7 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

8.1. Finding the Right Mix

8.2. How to Edit

Generally, an URL pattern has the form <domain>/<path>, where both the +><domain><port>/<path>, where the <domain> and , the <port> + and the <path> are - optional. (This is why the special are optional. (This is why the special + / pattern matches all - URLs). Note that the protocol portion of the URL pattern (e.g. - pattern matches all URLs). Note that the protocol + portion of the URL pattern (e.g. http://) should ) should + not be included in - the pattern. This is assumed already!

be included in the pattern. This is assumed already!

The pattern matching syntax is different for the domain and path parts of the URL. The domain part uses a simple globbing type matching technique, @@ -753,6 +756,20 @@ CLASS="QUOTE" > (POSIX 1003.2).

The port part of a pattern is a decimal port number preceded by a colon + (:). If the domain part contains a numerical IPv6 address, + it has to be put into angle brackets + (<, >).

:8000/

Matches any URL pointing to TCP port 8000. +

<2001:db8::1>/

Matches any URL with the host address 2001:db8::1. + (Note that the real URL uses plain brackets, not angle brackets.) +

index.html

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

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html index 4df57a49..87c651ee 100644 --- a/doc/webserver/user-manual/appendix.html +++ b/doc/webserver/user-manual/appendix.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

14.2. Privoxy's Internal Pages

Short cuts. Turn off, then on:

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index 05e19b30..2562be56 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.12 User ManualPrivoxy 3.0.13 User Manual1, 4096 and 8192 are recommended1, 1024, 4096 and 8192 are recommended so that you will notice when things go wrong. The other levels are @@ -1663,12 +1663,12 @@ CLASS="REPLACEABLE" >Effect if unset:

Bind to 127.0.0.1 (localhost), port 8118. This is suitable and recommended for - home users who run Bind to 127.0.0.1 (IPv4 localhost), port 8118. This is suitable and + recommended for home users who run Privoxy on the same machine as - their browser. +> on + the same machine as their browser.

IPv6 addresses containing colons have to be quoted by brackets. +

If you leave out the IP address, Privoxy will - bind to all interfaces (addresses) on your machine and may become reachable + bind to all IPv4 interfaces (addresses) on your machine and may become reachable from the Internet. In that case, consider using access control lists (ACL's, see below), and/or - a firewall. + a firewall. If the hostname is localhost, Privoxy + will explicitly try to bind to an IPv4 address. For other hostnames it depends + on the operating system which IP version will be used.

If you open +

Suppose you are running Privoxy on an + IPv6-capable machine and you want it to listen on the IPv6 address + of the loopback device: +

  listen-address [::1]:8118

src_addr
[/[:port][/src_masklendst_addr[/[:port][/dst_masklendst_addr are IP addresses in dotted decimal notation or valid - DNS names, and are IPv4 addresses in dotted decimal notation or valid + DNS names, port is a port + number, and src_masklen

If your system implements + RFC 3493, then + src_addr and dst_addr can be IPv6 addresses delimeted by + brackets, port can be a number + or a service name, and + src_masklen and + dst_masklen can be a number + from 0 to 128. +

Default value:
Unset

If no port is specified, + any port will match. If no src_masklen or + src_masklen is given, the complete IP + address has to match (i.e. 32 bits for IPv4 and 128 bits for IPv6). +

Effect if unset:

Some systems allows IPv4 client to connect to IPv6 server socket. + Then the client's IPv4 address will be translated by system into + IPv6 address space with special prefix ::ffff:0:0/96 (so called IPv4 + mapped IPv6 address). Privoxy can handle it + and maps such ACL addresses automatically. +

Denying access to particular sites by ACL may have undesired side effects if the site in question is hosted on a machine which also hosts other sites (most sites are). @@ -2507,6 +2624,44 @@ CLASS="SCREEN" > +

Allow access from the IPv4 network 192.0.2.0/24 even if listening on + an IPv6 wild card address (not supported on all platforms): +

  permit-access  192.0.2.0/24
+

This is equivalent to the following line even if listening on an + IPv4 address (not supported on all platforms): +

  permit-access  [::ffff:192.0.2.0]/120

] is the DNS name or IP address of the parent HTTP proxy through which the requests should be forwarded, - optionally followed by its listening port (default: 8080). + optionally followed by its listening port (default: 8000). Use a single dot (.

http_parent can be a + numerical IPv6 address (if + RFC 3493 is + implemented). To prevent clashes with the port delimiter, the whole IP + address has to be put into brackets. On the other hand a target_pattern containing an IPv6 address + has to be put into angle brackets (normal brackets are reserved for + regular expressions already). +

Multiple lines are OK, they are checked in sequence, and the last match wins.

+

Parent proxy specified by an IPv6 address: +

  foward   /                   [2001:DB8::1]:8000
+

Suppose your parent proxy doesn't support IPv6: +

  forward  /                        parent-proxy.example.org:8000
+  forward  ipv6-server.example.org  .
+  forward  <[2-3][0-9a-f][0-9a-f][0-9a-f]:*>   .

the DNS resolution will happen on the remote server as well.

socks_proxy and + http_parent can be a + numerical IPv6 address (if + RFC 3493 is + implemented). To prevent clashes with the port delimiter, the whole IP + address has to be put into brackets. On the other hand a target_pattern containing an IPv6 address + has to be put into angle brackets (normal brackets are reserved for + regular expressions already). +

If

  forward-socks4a   /               127.0.0.1:9050 .
forward-socks5 / 127.0.0.1:9050 .
\ No newline at end of file +> diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html index b4f021e4..2cd26c0d 100644 --- a/doc/webserver/user-manual/configuration.html +++ b/doc/webserver/user-manual/configuration.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

6.1. Controlling Privoxy with Your Web Browser

    Privoxy Menu

        ▪  Documentation @@ -275,7 +275,9 @@ CLASS="FILENAME" Privoxy executable.

executable. The name + and number of configuration files has changed from previous versions, and is + subject to change as development progresses.

The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, the @@ -449,6 +451,14 @@ CLASS="EMPHASIS" >old listening address.

While under development, the configuration content is subject to change. + The below documentation may not be accurate by the time you read this. + Also, what constitutes a "default" setting, may change, so + please check all your configuration files on important issues.

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 3fd43eb3..619bdb3e 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -8,7 +8,7 @@ RequestsPrivoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual \ No newline at end of file +> diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html index b2e1e960..8a0b91df 100644 --- a/doc/webserver/user-manual/copyright.html +++ b/doc/webserver/user-manual/copyright.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

12.1. License

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index 3a2ec3a3..fe51c5a8 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.12 User ManualPrivoxy 3.0.13 User Manual

9.1. Filter File Tutorial

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index ad99a22e..65d5a401 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -2,7 +2,7 @@ Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User ManualPrivoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual


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

$Id: user-manual.sgml,v 2.105 2009/04/17 11:32:57 fabiankeil Exp $

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/installation.html b/doc/webserver/user-manual/installation.html index f5fefc22..053513ca 100644 --- a/doc/webserver/user-manual/installation.html +++ b/doc/webserver/user-manual/installation.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

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

, the documentation is in /usr/share/doc/privoxy-3.0.12/usr/share/doc/privoxy-3.0.13 and the Log directory is in

 tar xzvf privoxy-3.0.12-stable-src.tar.gz
- cd privoxy-3.0.12-stable
tar xzvf privoxy-3.0.13-beta-src.tar.gz + cd privoxy-3.0.13-beta
\ No newline at end of file +> diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index aad9cc05..41fe6cba 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.12 User ManualPrivoxy 3.0.13 User Manual1. Introduction

This documentation is included with the current stable version of +> This documentation is included with the current UNRELEASED version of Privoxy, v.3.0.12.

, v.3.0.13, + and is mostly complete at this point. The most up to date reference for the + time being is still the comments in the source files and in the individual + configuration files. Development of a new version is currently nearing + completion, and includes significant changes and enhancements over + earlier versions. .

Since this is a UNRELEASED version, not all new features are well tested. This + documentation may be slightly out of sync as a result (especially with + CVS sources). And there may be bugs, though hopefully + not many!

Privoxy provides many supplemental - features, + features, some of them currently under development, that give the end-user more control, more privacy and more freedom:

Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index 03936895..484c2ac7 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/seealso.html b/doc/webserver/user-manual/seealso.html index 93a8b2d7..77876b8a 100644 --- a/doc/webserver/user-manual/seealso.html +++ b/doc/webserver/user-manual/seealso.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual \ No newline at end of file +> diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index e4f0c23a..07610d08 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual

\ No newline at end of file +> diff --git a/doc/webserver/user-manual/templates.html b/doc/webserver/user-manual/templates.html index 7e31c75e..d5019fde 100644 --- a/doc/webserver/user-manual/templates.html +++ b/doc/webserver/user-manual/templates.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual
\ No newline at end of file +> diff --git a/doc/webserver/user-manual/whatsnew.html b/doc/webserver/user-manual/whatsnew.html index 5d7c0b25..34362731 100644 --- a/doc/webserver/user-manual/whatsnew.html +++ b/doc/webserver/user-manual/whatsnew.html @@ -7,7 +7,7 @@ NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79">Privoxy 3.0.12 User ManualPrivoxy 3.0.13 User Manual \ No newline at end of file +> -- 2.39.2