From 2a175c54f8556e7408c19fb215560a99de99e54f Mon Sep 17 00:00:00 2001 From: hal9 Date: Wed, 30 Aug 2006 11:16:44 +0000 Subject: [PATCH] Syncing with recent sgml updates. --- doc/webserver/user-manual/actions-file.html | 315 ++++++++++++++++--- doc/webserver/user-manual/appendix.html | 18 +- doc/webserver/user-manual/configuration.html | 4 +- doc/webserver/user-manual/copyright.html | 10 +- doc/webserver/user-manual/filter-file.html | 65 ++-- doc/webserver/user-manual/index.html | 78 +++-- doc/webserver/user-manual/installation.html | 4 +- doc/webserver/user-manual/quickstart.html | 2 +- doc/webserver/user-manual/startup.html | 2 +- doc/webserver/user-manual/whatsnew.html | 80 ++++- 10 files changed, 429 insertions(+), 149 deletions(-) diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index 64c5b9b3..844df3a3 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -156,7 +156,7 @@ CLASS="FILENAME" >

8.1. Finding the Right Mix

8.2. How to Edit

8.4.1. The Domain Pattern

8.4.2. The Path Pattern

filter-server-headers @@ -1835,7 +1835,7 @@ CLASS="SECT3" >8.5.4. crunch-server-header8.5.4. crunch-client-header

filter-client-headers @@ -2280,7 +2280,7 @@ CLASS="LITERAL" filter-server-headers @@ -2746,7 +2746,7 @@ CLASS="QUOTE" requests with filter-client-headers @@ -2842,7 +2842,8 @@ CLASS="VARIABLELIST" CLASS="LITERAL" >text/plain MIME type for all files whose type they - don't know.) + don't know.) By default, filtering works only on the document content + itself, not the headers.

8.5.13. filter-client-headers

Typical use:

To apply filtering to the client's (browser's) headers +

Effect:

Extend filtering capabilities to the client's headers, which + by default applies only to the document itself. +

Type:

Boolean.

Parameter:

N/A +

Notes:

Regular expressions can be used to filter headers as well. Check your + filters closely before activating this action, as it can easily lead to broken + requests. +

+ These filters are applied to each header on its own, not to them + all at once. This makes it easier to diagnose problems, but on the downside + you can't write filters that only change header x if header y's value is + z. +

The filters are used after the other header actions have finished and can + use their output as input. +

Whenever possible one should specify ^, + $, the whole header name and the colon, to make sure + the filter doesn't cause havoc to other headers or the + page itself. For example if you want to transform + Galeon User-Agents to + Firefox User-Agents you + shouldn't use:

s@Galeon/\d\.\d\.\d @@

but:

s@^(User-Agent:.*) Galeon/\d\.\d\.\d (Firefox/\d\.\d\.\d\.\d)$@$1 $2@

Example usage (section):

{+filter-client-headers +filter{test_filter}}
+problem-host.example.com
+
+

8.5.14. filter-server-headers

Typical use:

To apply filtering to the server's headers +

Effect:

Extend filtering capabilities to the server's headers, which + by default applies only to the document itself. +

Type:

Boolean.

Parameter:

N/A +

Notes:

Similar to filter-client-headers, but works on + the server instead. To filter both server and client, use both. +

As with filter-client-headers, check your + filters before activating this action, as it can easily lead to broken + requests. +

+ These filters are applied to each header on its own, not to them + all at once. This makes it easier to diagnose problems, but on the downside + you can't write filters that only change header x if header y's value is + z. +

The filters are used after the other header actions have finished and can + use their output as input. +

Remember too, whenever possible one should specify ^, + $, the whole header name and the colon, to make sure + the filter doesn't cause havoc to other headers or the + page itself. See above for example. +

Example usage (section):

{+filter-server-headers +filter{test_filter}}
+problem-host.example.com
+
+

8.5.13. force-text-mode

8.5.15. force-text-mode

8.5.14. handle-as-empty-document8.5.16. handle-as-empty-document

8.5.15. handle-as-image8.5.17. handle-as-image

8.5.16. hide-accept-language8.5.18. hide-accept-language

8.5.17. hide-content-disposition8.5.19. hide-content-disposition

8.5.18. hide-if-modified-since8.5.20. hide-if-modified-since

8.5.19. hide-forwarded-for-headers8.5.21. hide-forwarded-for-headers

8.5.20. hide-from-header8.5.22. hide-from-header

8.5.21. hide-referrer8.5.23. hide-referrer8.5.22. hide-user-agent8.5.24. hide-user-agent

8.5.23. inspect-jpegs8.5.25. inspect-jpegs

8.5.24. kill-popups8.5.26. kill-popups8.5.25. limit-connect8.5.27. limit-connect

8.5.26. prevent-compression8.5.28. prevent-compression

8.5.27. overwrite-last-modified8.5.29. overwrite-last-modified

8.5.28. redirect8.5.30. redirect

8.5.29. send-vanilla-wafer8.5.31. send-vanilla-wafer

8.5.30. send-wafer8.5.32. send-wafer

8.5.31. session-cookies-only8.5.33. session-cookies-only

8.5.32. set-image-blocker8.5.34. set-image-blocker

8.5.33. treat-forbidden-connects-like-blocks8.5.35. treat-forbidden-connects-like-blocks

8.5.34. Summary

8.5.36. Summary

Note that many of these actions have the potential to cause a page to misbehave, possibly even not to display at all. There are many ways @@ -6402,7 +6645,7 @@ CLASS="SECT3" >

8.7.1. default.action

8.7.2. user.action

14.2.
Short cuts. Turn off, then on:

6.1. Controlling

    Privoxy Menu

12.1. License

Current Developement Team:

 David Schmidt
- Fabian Keil
+> Fabian Keil
+ David Schmidt

Current Contributors:

- Hal Burgiss
 Johny Agotnes 
 Moritz Barsnick
+ Hal Burgiss
 Mattes Dolak 
 Roland Rosenfeld

>

 
- Andreas Oesterhelt
 Rodrigo Barbosa
 Brian Dessent
 Jon Foster
@@ -281,6 +280,7 @@ CLASS="LITERALLAYOUT"  Gábor Lipták
 Adam Lock
 Guy Laroche
+ Andreas Oesterhelt
 Haroon Rafique
 Georg Sauthoff
 Thomas Steudten
diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index 99edd6cd..6a1b5201 100644 --- a/doc/webserver/user-manual/filter-file.html +++ b/doc/webserver/user-manual/filter-file.html @@ -77,21 +77,21 @@ NAME="FILTER-FILE" >9. Filter Files

All text substitutions that can be invoked through the +> On-the-fly text substitutions that can be invoked through the filter action which - must first be defined in a action need + to be defined in a "filter file", such as - default.filter. Once defined, they + can then be invoked as an "action". Mulitple filter files can be defined through the filterfile config - option. The filters as supplied by the developers will be found in +> config directive. The filters + as supplied by the developers will be found in default.filter. It is recommended that any locally - defined or modified filters go in a separately defined file such as + defined or modified filters go in a separately defined file such as user.filter"roll your own" filters, you should be familiar with HTML syntax.

filters, you should first be familiar with HTML syntax, + and, of course, regular expressions. By default, filters are only applied + to the document content, but can be extended to the headers with + the supplemental actions: + filter-client-headers and + filter-server-headers.

Just like the

9.1. Filter File Tutorial

filter-server-headers

filter-client-headers


$Id: user-manual.sgml,v 2.13 2006/08/22 11:04:59 hal9 Exp $

$Id: user-manual.sgml,v 2.14 2006/08/29 10:59:36 hal9 Exp $

6.1. Controlling Privoxy
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.4. crunch-server-headercrunch-client-header
8.5.5.
8.5.13. filter-client-headers
8.5.14. filter-server-headers
8.5.15. force-text-mode
8.5.14. 8.5.16. handle-as-empty-document
8.5.15. 8.5.17. handle-as-image
8.5.16. 8.5.18. hide-accept-language
8.5.17. 8.5.19. hide-content-disposition
8.5.18. 8.5.20. hide-if-modified-since
8.5.19. 8.5.21. hide-forwarded-for-headers
8.5.20. 8.5.22. hide-from-header
8.5.21. 8.5.23. hide-referrer
8.5.22. 8.5.24. hide-user-agent
8.5.23. 8.5.25. inspect-jpegs
8.5.24. 8.5.26. kill-popups
8.5.25. 8.5.27. limit-connect
8.5.26. 8.5.28. prevent-compression
8.5.27. 8.5.29. overwrite-last-modified
8.5.28. 8.5.30. redirect
8.5.29. 8.5.31. send-vanilla-wafer
8.5.30. 8.5.32. send-wafer
8.5.31. 8.5.33. session-cookies-only
8.5.32. 8.5.34. set-image-blocker
8.5.33. 8.5.35. treat-forbidden-connects-like-blocks
8.5.34. 8.5.36. Summary
8.7.1. default.action
8.7.2. user.action
9.1. Filter File Tutorial
12.1. License
14.2. Privoxygcc are required.

When building from a source tarball (either release version or - a nightly CVS tarball, first unpack the source:

When building from a source tarball, + first unpack the source:

3. What's New in this Release

There are many new features in There are many improvements and new features in Privoxy 3.0.4 @@ -94,7 +94,9 @@ HREF="filter-file.html" > can now be specifed in config. +>. This allows for + locally defined filters that can be maintained separately from the filters as + supplied by the developers.

  • fast-redirectsfilter-client-headers +

  • filter-server-headers

    hide-referrer -

  • inspect-jpegs

    In addition, fast-redirects + has been significantly improved with enhanced syntax. +

    And hide-referrer + has a new option, conditional block. +

  • In addition, there are various bug fixes and enhancements, including - error pages are no longer cached, better DNS error handling, and logging +> In addition, there are various bug fixes and significant enhancements, including + error pages are no longer cached, better DNS error handling, and various logging improvements.

  • See the full documentation on + fast-redirects + which has changed syntax, and may require adjustments to local configs. +

  • The jarfile, cookie logger, is off by default now. +

  • What constitutes a