[prev in list] [next in list] [prev in thread] [next in thread]
List: privoxy-commits
Subject: [privoxy-commits] current/doc/webserver/user-manual
From: noreply () sourceforge ! net
Date: 2007-07-18 22:48:18
Message-ID: E1IBIJe-0004Pf-Eq () mail ! sourceforge ! net
[Download RAW message or body]
Update of /cvsroot/ijbswa/current/doc/webserver/user-manual
In directory sc8-pr-cvs2.sourceforge.net:/tmp/cvs-serv12358/doc/webserver/user-manual
Modified Files:
actions-file.html appendix.html config.html configuration.html
contact.html copyright.html filter-file.html index.html
installation.html introduction.html quickstart.html
seealso.html startup.html templates.html whatsnew.html
Log Message:
Submit new version of manual so some of Fabians work has some documentation.
Index: actions-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/actions-file.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- actions-file.html 14 Nov 2006 02:06:20 -0000 1.15
+++ actions-file.html 18 Jul 2007 22:48:08 -0000 1.16
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="The Main Configuration File"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
[...1877 lines suppressed...]
HREF="actions-file.html#SESSION-COOKIES-ONLY"
>session-cookies-only</A
@@ -8200,7 +8511,7 @@
><H3
CLASS="SECT3"
><A
-NAME="AEN4206"
+NAME="AEN4374"
></A
>8.7.2. user.action</H3
><P
@@ -8427,7 +8738,7 @@
HREF="actions-file.html#BLOCK"
>block</A
> }
- www.example.com/nasty-ads/sponsor.gif
+ www.example.com/nasty-ads/sponsor\.gif
another.popular.site.net/more/junk/here/</PRE
></TD
></TR
Index: appendix.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/appendix.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -d -r1.24 -r1.25
--- appendix.html 14 Nov 2006 02:06:20 -0000 1.24
+++ appendix.html 18 Jul 2007 22:48:09 -0000 1.25
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="See Also"
@@ -36,7 +36,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -745,7 +745,7 @@
><H2
CLASS="SECT2"
><A
-NAME="AEN5046"
+NAME="AEN5252"
></A
>14.2. Privoxy's Internal Pages</H2
><P
@@ -791,7 +791,7 @@
Privoxy main page:
</P
><A
-NAME="AEN5060"
+NAME="AEN5266"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -824,7 +824,7 @@
editing of actions files:
</P
><A
-NAME="AEN5068"
+NAME="AEN5274"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -844,7 +844,7 @@
Show the source code version numbers:
</P
><A
-NAME="AEN5073"
+NAME="AEN5279"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -864,7 +864,7 @@
Show the browser's request headers:
</P
><A
-NAME="AEN5078"
+NAME="AEN5284"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -884,7 +884,7 @@
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN5083"
+NAME="AEN5289"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -908,7 +908,7 @@
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN5089"
+NAME="AEN5295"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -925,7 +925,7 @@
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN5093"
+NAME="AEN5299"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -939,7 +939,7 @@
</P
></BLOCKQUOTE
><A
-NAME="AEN5096"
+NAME="AEN5302"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -1446,6 +1446,7 @@
{-add-header
-block
+ -client-header-filter{hide-tor-exit-notation}
-content-type-overwrite
-crunch-client-header
-crunch-if-none-match
@@ -1480,12 +1481,7 @@
-filter {yahoo}
-filter {msn}
-filter {blogspot}
- -filter {xml-to-html}
- -filter {html-to-xml}
-filter {no-ping}
- -filter{hide-tor-exit-notation}
- -filter-client-headers
- -filter-server-headers
-force-text-mode
-handle-as-empty-document
-handle-as-image
@@ -1504,6 +1500,8 @@
-redirect
-send-vanilla-wafer
-send-wafer
+ -server-header-filter{xml-to-html}
+ -server-header-filter{html-to-xml}
+session-cookies-only
+set-image-blocker {pattern}
-treat-forbidden-connects-like-blocks }
@@ -1681,6 +1679,7 @@
-add-header
-block
+ -client-header-filter{hide-tor-exit-notation}
-content-type-overwrite
-crunch-client-header
-crunch-if-none-match
@@ -1715,12 +1714,7 @@
-filter {yahoo}
-filter {msn}
-filter {blogspot}
- -filter {xml-to-html}
- -filter {html-to-xml}
-filter {no-ping}
- -filter{hide-tor-exit-notation}
- -filter-client-headers
- -filter-server-headers
-force-text-mode
-handle-as-empty-document
-handle-as-image
@@ -1739,6 +1733,8 @@
-redirect
-send-vanilla-wafer
-send-wafer
+ -server-header-filter{xml-to-html}
+ -server-header-filter{html-to-xml}
-session-cookies-only
+set-image-blocker {pattern}
-treat-forbidden-connects-like-blocks </PRE
@@ -1874,6 +1870,7 @@
{-add-header
-block
+ -client-header-filter{hide-tor-exit-notation}
-content-type-overwrite
-crunch-client-header
-crunch-if-none-match
@@ -1908,12 +1905,7 @@
-filter {yahoo}
-filter {msn}
-filter {blogspot}
- -filter {xml-to-html}
- -filter {html-to-xml}
-filter {no-ping}
- -filter{hide-tor-exit-notation}
- -filter-client-headers
- -filter-server-headers
-force-text-mode
-handle-as-empty-document
-handle-as-image
@@ -1929,7 +1921,9 @@
+prevent-compression
-redirect
-send-vanilla-wafer
- -send-wafer
+ -send-wafer
+ -server-header-filter{xml-to-html}
+ -server-header-filter{html-to-xml}
+session-cookies-only
+set-image-blocker{blank}
-treat-forbidden-connects-like-blocks }
Index: config.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/config.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- config.html 3 Oct 2006 11:13:55 -0000 1.12
+++ config.html 18 Jul 2007 22:48:09 -0000 1.13
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Privoxy Configuration"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -627,9 +627,59 @@
><H4
CLASS="SECT3"
><A
+NAME="TEMPLDIR"
+></A
+>7.2.2. templdir</H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Specifies:</DT
+><DD
+><P
+>An alternative directory where the templates are loaded from</P
+></DD
+><DT
+>Type of value:</DT
+><DD
+><P
+>Path name</P
+></DD
+><DT
+>Default value:</DT
+><DD
+><P
+>unset</P
+></DD
+><DT
+>Effect if unset:</DT
+><DD
+><P
+>The templates are assumed to be located in confdir/template.</P
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+> Privoxy's original templates are usually overwritten
+ with each update. Use this option to relocate customized templates
+ that should be kept. Note that you might be missing new features
+ if you use outdated templates.
+ </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
NAME="LOGDIR"
></A
->7.2.2. logdir</H4
+>7.2.3. logdir</H4
><P
></P
><DIV
@@ -705,7 +755,7 @@
><A
NAME="ACTIONSFILE"
></A
->7.2.3. actionsfile</H4
+>7.2.4. actionsfile</H4
><A
NAME="DEFAULT.ACTION"
></A
@@ -734,13 +784,10 @@
>Type of value:</DT
><DD
><P
->File name, relative to <TT
+>Complete file name, relative to <TT
CLASS="LITERAL"
>confdir</TT
->, without the <TT
-CLASS="LITERAL"
->.action</TT
-> suffix</P
+></P
></DD
><DT
>Default values:</DT
@@ -754,7 +801,7 @@
><TD
> <P
CLASS="LITERALLAYOUT"
-> standard # Internal purposes, no editing recommended</P
+> standard.action # Internal purposes, no editing recommended</P
>
</TD
></TR
@@ -762,7 +809,7 @@
><TD
> <P
CLASS="LITERALLAYOUT"
-> default # Main actions file</P
+> default.action # Main actions file</P
>
</TD
></TR
@@ -770,7 +817,7 @@
><TD
> <P
CLASS="LITERALLAYOUT"
-> user # User customizations</P
+> user.action # User customizations</P
>
</TD
></TR
@@ -783,7 +830,7 @@
>Effect if unset:</DT
><DD
><P
-> No actions are taken at all. Simple neutral proxying.
+> No actions are taken at all. More or less neutral proxying.
</P
></DD
><DT
@@ -818,6 +865,14 @@
> without at
least one actions file.
</P
+><P
+> Note that since Privoxy 3.0.7, the complete filename, including the <SPAN
+CLASS="QUOTE"
+>".action"</SPAN
+>
+ extension has to be specified. The syntax change was necessary to be consistent
+ with the other file options and to allow previously forbidden characters.
+ </P
></DD
></DL
></DIV
@@ -829,7 +884,7 @@
><A
NAME="FILTERFILE"
></A
->7.2.4. filterfile</H4
+>7.2.5. filterfile</H4
><A
NAME="DEFAULT.FILTER"
></A
@@ -967,7 +1022,7 @@
><A
NAME="LOGFILE"
></A
->7.2.5. logfile</H4
+>7.2.6. logfile</H4
><P
></P
><DIV
@@ -1072,7 +1127,7 @@
><A
NAME="JARFILE"
></A
->7.2.6. jarfile</H4
+>7.2.7. jarfile</H4
><P
></P
><DIV
@@ -1134,7 +1189,7 @@
><A
NAME="TRUSTFILE"
></A
->7.2.7. trustfile</H4
+>7.2.8. trustfile</H4
><P
></P
><DIV
@@ -1364,10 +1419,10 @@
debug 2 # show each connection status
debug 4 # show I/O status
debug 8 # show header parsing
- debug 16 # log all data into the logfile
+ debug 16 # log all data written to the network into the logfile
debug 32 # debug force feature
- debug 64 # debug regular expression filter
- debug 128 # debug fast redirects
+ debug 64 # debug regular expression filters
+ debug 128 # debug redirects
debug 256 # debug GIF de-animation
debug 512 # Common Log Format
debug 1024 # debug kill pop-ups
@@ -1407,11 +1462,11 @@
CLASS="EMPHASIS"
>fatal</I
></SPAN
-> errors (i.e. ones which crash
+> errors (i.e. ones which causes
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->) is always on and cannot be disabled.
+> to exit) is always on and cannot be disabled.
</P
><P
> If you want to use CLF (Common Log Format), you should set <SPAN
@@ -1426,6 +1481,17 @@
></SPAN
> and not enable anything else.
</P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> has a hard-coded limit for the
+ length of log messages. If it's reached, messages are logged truncated
+ and marked with <SPAN
+CLASS="QUOTE"
+>"... [too long, truncated]"</SPAN
+>.
+ </P
></DD
></DL
></DIV
@@ -1699,8 +1765,8 @@
<SPAN
CLASS="QUOTE"
>"toggled off"</SPAN
-> mode, i.e. behave like a normal, content-neutral
- proxy where all ad blocking, filtering, etc are disabled. See
+> mode, i.e. mostly behave like a normal,
+ content-neutral proxy where all ad blocking, filtering, etc are disabled. See
<TT
CLASS="LITERAL"
>enable-remote-toggle</TT
@@ -1774,7 +1840,7 @@
> When toggled off, <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> acts like a normal,
+> mostly acts like a normal,
content-neutral proxy, i.e. it acts as if none of the actions applied to
any URL.
</P
@@ -1983,9 +2049,134 @@
><H4
CLASS="SECT3"
><A
+NAME="ENFORCE-BLOCKS"
+></A
+>7.4.6. enforce-blocks</H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Specifies:</DT
+><DD
+><P
+> Whether the user is allowed to ignore blocks and can <SPAN
+CLASS="QUOTE"
+>"go there anyway"</SPAN
+>.
+ </P
+></DD
+><DT
+>Type of value:</DT
+><DD
+><P
+> <TT
+CLASS="REPLACEABLE"
+><I
+>0 or 1</I
+></TT
+>
+ </P
+></DD
+><DT
+>Default value:</DT
+><DD
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>0</I
+></SPAN
+></P
+></DD
+><DT
+>Effect if unset:</DT
+><DD
+><P
+> Blocks are not enforced.
+ </P
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is mainly used to block and filter
+ requests as a service to the user, for example to block ads and other
+ junk that clogs the pipes. <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> configuration
+ isn't perfect and sometimes innocent pages are blocked. In this situation it
+ makes sense to allow the user to enforce the request and have
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> ignore the block.
+ </P
+><P
+> In the default configuration <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+>
+ <SPAN
+CLASS="QUOTE"
+>"Blocked"</SPAN
+> page contains a <SPAN
+CLASS="QUOTE"
+>"go there anyway"</SPAN
+>
+ link to adds a special string (the force prefix) to the request URL.
+ If that link is used, <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> will
+ detect the force prefix, remove it again and let the request pass.
+ </P
+><P
+> Of course <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> can also be used to enforce
+ a network policy. In that case the user obviously should not be able to
+ bypass any blocks, and that's what the <SPAN
+CLASS="QUOTE"
+>"enforce-blocks"</SPAN
+>
+ option is for. If it's enabled, <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> hides
+ the <SPAN
+CLASS="QUOTE"
+>"go there anyway"</SPAN
+> link. If the user adds the force
+ prefix by hand, it will not be accepted and the circumvention attempt
+ is logged.
+ </P
+></DD
+><DT
+>Examples:</DT
+><DD
+><P
+> enforce-blocks 1
+ </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
NAME="ACLS"
></A
->7.4.6. ACLs: permit-access and deny-access</H4
+>7.4.7. ACLs: permit-access and deny-access</H4
><A
NAME="PERMIT-ACCESS"
></A
@@ -2119,11 +2310,11 @@
</P
><P
> Multiple ACL lines are OK.
- If any ACLs are specified, then the <SPAN
+ If any ACLs are specified, <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->
- talks only to IP addresses that match at least one <TT
+> only talks
+ to IP addresses that match at least one <TT
CLASS="LITERAL"
>permit-access</TT
> line
@@ -2181,7 +2372,8 @@
</P
><P
> 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.
+ if the site in question is hosted on a machine which also hosts other sites
+ (most sites are).
</P
></DD
><DT
@@ -2227,7 +2419,7 @@
</P
><P
> Allow any host on the same class C subnet as www.privoxy.org access to
- nothing but www.example.com:
+ nothing but www.example.com (or other domains hosted on the same system):
</P
><P
> <TABLE
@@ -2246,7 +2438,8 @@
</P
><P
> Allow access from any host on the 26-bit subnet 192.168.45.64 to anywhere,
- with the exception that 192.168.45.73 may not access \
www.dirty-stuff.example.com: + with the exception that 192.168.45.73 may not \
access the IP address behind + www.dirty-stuff.example.com:
</P
><P
> <TABLE
@@ -2275,7 +2468,7 @@
><A
NAME="BUFFER-LIMIT"
></A
->7.4.7. buffer-limit</H4
+>7.4.8. buffer-limit</H4
><P
></P
><DIV
@@ -2365,15 +2558,25 @@
>7.5. Forwarding</H2
><P
> This feature allows routing of HTTP requests through a chain of
- multiple proxies.
- It can be used to better protect privacy and confidentiality when
- accessing specific domains by routing requests to those domains
- through an anonymous public proxy. Or to use a caching proxy to speed up browsing. \
Or chaining to a parent
- proxy may be necessary because the machine that <SPAN
+ multiple proxies.</P
+><P
+> Forwarding can be used to chain Privoxy with a caching proxy to speed
+ up browsing. Using a parent proxy may also be necessary if the machine
+ that <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
+> runs on has no direct Internet access.</P
+><P
+> Note that parent proxies can severely decrease your privacy level.
+ For example a parent proxy could add your IP address to the request
+ headers and if it's a caching proxy it may add the <SPAN
+CLASS="QUOTE"
+>"Etag"</SPAN
>
- runs on has no direct Internet access.</P
+ header to revalidation requests again, even though you configured Privoxy
+ to remove it. It may also ignore Privoxy's header time randomization and use the
+ original values which could be used by the server as cookie replacement
+ to track your steps between visits.</P
><P
> Also specified here are SOCKS proxies. <SPAN
CLASS="APPLICATION"
@@ -2504,7 +2707,7 @@
>Examples:</DT
><DD
><P
-> Everything goes to an example anonymizing proxy, except SSL on port 443 (which \
it doesn't handle): +> Everything goes to an example parent proxy, except SSL on \
port 443 (which it doesn't handle): </P
><P
> <TABLE
@@ -2515,7 +2718,7 @@
><TD
><PRE
CLASS="SCREEN"
-> forward / anon-proxy.example.org:8080
+> forward / parent-proxy.example.org:8080
forward :443 .</PRE
></TD
></TR
@@ -2569,7 +2772,7 @@
>Specifies:</DT
><DD
><P
-> Through which SOCKS proxy (and to which parent HTTP proxy) specific requests \
should be routed. +> Through which SOCKS proxy (and optionally to which parent \
HTTP proxy) specific requests should be routed. </P
></DD
><DT
@@ -3021,7 +3224,7 @@
>Effect if unset:</DT
><DD
><P
-> Forwarded connections are treated like direct connections and no retry attempts \
are made. +> Connections forwarded through other proxies are treated like direct \
connections and no retry attempts are made. </P
></DD
><DT
@@ -3034,12 +3237,22 @@
>forwarded-connect-retries</I
></TT
> is mainly interesting
- for socks4a connections, where Privoxy can't detect why the connections failed.
+ for socks4a connections, where <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> can't detect why the connections failed.
The connection might have failed because of a DNS timeout in which case a retry \
makes sense,
but it might also have failed because the server doesn't exist or isn't \
reachable. In this
case the retry will just delay the appearance of Privoxy's error message.
</P
><P
+> Note that in the context of this option, <SPAN
+CLASS="QUOTE"
+>"forwarded connections"</SPAN
+> includes all connections
+ that Privoxy forwards through other proxies. This option is not limited to the \
HTTP CONNECT method. + </P
+><P
> Only use this option, if you are getting many forwarding related error \
messages,
that go away when you try again manually. Start with a small value and check \
Privoxy's
logfile from time to time, to see how many retries are usually needed.
@@ -3055,6 +3268,189 @@
></DL
></DIV
></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
+NAME="ACCEPT-INTERCEPTED-REQUESTS"
+></A
+>7.5.5. accept-intercepted-requests</H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Specifies:</DT
+><DD
+><P
+> Whether intercepted requests should be treated as valid.
+ </P
+></DD
+><DT
+>Type of value:</DT
+><DD
+><P
+> <TT
+CLASS="REPLACEABLE"
+><I
+>0 or 1</I
+></TT
+>
+ </P
+></DD
+><DT
+>Default value:</DT
+><DD
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>0</I
+></SPAN
+></P
+></DD
+><DT
+>Effect if unset:</DT
+><DD
+><P
+> Only proxy requests are accepted, intercepted requests are treated as invalid.
+ </P
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+> If you don't trust your clients and want to force them
+ to use <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>, enable this
+ option and configure your packet filter to redirect outgoing
+ HTTP connections into <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>.
+ </P
+><P
+> Make sure that <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> own requests
+ aren't redirected as well. Additionally take care that
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> can't intentionally connect
+ to itself, otherwise you could run into redirection loops if
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> listening port is reachable
+ by the outside or an attacker has access to the pages you visit.
+ </P
+></DD
+><DT
+>Examples:</DT
+><DD
+><P
+> accept-intercepted-requests 1
+ </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
+NAME="SPLIT-LARGE-FORMS"
+></A
+>7.5.6. split-large-forms</H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Specifies:</DT
+><DD
+><P
+> Whether the CGI interface should stay compatible with broken HTTP clients.
+ </P
+></DD
+><DT
+>Type of value:</DT
+><DD
+><P
+> <TT
+CLASS="REPLACEABLE"
+><I
+>0 or 1</I
+></TT
+>
+ </P
+></DD
+><DT
+>Default value:</DT
+><DD
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>0</I
+></SPAN
+></P
+></DD
+><DT
+>Effect if unset:</DT
+><DD
+><P
+> The CGI form generate long GET URLs.
+ </P
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy's</SPAN
+> CGI forms can lead to
+ rather long URLs. This isn't a problem as far as the HTTP
+ standard is concerned, but it can confuse clients with arbitrary
+ URL lenght limitations.
+ </P
+><P
+> Enabling split-large-forms causes <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ to devide big forms into smaller ones to keep the URL length down.
+ It makes editing a lot less convenient and you can no longer
+ submit all changes at once, but at least it works around this
+ browser bug.
+ </P
+><P
+> If you don't notice any editing problems, there is no reason
+ to enable this option, but if one of the submit buttons appears
+ to be broken, you should give it a try.
+ </P
+></DD
+><DT
+>Examples:</DT
+><DD
+><P
+> split-large-forms 1
+ </P
+></DD
+></DL
+></DIV
+></DIV
></DIV
><DIV
CLASS="SECT2"
Index: configuration.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/configuration.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- configuration.html 14 Nov 2006 02:06:20 -0000 1.20
+++ configuration.html 18 Jul 2007 22:48:09 -0000 1.21
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Starting Privoxy"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -95,7 +95,7 @@
><H2
CLASS="SECT2"
><A
-NAME="AEN841"
+NAME="AEN755"
></A
>6.1. Controlling Privoxy with Your Web Browser</H2
><P
@@ -126,7 +126,7 @@
> <H2
CLASS="BRIDGEHEAD"
><A
-NAME="AEN849"
+NAME="AEN763"
></A
> Privoxy Menu</H2
><P
@@ -182,7 +182,7 @@
><TR
><TD
> ▪ <A
-HREF="http://www.privoxy.org/ 3.0.6/user-manual/"
+HREF="http://www.privoxy.org/ 3.0.7/user-manual/"
TARGET="_top"
>Documentation</A
>
Index: contact.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/contact.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- contact.html 14 Nov 2006 02:06:20 -0000 1.21
+++ contact.html 18 Jul 2007 22:48:09 -0000 1.22
@@ -8,7 +8,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Privoxy's Template Files"
@@ -40,7 +40,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
Index: copyright.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/copyright.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- copyright.html 14 Nov 2006 02:06:20 -0000 1.23
+++ copyright.html 18 Jul 2007 22:48:09 -0000 1.24
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Contacting the Developers, Bug Reporting and Feature
@@ -40,7 +40,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -99,7 +99,7 @@
><H2
CLASS="SECT2"
><A
-NAME="AEN4796"
+NAME="AEN4997"
></A
>12.1. License</H2
><P
@@ -260,6 +260,7 @@
<br>
Hal Burgiss<br>
Ian Cummings<br>
+ Justin McMurtry<br>
Roland Rosenfeld</P
><P
> Former Privoxy Team Members:</P
@@ -313,6 +314,7 @@
Jindrich Makovicka <br>
David Mediavilla <br>
Raphael Moll<br>
+ Adam Piggott<br>
Oliver Stoeneberg<br>
Martin Thomas<br>
Roberto Ragusa<br>
Index: filter-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/filter-file.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- filter-file.html 14 Nov 2006 02:06:20 -0000 1.15
+++ filter-file.html 18 Jul 2007 22:48:09 -0000 1.16
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Actions Files"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -79,14 +79,7 @@
></A
>9. Filter Files</H1
><P
-> On-the-fly text substitutions that can be invoked through the
- <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#FILTER"
->filter</A
-></TT
-> action need
+> On-the-fly text substitutions need
to be defined in a <SPAN
CLASS="QUOTE"
>"filter file"</SPAN
@@ -94,8 +87,65 @@
can then be invoked as an <SPAN
CLASS="QUOTE"
>"action"</SPAN
->. Multiple filter files can be
- defined through the <TT
+>.</P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> supports three different filter actions:
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#FILTER"
+>filter</A
+></TT
+> to
+ rewrite the content that is send to the client,
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#CLIENT-HEADER-FILTER"
+>client-header-filter</A
+></TT
+>
+ to rewrite headers that are send by the client, and
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#SERVER-HEADER-FILTER"
+>server-header-filter</A
+></TT
+>
+ to rewrite headers that are send by the server, and</P
+><P
+> <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> also supports two tagger actions:
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#CLIENT-HEADER-TAGGER"
+>client-header-tagger</A
+></TT
+>
+ and
+ <TT
+CLASS="LITERAL"
+><A
+HREF="actions-file.html#SERVER-HEADER-TAGGER"
+>server-header-tagger</A
+></TT
+>.
+ Taggers and filters use the same syntax in the filter files, the differnce
+ is that taggers don't modify the text they are filtering, but use a rewritten
+ version of the filtered text as tag. The tags can then be used to change the
+ applying actions through sections with <A
+HREF="actions-file.html#TAG-PATTERN"
+>tag-patterns</A
+>.</P
+><P
+> Multiple filter files can be defined through the <TT
CLASS="LITERAL"
> <A
HREF="config.html#FILTERFILE"
@@ -114,14 +164,14 @@
>.
</P
><P
-> Typical reasons for doing these kinds of substitutions are to eliminate
- common annoyances in HTML and JavaScript, such as pop-up windows,
+> Command tasks for content filters are to eliminate common annoyances in
+ HTML and JavaScript, such as pop-up windows,
exit consoles, crippled windows without navigation tools, the
infamous <BLINK> tag etc, to suppress images with certain
width and height attributes (standard banner sizes or web-bugs),
- or just to have fun. The possibilities are endless.</P
+ or just to have fun.</P
><P
-> Filtering works on any text-based document type, including
+> Content filtering works on any text-based document type, including
HTML, JavaScript, CSS etc. (all <TT
CLASS="LITERAL"
>text/*</TT
@@ -141,17 +191,7 @@
>"roll
your own"</SPAN
> filters, you should first be familiar with HTML syntax,
- and, of course, regular expressions. By default, filters are only applied
- to the raw document content, but can be extended to the HTTP headers with
- the supplemental actions:
- <A
-HREF="actions-file.html#FILTER-CLIENT-HEADERS"
->filter-client-headers</A
-> and
- <A
-HREF="actions-file.html#FILTER-SERVER-HEADERS"
->filter-server-headers</A
->.</P
+ and, of course, regular expressions.</P
><P
> Just like the <A
HREF="actions-file.html"
@@ -164,18 +204,25 @@
>filters</I
></SPAN
>
- here. Each filter consists of a heading line, that starts with the
+ here. Each filter consists of a heading line, that starts with one of the
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
->keyword</I
+>keywords</I
></SPAN
> <TT
CLASS="LITERAL"
>FILTER:</TT
->, followed by
- the filter's <SPAN
+>,
+ <TT
+CLASS="LITERAL"
+>CLIENT-HEADER-FILTER:</TT
+> or <TT
+CLASS="LITERAL"
+>SERVER-HEADER-FILTER:</TT
+>
+ followed by the filter's <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
@@ -235,7 +282,9 @@
>actions file</A
>.</P
><P
-> A filter header line for a filter called <SPAN
+> Filter definitions start with a header line that contains the filter
+ type, the filter name and the filter description.
+ A content filter header line for a filter called <SPAN
CLASS="QUOTE"
>"foo"</SPAN
> could look
@@ -314,14 +363,14 @@
><H2
CLASS="SECT2"
><A
-NAME="AEN4346"
+NAME="AEN4528"
></A
>9.1. Filter File Tutorial</H2
><P
> Now, let's complete our <SPAN
CLASS="QUOTE"
>"foo"</SPAN
-> filter. We have already defined
+> content filter. We have already defined
the heading, but the jobs are still missing. Since all it does is to replace
<SPAN
CLASS="QUOTE"
@@ -1414,7 +1463,7 @@
></DT
><DD
><P
-> Header filter to change the Content-Type from xml to html.
+> Server-header filter to change the Content-Type from xml to html.
</P
></DD
><DT
@@ -1427,7 +1476,7 @@
></DT
><DD
><P
-> Header filter to change the Content-Type from html to xml.
+> Server-header filter to change the Content-Type from html to xml.
</P
></DD
><DT
@@ -1457,12 +1506,81 @@
></DT
><DD
><P
-> Header filter to remove the <B
+> Client-header filter to remove the <B
CLASS="COMMAND"
>Tor</B
> exit node notation
found in Host and Referer headers.
</P
+><P
+> If <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> and <B
+CLASS="COMMAND"
+>Tor</B
+> are chained and <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ is configured to use socks4a, one can use <SPAN
+CLASS="QUOTE"
+>"http://www.example.org.foobar.exit/"</SPAN
+>
+ to access the host <SPAN
+CLASS="QUOTE"
+>"www.example.org"</SPAN
+> through the
+ <B
+CLASS="COMMAND"
+>Tor</B
+> exit node <SPAN
+CLASS="QUOTE"
+>"foobar"</SPAN
+>.
+ </P
+><P
+> As the HTTP client isn't aware of this notation, it treats the
+ whole string <SPAN
+CLASS="QUOTE"
+>"www.example.org.foobar.exit"</SPAN
+> as host and uses it
+ for the <SPAN
+CLASS="QUOTE"
+>"Host"</SPAN
+> and <SPAN
+CLASS="QUOTE"
+>"Referer"</SPAN
+> headers. From the
+ server's point of view the resulting headers are invalid and can cause problems.
+ </P
+><P
+> An invalid <SPAN
+CLASS="QUOTE"
+>"Referer"</SPAN
+> header can trigger <SPAN
+CLASS="QUOTE"
+>"hot-linking"</SPAN
+>
+ protections, an invalid <SPAN
+CLASS="QUOTE"
+>"Host"</SPAN
+> header will make it impossible for
+ the server to find the right vhost (several domains hosted on the same IP \
address). + </P
+><P
+> This client-header filter removes the <SPAN
+CLASS="QUOTE"
+>"foo.exit"</SPAN
+> part in those headers
+ to prevent the mentioned problems. Note that it only modifies
+ the HTTP headers, it doesn't make it impossible for the server
+ to detect your <B
+CLASS="COMMAND"
+>Tor</B
+> exit node based on the IP address
+ the request is coming from.
+ </P
></DD
></DL
></DIV
Index: index.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/index.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- index.html 14 Nov 2006 02:06:20 -0000 1.27
+++ index.html 18 Jul 2007 22:48:09 -0000 1.28
@@ -1,7 +1,7 @@
<HTML
><HEAD
><TITLE
->Privoxy 3.0.6 User Manual</TITLE
+>Privoxy 3.0.7 User Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
@@ -30,14 +30,14 @@
><A
NAME="AEN2"
></A
->Privoxy 3.0.6 User Manual</H1
+>Privoxy 3.0.7 User Manual</H1
><P
CLASS="PUBDATE"
> <SUB
> <A
HREF="copyright.html"
>Copyright</A
-> © 2001 - 2006 by
+> © 2001 - 2007 by
<A
HREF="http://www.privoxy.org/"
TARGET="_top"
@@ -160,7 +160,7 @@
><DT
>2.1.4. <A
HREF="installation.html#INSTALLATION-PACK-BINTGZ"
->Solaris, NetBSD, FreeBSD, HP-UX</A
+>Solaris, NetBSD, HP-UX</A
></DT
><DT
>2.1.5. <A
@@ -179,6 +179,11 @@
></DT
><DT
>2.1.8. <A
+HREF="installation.html#INSTALLATION-TBZ"
+>FreeBSD</A
+></DT
+><DT
+>2.1.9. <A
HREF="installation.html#INSTALLATTION-GENTOO"
>Gentoo</A
></DT
@@ -287,7 +292,7 @@
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN841"
+HREF="configuration.html#AEN755"
>Controlling Privoxy with Your Web Browser</A
></DT
><DT
@@ -347,31 +352,36 @@
></DT
><DT
>7.2.2. <A
+HREF="config.html#TEMPLDIR"
+>templdir</A
+></DT
+><DT
+>7.2.3. <A
HREF="config.html#LOGDIR"
>logdir</A
></DT
><DT
->7.2.3. <A
+>7.2.4. <A
HREF="config.html#ACTIONSFILE"
>actionsfile</A
></DT
><DT
->7.2.4. <A
+>7.2.5. <A
HREF="config.html#FILTERFILE"
>filterfile</A
></DT
><DT
->7.2.5. <A
+>7.2.6. <A
HREF="config.html#LOGFILE"
>logfile</A
></DT
><DT
->7.2.6. <A
+>7.2.7. <A
HREF="config.html#JARFILE"
>jarfile</A
></DT
><DT
->7.2.7. <A
+>7.2.8. <A
HREF="config.html#TRUSTFILE"
>trustfile</A
></DT
@@ -430,11 +440,16 @@
></DT
><DT
>7.4.6. <A
+HREF="config.html#ENFORCE-BLOCKS"
+>enforce-blocks</A
+></DT
+><DT
+>7.4.7. <A
HREF="config.html#ACLS"
>ACLs: permit-access and deny-access</A
></DT
><DT
->7.4.7. <A
+>7.4.8. <A
HREF="config.html#BUFFER-LIMIT"
>buffer-limit</A
></DT
@@ -467,6 +482,16 @@
HREF="config.html#FORWARDED-CONNECT-RETRIES"
>forwarded-connect-retries</A
></DT
+><DT
+>7.5.5. <A
+HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
+>accept-intercepted-requests</A
+></DT
+><DT
+>7.5.6. <A
+HREF="config.html#SPLIT-LARGE-FORMS"
+>split-large-forms</A
+></DT
></DL
></DD
><DT
@@ -485,18 +510,18 @@
><DL
><DT
>8.1. <A
-HREF="actions-file.html#AEN2102"
+HREF="actions-file.html#AEN2160"
>Finding the Right Mix</A
></DT
><DT
>8.2. <A
-HREF="actions-file.html#AEN2109"
+HREF="actions-file.html#AEN2167"
>How to Edit</A
></DT
><DT
>8.3. <A
HREF="actions-file.html#ACTIONS-APPLY"
->How Actions are Applied to URLs</A
+>How Actions are Applied to Requests</A
></DT
><DT
>8.4. <A
@@ -507,14 +532,19 @@
><DL
><DT
>8.4.1. <A
-HREF="actions-file.html#AEN2192"
+HREF="actions-file.html#AEN2250"
>The Domain Pattern</A
></DT
><DT
>8.4.2. <A
-HREF="actions-file.html#AEN2263"
+HREF="actions-file.html#AEN2321"
>The Path Pattern</A
></DT
+><DT
+>8.4.3. <A
+HREF="actions-file.html#TAG-PATTERN"
+>The Tag Pattern</A
+></DT
></DL
></DD
><DT
@@ -536,121 +566,126 @@
></DT
><DT
>8.5.3. <A
+HREF="actions-file.html#CLIENT-HEADER-FILTER"
+>client-header-filter</A
+></DT
+><DT
+>8.5.4. <A
+HREF="actions-file.html#CLIENT-HEADER-TAGGER"
+>client-header-tagger</A
+></DT
+><DT
+>8.5.5. <A
HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
>content-type-overwrite</A
></DT
><DT
->8.5.4. <A
+>8.5.6. <A
HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
>crunch-client-header</A
></DT
><DT
->8.5.5. <A
+>8.5.7. <A
HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
>crunch-if-none-match</A
></DT
><DT
->8.5.6. <A
+>8.5.8. <A
HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
>crunch-incoming-cookies</A
></DT
><DT
->8.5.7. <A
+>8.5.9. <A
HREF="actions-file.html#CRUNCH-SERVER-HEADER"
>crunch-server-header</A
></DT
><DT
->8.5.8. <A
+>8.5.10. <A
HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
>crunch-outgoing-cookies</A
></DT
><DT
->8.5.9. <A
+>8.5.11. <A
HREF="actions-file.html#DEANIMATE-GIFS"
>deanimate-gifs</A
></DT
><DT
->8.5.10. <A
+>8.5.12. <A
HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
>downgrade-http-version</A
></DT
><DT
->8.5.11. <A
+>8.5.13. <A
HREF="actions-file.html#FAST-REDIRECTS"
>fast-redirects</A
></DT
><DT
->8.5.12. <A
+>8.5.14. <A
HREF="actions-file.html#FILTER"
>filter</A
></DT
><DT
->8.5.13. <A
-HREF="actions-file.html#FILTER-CLIENT-HEADERS"
->filter-client-headers</A
-></DT
-><DT
->8.5.14. <A
-HREF="actions-file.html#FILTER-SERVER-HEADERS"
->filter-server-headers</A
-></DT
-><DT
>8.5.15. <A
HREF="actions-file.html#FORCE-TEXT-MODE"
>force-text-mode</A
></DT
><DT
>8.5.16. <A
+HREF="actions-file.html#FORWARD-OVERRIDE"
+>forward-override</A
+></DT
+><DT
+>8.5.17. <A
HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
>handle-as-empty-document</A
></DT
><DT
->8.5.17. <A
+>8.5.18. <A
HREF="actions-file.html#HANDLE-AS-IMAGE"
>handle-as-image</A
></DT
><DT
->8.5.18. <A
+>8.5.19. <A
HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
>hide-accept-language</A
></DT
><DT
->8.5.19. <A
+>8.5.20. <A
HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
>hide-content-disposition</A
></DT
><DT
->8.5.20. <A
+>8.5.21. <A
HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
>hide-if-modified-since</A
></DT
><DT
->8.5.21. <A
+>8.5.22. <A
HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
>hide-forwarded-for-headers</A
></DT
><DT
->8.5.22. <A
+>8.5.23. <A
HREF="actions-file.html#HIDE-FROM-HEADER"
>hide-from-header</A
></DT
><DT
->8.5.23. <A
+>8.5.24. <A
HREF="actions-file.html#HIDE-REFERRER"
>hide-referrer</A
></DT
><DT
->8.5.24. <A
+>8.5.25. <A
HREF="actions-file.html#HIDE-USER-AGENT"
>hide-user-agent</A
></DT
><DT
->8.5.25. <A
+>8.5.26. <A
HREF="actions-file.html#INSPECT-JPEGS"
>inspect-jpegs</A
></DT
><DT
->8.5.26. <A
+>8.5.27. <A
HREF="actions-file.html#KILL-POPUPS"
>kill-popups<A
NAME="KILL-POPUP"
@@ -658,53 +693,63 @@
></A
></DT
><DT
->8.5.27. <A
+>8.5.28. <A
HREF="actions-file.html#LIMIT-CONNECT"
>limit-connect</A
></DT
><DT
->8.5.28. <A
+>8.5.29. <A
HREF="actions-file.html#PREVENT-COMPRESSION"
>prevent-compression</A
></DT
><DT
->8.5.29. <A
+>8.5.30. <A
HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
>overwrite-last-modified</A
></DT
><DT
->8.5.30. <A
+>8.5.31. <A
HREF="actions-file.html#REDIRECT"
>redirect</A
></DT
><DT
->8.5.31. <A
+>8.5.32. <A
HREF="actions-file.html#SEND-VANILLA-WAFER"
>send-vanilla-wafer</A
></DT
><DT
->8.5.32. <A
+>8.5.33. <A
HREF="actions-file.html#SEND-WAFER"
>send-wafer</A
></DT
><DT
->8.5.33. <A
+>8.5.34. <A
+HREF="actions-file.html#SERVER-HEADER-FILTER"
+>server-header-filter</A
+></DT
+><DT
+>8.5.35. <A
+HREF="actions-file.html#SERVER-HEADER-TAGGER"
+>server-header-tagger</A
+></DT
+><DT
+>8.5.36. <A
HREF="actions-file.html#SESSION-COOKIES-ONLY"
>session-cookies-only</A
></DT
><DT
->8.5.34. <A
+>8.5.37. <A
HREF="actions-file.html#SET-IMAGE-BLOCKER"
>set-image-blocker</A
></DT
><DT
->8.5.35. <A
+>8.5.38. <A
HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
>treat-forbidden-connects-like-blocks</A
></DT
><DT
->8.5.36. <A
-HREF="actions-file.html#AEN3952"
+>8.5.39. <A
+HREF="actions-file.html#AEN4122"
>Summary</A
></DT
></DL
@@ -723,12 +768,12 @@
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN4017"
+HREF="actions-file.html#AEN4187"
>default.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN4206"
+HREF="actions-file.html#AEN4374"
>user.action</A
></DT
></DL
@@ -744,7 +789,7 @@
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN4346"
+HREF="filter-file.html#AEN4528"
>Filter File Tutorial</A
></DT
><DT
@@ -812,7 +857,7 @@
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN4796"
+HREF="copyright.html#AEN4997"
>License</A
></DT
><DT
@@ -846,7 +891,7 @@
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN5046"
+HREF="appendix.html#AEN5252"
>Privoxy's Internal Pages</A
></DT
><DD
Index: installation.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/installation.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- installation.html 14 Nov 2006 02:06:20 -0000 1.21
+++ installation.html 18 Jul 2007 22:48:10 -0000 1.22
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Introduction"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -126,7 +126,7 @@
><P
> RPMs can be installed with <TT
CLASS="LITERAL"
->rpm -Uvh privoxy-3.0.6-1.rpm</TT
+>rpm -Uvh privoxy-3.0.7-1.rpm</TT
>,
and will use <TT
CLASS="FILENAME"
@@ -157,7 +157,7 @@
> If you have problems with failed dependencies, try rebuilding the SRC RPM:
<TT
CLASS="LITERAL"
->rpm --rebuild privoxy-3.0.6-1.src.rpm</TT
+>rpm --rebuild privoxy-3.0.7-1.src.rpm</TT
>. This
will use your locally installed libraries and RPM version. </P
><P
@@ -307,7 +307,7 @@
><A
NAME="INSTALLATION-PACK-BINTGZ"
></A
->2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</H3
+>2.1.4. Solaris, NetBSD, HP-UX</H3
><P
> Create a new directory, <TT
CLASS="LITERAL"
@@ -443,9 +443,39 @@
><H3
CLASS="SECT3"
><A
+NAME="INSTALLATION-TBZ"
+></A
+>2.1.8. FreeBSD</H3
+><P
+> Privoxy is part of FreeBSD's Ports Collection, you can build and install
+ it with <TT
+CLASS="LITERAL"
+>cd /usr/ports/www/privoxy; make install clean</TT
+>.</P
+><P
+> If you don't use the ports, you can fetch and install
+ the package with <TT
+CLASS="LITERAL"
+>pkg_add -r privoxy</TT
+>.</P
+><P
+> The port skeleton and the package can also be downloaded from the
+ <A
+HREF="https://sourceforge.net/project/showfiles.php?group_id=11118"
+TARGET="_top"
+>File Release
+ Page</A
+>, but if you're interested in stable releases only you don't
+ gain anything by using them.</P
+></DIV
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
NAME="INSTALLATTION-GENTOO"
></A
->2.1.8. Gentoo</H3
+>2.1.9. Gentoo</H3
><P
> Gentoo source packages (Ebuilds) for <SPAN
CLASS="APPLICATION"
@@ -478,7 +508,7 @@
>, the
documentation is in <TT
CLASS="FILENAME"
->/usr/share/doc/privoxy-3.0.6</TT
+>/usr/share/doc/privoxy-3.0.7</TT
>
and the Log directory is in <TT
CLASS="FILENAME"
@@ -547,8 +577,8 @@
><TD
><PRE
CLASS="SCREEN"
-> tar xzvf privoxy-3.0.6-src* [.tgz or .tar.gz]
- cd privoxy-3.0.6</PRE
+> tar xzvf privoxy-3.0.7-src* [.tgz or .tar.gz]
+ cd privoxy-3.0.7</PRE
></TD
></TR
></TABLE
Index: introduction.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/introduction.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- introduction.html 14 Nov 2006 02:06:20 -0000 1.19
+++ introduction.html 18 Jul 2007 22:48:10 -0000 1.20
@@ -7,10 +7,10 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="NEXT"
TITLE="Installation"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -83,7 +83,7 @@
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->, v.3.0.6.</P
+>, v.3.0.7.</P
><DIV
CLASS="SECT2"
><H2
@@ -144,11 +144,6 @@
></LI
><LI
><P
-> HTTP/1.1 compliant (but not all optional 1.1 features are supported).
- </P
-></LI
-><LI
-><P
> Support for Perl Compatible Regular Expressions in the configuration files, and
generally a more sophisticated and flexible configuration syntax over
previous versions.
@@ -248,7 +243,7 @@
WIDTH="33%"
ALIGN="left"
VALIGN="top"
->Privoxy 3.0.6 User Manual</TD
+>Privoxy 3.0.7 User Manual</TD
><TD
WIDTH="34%"
ALIGN="center"
Index: quickstart.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/quickstart.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- quickstart.html 14 Nov 2006 02:06:20 -0000 1.19
+++ quickstart.html 18 Jul 2007 22:48:10 -0000 1.20
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="What's New in this Release"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -680,7 +680,7 @@
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN599"
+NAME="AEN513"
></A
><P
><B
Index: seealso.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/seealso.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- seealso.html 3 Oct 2006 11:13:56 -0000 1.16
+++ seealso.html 18 Jul 2007 22:48:10 -0000 1.17
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Privoxy Copyright, License and History"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -283,7 +283,7 @@
HREF="http://www.squid-cache.org/"
TARGET="_top"
>http://www.squid-cache.org/</A
->, a very popular
+>, a popular
caching proxy, which is often used together with <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
@@ -303,6 +303,34 @@
><TR
><TD
> <A
+HREF="http://www.pps.jussieu.fr/~jch/software/polipo/"
+TARGET="_top"
+>http://www.pps.jussieu.fr/~jch/software/polipo/</A
+>,
+ <SPAN
+CLASS="APPLICATION"
+>Polipo</SPAN
+> is a caching proxy with advanced features
+ like pipelining, multiplexing and caching of partial instances. In many setups
+ it can be used as <SPAN
+CLASS="APPLICATION"
+>Squid</SPAN
+> replacement.
+ </TD
+></TR
+></TBODY
+></TABLE
+><P
+></P
+>
+ <P
+></P
+><TABLE
+BORDER="0"
+><TBODY
+><TR
+><TD
+> <A
HREF="http://tor.eff.org/"
TARGET="_top"
>http://tor.eff.org/</A
Index: startup.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/startup.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- startup.html 14 Nov 2006 02:06:20 -0000 1.15
+++ startup.html 18 Jul 2007 22:48:10 -0000 1.16
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Quickstart to Using Privoxy"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -111,7 +111,7 @@
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN654"
+NAME="AEN568"
></A
><P
><B
@@ -245,7 +245,7 @@
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN698"
+NAME="AEN612"
></A
><P
><B
Index: templates.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/templates.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- templates.html 3 Oct 2006 11:13:56 -0000 1.11
+++ templates.html 18 Jul 2007 22:48:10 -0000 1.12
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Filter Files"
@@ -40,7 +40,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
Index: whatsnew.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/whatsnew.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- whatsnew.html 14 Nov 2006 02:06:20 -0000 1.6
+++ whatsnew.html 18 Jul 2007 22:48:10 -0000 1.7
@@ -7,7 +7,7 @@
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
-TITLE="Privoxy 3.0.6 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Installation"
@@ -39,7 +39,7 @@
><TH
COLSPAN="3"
ALIGN="center"
->Privoxy 3.0.6 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
></TR
><TR
><TD
@@ -81,7 +81,7 @@
><P
> There are many improvements and new features since <SPAN
CLASS="APPLICATION"
->Privoxy 3.0.3</SPAN
+>Privoxy 3.0.6</SPAN
>, the last stable release:</P
><P
> <P
@@ -89,293 +89,19 @@
><UL
><LI
><P
-> Multiple <A
-HREF="filter-file.html"
->filter files</A
-> can now be specified in <TT
-CLASS="FILENAME"
->config</TT
->. This allows for
- locally defined filters that can be maintained separately from the filters as
- supplied by the developers, i.e. <TT
-CLASS="FILENAME"
->default.filter</TT
->.
- </P
-></LI
-><LI
-><P
->
- There are a number of new <A
-HREF="actions-file.html"
->actions</A
->:
- </P
-><P
-> <P
-></P
-><UL
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
->content-type-overwrite</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
->crunch-client-header</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
->crunch-if-none-match</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#CRUNCH-SERVER-HEADER"
->crunch-server-header</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#FILTER-CLIENT-HEADERS"
->filter-client-headers</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#FILTER-SERVER-HEADERS"
->filter-server-headers</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#FORCE-TEXT-MODE"
->force-text-mode</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
->handle-as-empty-document</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
->hide-accept-language</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
->hide-content-disposition</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
->hide-if-modified-since</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#INSPECT-JPEGS"
->inspect-jpegs</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
->overwrite-last-modified</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#REDIRECT"
->redirect</A
-></TT
->
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
->treat-forbidden-connects-like-blocks</A
-></TT
->
- </P
-></LI
-></UL
->
- </P
-><P
-> In addition, <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#FAST-REDIRECTS"
->fast-redirects</A
-></TT
->
- has been significantly improved with enhanced syntax.
- </P
-><P
-> And <TT
-CLASS="LITERAL"
-><A
-HREF="actions-file.html#HIDE-REFERRER"
->hide-referrer</A
-></TT
+> Header filtering can be done with dedicated header filters now. As a result
+ the actions <SPAN
+CLASS="QUOTE"
+>"filter-client-headers"</SPAN
+> and <SPAN
+CLASS="QUOTE"
+>"filter-server-headers"</SPAN
>
- has a new option, <TT
-CLASS="LITERAL"
->conditional block</TT
->.
- </P
-></LI
-><LI
-><P
-> <SPAN
+ that were introduced with <SPAN
CLASS="APPLICATION"
->MS-Windows</SPAN
-> versions can now be
- <A
-HREF="installation.html#INSTALLATION-PACK-WIN"
->installed and
- started as a <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->Windows service</I
-></SPAN
-></A
->.
- </P
-></LI
-><LI
-><P
-> <TT
-CLASS="FILENAME"
->config</TT
-> has two new options:
- <A
-HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
->enable-remote-http-toggle</A
->,
- and <A
-HREF="config.html#FORWARDED-CONNECT-RETRIES"
->forwarded-connect-retries</A
->.
- </P
-><P
-> And there is improved handling of the <A
-HREF="config.html#USER-MANUAL"
->user-manual</A
->
- option, for placing documentation and help files on the local system.
- </P
-></LI
-><LI
-><P
-> There are six new <A
-HREF="actions-file.html#FILTER"
->filters</A
->.
- </P
-></LI
-><LI
-><P
-> Actions files problems and suggestions are now being directed to:
- <A
-HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
-TARGET="_top"
->http://sourceforge.net/tracker/?group_id=11118&atid=460288</A
->.
- Please use this to report such configuration related problems as missed
- ads, sites that don't function properly due to one action or another,
- innocent images being blocked, etc.
- </P
-></LI
-><LI
-><P
-> In addition, there are numerous bug fixes and significant enhancements,
- including error pages should no longer be cached if the problem is fixed,
- much better DNS error handling, various logging improvements, and
- configuration updates for better ad blocking and junk elimination.
+>Privoxy 3.0.5</SPAN
+> to apply
+ the content filters to the headers as, well have been removed again.
</P
></LI
></UL
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
ijbswa-commits mailing list
ijbswa-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/ijbswa-commits
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic