|
|
current/doc/webserver/user-manual actions-file.html, 1.7, 1.8 appendix.html: msg#00008web.privoxy.cvs
Update of /cvsroot/ijbswa/current/doc/webserver/user-manual In directory sc8-pr-cvs2.sourceforge.net:/tmp/cvs-serv26899/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 upgradersnote.html Log Message: Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) with what was really the latest development (the v_3_0_branch branch) Index: actions-file.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/actions-file.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- actions-file.html 5 Sep 2002 23:26:22 -0000 1.7 +++ actions-file.html 18 Jul 2006 14:48:55 -0000 1.8 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Actions Files</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" [...3324 lines suppressed...] +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ +<A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker{blank}</A +> } +/ # ALL sites</PRE +></TD +></TR +></TABLE +></P ></DIV ></DIV ></DIV Index: appendix.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/appendix.html,v retrieving revision 1.16 retrieving revision 1.17 diff -u -d -r1.16 -r1.17 --- appendix.html 5 Sep 2002 23:26:22 -0000 1.16 +++ appendix.html 18 Jul 2006 14:48:55 -0000 1.17 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Appendix</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="See Also" @@ -34,7 +34,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -66,13 +66,17 @@ ><H1 CLASS="SECT1" ><A -NAME="APPENDIX">14. Appendix</H1 +NAME="APPENDIX" +>14. Appendix</A +></H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="REGEX">14.1. Regular Expressions</H2 +NAME="REGEX" +>14.1. Regular Expressions</A +></H2 ><P > <SPAN CLASS="APPLICATION" @@ -131,17 +135,17 @@ CLASS="COMMAND" >dir</B > command in DOS. - <TT + <VAR CLASS="LITERAL" ->*.*</TT +>*.*</VAR > matches all filenames. The <SPAN CLASS="QUOTE" >"special"</SPAN > character here is the asterisk which matches any and all characters. We can be - more specific and use <TT + more specific and use <VAR CLASS="LITERAL" ->?</TT +>?</VAR > to match just individual characters. So <SPAN CLASS="QUOTE" @@ -424,9 +428,9 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" -><TT +><VAR CLASS="LITERAL" ->/.*/banners/.*</TT +>/.*/banners/.*</VAR ></I ></SPAN > - A simple example @@ -481,9 +485,9 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" -><TT +><VAR CLASS="LITERAL" ->/.*/adv((er)?ts?|ertis(ing|ements?))?/</TT +>/.*/adv((er)?ts?|ertis(ing|ements?))?/</VAR ></I ></SPAN > - @@ -605,9 +609,9 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" -><TT +><VAR CLASS="LITERAL" ->/.*/advert[0-9]+\.(gif|jpe?g)</TT +>/.*/advert[0-9]+\.(gif|jpe?g)</VAR ></I ></SPAN > - Again @@ -740,10 +744,12 @@ ><H2 CLASS="SECT2" ><A -NAME="AEN3474">14.2. <SPAN +NAME="AEN3815" +>14.2. <SPAN CLASS="APPLICATION" >Privoxy</SPAN ->'s Internal Pages</H2 +>'s Internal Pages</A +></H2 ><P > Since <SPAN CLASS="APPLICATION" @@ -787,7 +793,9 @@ Privoxy main page: </P ><A -NAME="AEN3489"><BLOCKQUOTE +NAME="AEN3830" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -818,7 +826,9 @@ editing of actions files: </P ><A -NAME="AEN3497"><BLOCKQUOTE +NAME="AEN3838" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -836,7 +846,9 @@ Show the source code version numbers: </P ><A -NAME="AEN3502"><BLOCKQUOTE +NAME="AEN3843" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -854,7 +866,9 @@ Show the browser's request headers: </P ><A -NAME="AEN3507"><BLOCKQUOTE +NAME="AEN3848" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -872,7 +886,9 @@ Show which actions apply to a URL and why: </P ><A -NAME="AEN3512"><BLOCKQUOTE +NAME="AEN3853" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -894,7 +910,9 @@ to run, but only as a pass-through proxy, with no actions taking place: </P ><A -NAME="AEN3518"><BLOCKQUOTE +NAME="AEN3859" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -909,7 +927,9 @@ > Short cuts. Turn off, then on: </P ><A -NAME="AEN3522"><BLOCKQUOTE +NAME="AEN3863" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -921,7 +941,9 @@ </P ></BLOCKQUOTE ><A -NAME="AEN3525"><BLOCKQUOTE +NAME="AEN3866" +></A +><BLOCKQUOTE CLASS="BLOCKQUOTE" ><P > @@ -942,7 +964,9 @@ ><H3 CLASS="SECT3" ><A -NAME="BOOKMARKLETS">14.2.1. Bookmarklets</H3 +NAME="BOOKMARKLETS" +>14.2.1. Bookmarklets</A +></H3 ><P > Below are some <SPAN CLASS="QUOTE" @@ -1056,7 +1080,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CHAIN">14.3. Chain of Events</H2 +NAME="CHAIN" +>14.3. Chain of Events</A +></H2 ><P > Let's take a quick look at the basic sequence of events when a web page is requested by your browser and <SPAN @@ -1280,7 +1306,9 @@ ><H2 CLASS="SECT2" ><A -NAME="ACTIONSANAT">14.4. Anatomy of an Action</H2 +NAME="ACTIONSANAT" +>14.4. Anatomy of an Action</A +></H2 ><P > The way <SPAN CLASS="APPLICATION" @@ -1791,9 +1819,9 @@ ></P ><P > Now the page displays ;-) Be sure to flush your browser's caches when - making such changes. Or, try using <TT + making such changes. Or, try using <VAR CLASS="LITERAL" ->Shift+Reload</TT +>Shift+Reload</VAR >.</P ><P > But now what about a situation where we get no explicit matches like Index: config.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/config.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -r1.6 -r1.7 --- config.html 5 Sep 2002 23:26:22 -0000 1.6 +++ config.html 18 Jul 2006 14:48:55 -0000 1.7 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >The Main Configuration File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" [...1494 lines suppressed...] ><A NAME="HIDE-CONSOLE" @@ -2998,7 +3072,7 @@ > will disconnect from and hide the command console.</P ><P -> <TT +> <VAR CLASS="LITERAL" > <P CLASS="LITERALLAYOUT" @@ -3011,7 +3085,7 @@ ><br> </P > - </TT + </VAR ></P ></DIV ></DIV Index: configuration.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/configuration.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -d -r1.12 -r1.13 --- configuration.html 5 Sep 2002 23:26:22 -0000 1.12 +++ configuration.html 18 Jul 2006 14:48:55 -0000 1.13 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Privoxy Configuration</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Starting Privoxy" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,10 +73,12 @@ ><H1 CLASS="SECT1" ><A -NAME="CONFIGURATION">6. <SPAN +NAME="CONFIGURATION" +>6. <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> Configuration</H1 +> Configuration</A +></H1 ><P > All <SPAN CLASS="APPLICATION" @@ -94,10 +96,12 @@ ><H2 CLASS="SECT2" ><A -NAME="AEN582">6.1. Controlling <SPAN +NAME="AEN585" +>6.1. Controlling <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> with Your Web Browser</H2 +> with Your Web Browser</A +></H2 ><P > <SPAN CLASS="APPLICATION" @@ -126,7 +130,9 @@ > <H2 CLASS="BRIDGEHEAD" ><A -NAME="AEN591"> Privoxy Menu</H2 +NAME="AEN594" +></A +> Privoxy Menu</H2 ><P ></P ><TABLE @@ -180,7 +186,7 @@ ><TR ><TD > ▪ <A -HREF="http://www.privoxy.org/3.1.1/user-manual/"; +HREF="http://www.privoxy.org/3.0.3/user-manual/"; TARGET="_top" >Documentation</A > @@ -244,7 +250,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CONFOVERVIEW">6.2. Configuration Files Overview</H2 +NAME="CONFOVERVIEW" +>6.2. Configuration Files Overview</A +></H2 ><P > For Unix, *BSD and Linux, all configuration files are located in <TT @@ -255,9 +263,7 @@ <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> executable. The name - and number of configuration files has changed from previous versions, and is - subject to change as development progresses.</P +> executable. </P ><P > The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, the @@ -356,7 +362,8 @@ >) can be used to re-write the raw page content, including viewable text as well as embedded HTML and JavaScript, and whatever else lurks on any given web page. The filtering jobs are only pre-defined here; - whether to apply them or not is up to the actions files. + whether to apply them or not is up to the actions files. Only one filter + file may be defined. </P ></LI ></UL @@ -364,23 +371,23 @@ ><P > All files use the <SPAN CLASS="QUOTE" ->"<TT +>"<VAR CLASS="LITERAL" ->#</TT +>#</VAR >"</SPAN > character to denote a comment (the rest of the line will be ignored) and understand line continuation - through placing a backslash ("<TT + through placing a backslash ("<VAR CLASS="LITERAL" ->\</TT +>\</VAR >") as the very last character - in a line. If the <TT + in a line. If the <VAR CLASS="LITERAL" ->#</TT +>#</VAR > is preceded by a backslash, it looses - its special function. Placing a <TT + its special function. Placing a <VAR CLASS="LITERAL" ->#</TT +>#</VAR > in front of an otherwise valid configuration line to prevent it from being interpreted is called "commenting out" that line.</P @@ -420,14 +427,6 @@ >old</I ></SPAN > listening address.</P -><P -> 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 <SPAN -CLASS="QUOTE" ->"default"</SPAN -> setting, may change, so - please check all your configuration files on important issues.</P ></DIV ></DIV ><DIV Index: contact.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/contact.html,v retrieving revision 1.14 retrieving revision 1.15 diff -u -d -r1.14 -r1.15 --- contact.html 5 Sep 2002 23:26:22 -0000 1.14 +++ contact.html 18 Jul 2006 14:48:55 -0000 1.15 @@ -1,3 +1,4 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE @@ -5,10 +6,9 @@ Requests</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Templates" @@ -38,7 +38,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -74,8 +74,10 @@ ><H1 CLASS="SECT1" ><A -NAME="CONTACT">11. Contacting the Developers, Bug Reporting and Feature -Requests</H1 +NAME="CONTACT" +>11. Contacting the Developers, Bug Reporting and Feature +Requests</A +></H1 ><P > We value your feedback. In fact, we rely on it to improve <SPAN @@ -89,13 +91,15 @@ ><H2 CLASS="SECT2" ><A -NAME="CONTACT-SUPPORT">11.1. Get Support</H2 +NAME="CONTACT-SUPPORT" +>11.1. Get Support</A +></H2 ><P -> For casual users, our support forum at +> For casual users, our <A -HREF="http://sourceforge.net/"; +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"; TARGET="_top" ->SourceForge</A +>support forum at SourceForge</A > is probably best suited: <A @@ -116,7 +120,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CONTACT-BUGS">11.2. Report Bugs</H2 +NAME="CONTACT-BUGS" +>11.2. Report Bugs</A +></H2 ><P > Please report all bugs <SPAN CLASS="emphasis" @@ -179,7 +185,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CONTACT-FEATURE">11.3. Request New Features</H2 +NAME="CONTACT-FEATURE" +>11.3. Request New Features</A +></H2 ><P > You are welcome to submit ideas on new features or other proposals for improvement through our feature request tracker at @@ -194,7 +202,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CONTACT-ADS">11.4. Report Ads or Other Actions-Related Problems</H2 +NAME="CONTACT-ADS" +>11.4. Report Ads or Other Actions-Related Problems</A +></H2 ><P > Please send feedback on ads that slipped through, innocent images that were > blocked, and any other problems relating to the <TT @@ -235,7 +245,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CONTACT-OTHER">11.5. Other</H2 +NAME="CONTACT-OTHER" +>11.5. Other</A +></H2 ><P >For any other issues, feel free to use the mailing lists. Technically >interested users and people who wish to contribute to the project are also welcome on the developers list! Index: copyright.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/copyright.html,v retrieving revision 1.15 retrieving revision 1.16 diff -u -d -r1.15 -r1.16 --- copyright.html 5 Sep 2002 23:26:22 -0000 1.15 +++ copyright.html 18 Jul 2006 14:48:55 -0000 1.16 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Privoxy Copyright, License and History</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Contacting the Developers, Bug Reporting and Feature @@ -38,7 +38,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -74,17 +74,19 @@ ><H1 CLASS="SECT1" ><A -NAME="COPYRIGHT">12. <SPAN +NAME="COPYRIGHT" +>12. <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> Copyright, License and History</H1 +> Copyright, License and History</A +></H1 ><P -> Copyright © 2001, 2002 by Privoxy Developers <TT +> Copyright © 2001 - 2004 by Privoxy Developers <CODE CLASS="EMAIL" ><<A HREF="mailto:developers@xxxxxxxxxxx"; >developers@xxxxxxxxxxx</A ->></TT +>></CODE ></P ><P > Some source code is based on code Copyright © 1997 by Anonymous Coders @@ -98,7 +100,9 @@ ><H2 CLASS="SECT2" ><A -NAME="AEN3220">12.1. License</H2 +NAME="AEN3561" +>12.1. License</A +></H2 ><P > <SPAN CLASS="APPLICATION" @@ -158,7 +162,9 @@ ><H2 CLASS="SECT2" ><A -NAME="HISTORY">12.2. History</H2 +NAME="HISTORY" +>12.2. History</A +></H2 ><P > In the beginning, there was the <A @@ -235,7 +241,7 @@ CLASS="APPLICATION" >Privoxy</SPAN >, whose first - stable release, 3.0, was released August, 2002. + stable version, 3.0, was released August, 2002. </P ></DIV ><DIV @@ -243,34 +249,42 @@ ><H2 CLASS="SECT2" ><A -NAME="AUTHORS">12.3. Authors</H2 +NAME="AUTHORS" +>12.3. Authors</A +></H2 ><P -> Current Project Developers:</P +> Current Developement Team:</P ><P CLASS="LITERALLAYOUT" -> Jon Foster<br> +> Hal Burgiss (docs)<br> Andreas Oesterhelt<br> - Stefan Waldherr<br> - <br> - Thomas Steudten<br> - Rodney Stromlund</P + David Schmidt (OS/2, Mac OSX ports)<br> + <br> </P ><P -> Current Project Contributors:</P +> Current and Former Project Contributors:</P ><P CLASS="LITERALLAYOUT" -> Rodrigo Barbosa (RPM specfiles)<br> +> Johny Agotnes <br> + Rodrigo Barbosa (RPM specfiles)<br> Moritz Barsnick<br> - Hal Burgiss (docs)<br> + Brian Dessent<br> + Mattes Dolak <br> + Jon Foster<br> Karsten Hopp (Red Hat)<br> Alexander Lazic<br> + Daniel Leite<br> Gábor Lipták<br> - Guy<br> + Adam Lock (Win32)<br> + Guy Laroche<br> Haroon Rafique<br> Roland Rosenfeld (Debian)<br> Georg Sauthoff (Gentoo)<br> - David Schmidt (OS/2, Mac OSX ports)<br> + Thomas Steudten<br> Joerg Strohmayer (Amiga)<br> - Sarantis Paskalis</P + Rodney Stromlund<br> + Sviatoslav Sviridov<br> + Sarantis Paskalis<br> + Stefan Waldherr</P ><P > Based in part on code originally developed by:</P ><P @@ -288,12 +302,14 @@ Andrew J. Caines<br> Clifford Caoile<br> Michael T. Davis<br> + Brian Dessent<br> Peter E<br> Aaron Hamid<br> Magnus Holmgren<br> - Daniel Leite<br> + Don Libes <br> Paul Lieverse<br> David Mediavilla <br> + Oliver Stoeneberg<br> Roberto Ragusa<br> Maynard Riley<br> Bart Schelstraete<br> Index: filter-file.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/filter-file.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- filter-file.html 5 Sep 2002 23:26:22 -0000 1.7 +++ filter-file.html 18 Jul 2006 14:48:55 -0000 1.8 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >The Filter File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Actions Files" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,27 +73,29 @@ ><H1 CLASS="SECT1" ><A -NAME="FILTER-FILE">9. The Filter File</H1 +NAME="FILTER-FILE" +>9. The Filter File</A +></H1 ><P > All text substitutions that can be invoked through the - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#FILTER" >filter</A -></TT +></VAR > action must first be defined in the filter file, which is typically called <TT CLASS="FILENAME" >default.filter</TT > and which can be - selected through the <TT + selected through the <VAR CLASS="LITERAL" > <A HREF="config.html#FILTERFILE" >filterfile</A -></TT +></VAR > config option.</P ><P @@ -104,17 +106,26 @@ width and height attributes (standard banner sizes or web-bugs), or just to have fun. The possibilities are endless.</P ><P -> Filtering works on any text-based document type, including plain - text, HTML, JavaScript, CSS etc. (all <TT +> Filtering works on any text-based document type, including + HTML, JavaScript, CSS etc. (all <VAR CLASS="LITERAL" ->text/*</TT +>text/*</VAR > - MIME types). Substitutions are made at the source level, so if - you want to <SPAN + MIME types, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>except</I +></SPAN +> <VAR +CLASS="LITERAL" +>text/plain</VAR +>). + Substitutions are made at the source level, so if you want to <SPAN CLASS="QUOTE" ->"roll your own"</SPAN -> filters, you should be - familiar with HTML syntax.</P +>"roll + your own"</SPAN +> filters, you should be familiar with HTML syntax.</P ><P > Just like the <A HREF="actions-file.html" @@ -134,9 +145,9 @@ CLASS="EMPHASIS" >keyword</I ></SPAN -> <TT +> <VAR CLASS="LITERAL" ->FILTER:</TT +>FILTER:</VAR >, followed by the filter's <SPAN CLASS="emphasis" @@ -174,24 +185,20 @@ user interface</A >.</P ><P -> Once a filter called <TT +> Once a filter called <VAR CLASS="REPLACEABLE" -><I ->name</I -></TT +>name</VAR > has been defined in the filter file, it can be invoked by using an action of the form - +<TT + +<VAR CLASS="LITERAL" ><A HREF="actions-file.html#FILTER" >filter</A ->{<TT +>{<VAR CLASS="REPLACEABLE" -><I ->name</I -></TT ->}</TT +>name</VAR +>}</VAR > in any <A HREF="actions-file.html" @@ -225,9 +232,9 @@ TARGET="_top" >Perl</A >'s - <TT + <VAR CLASS="LITERAL" ->s///</TT +>s///</VAR > operator. If you are familiar with Perl, you will find this to be quite intuitive, and may want to look at the <A @@ -236,9 +243,9 @@ >PCRS man page</A > for the subtle differences to Perl behaviour. Most notably, the non-standard - option letter <TT + option letter <VAR CLASS="LITERAL" ->U</TT +>U</VAR > is supported, which turns the default to ungreedy matching.</P ><P @@ -257,9 +264,9 @@ HREF="http://perldoc.com/perl5.6.1/pod/perlop.html#s-PATTERN-REPLACEMENT-egimosx"; TARGET="_top" >the - <TT + <VAR CLASS="LITERAL" ->s///</TT +>s///</VAR > operator's syntax</A > and <A HREF="http://perldoc.com/perl5.6.1/pod/perlre.html"; @@ -273,7 +280,9 @@ ><H2 CLASS="SECT2" ><A -NAME="AEN3018">9.1. Filter File Tutorial</H2 +NAME="AEN3212" +>9.1. Filter File Tutorial</A +></H2 ><P > Now, let's complete our <SPAN CLASS="QUOTE" @@ -318,9 +327,9 @@ CLASS="QUOTE" >"foo"</SPAN > on each page. For global substitution, - we'll need to add the <TT + we'll need to add the <VAR CLASS="LITERAL" ->g</TT +>g</VAR > option:</P ><P > <TABLE @@ -377,26 +386,26 @@ ></P ><P > Following the header line and a comment, you see the job. Note that it uses - <TT + <VAR CLASS="LITERAL" ->|</TT -> as the delimiter instead of <TT +>|</VAR +> as the delimiter instead of <VAR CLASS="LITERAL" ->/</TT +>/</VAR >, because the pattern contains a forward slash, which would otherwise have to be escaped - by a backslash (<TT + by a backslash (<VAR CLASS="LITERAL" ->\</TT +>\</VAR >).</P ><P -> Now, let's examine the pattern: it starts with the text <TT +> Now, let's examine the pattern: it starts with the text <VAR CLASS="LITERAL" -><script.*</TT +><script.*</VAR > - enclosed in parentheses. Since the dot matches any character, and <TT + enclosed in parentheses. Since the dot matches any character, and <VAR CLASS="LITERAL" ->*</TT +>*</VAR > means: <SPAN CLASS="QUOTE" @@ -414,9 +423,9 @@ > text, i.e. it matches the whole page, from the start of the first <script> tag.</P ><P -> That's more than we want, but the pattern continues: <TT +> That's more than we want, but the pattern continues: <VAR CLASS="LITERAL" ->document\.referrer</TT +>document\.referrer</VAR > matches only the exact string <SPAN CLASS="QUOTE" @@ -444,12 +453,12 @@ in the page (and appear in that order).</P ><P > But there's still more pattern to go. The next element, again enclosed in > parentheses, - is <TT + is <VAR CLASS="LITERAL" ->.*</script></TT ->. You already know what <TT +>.*</script></VAR +>. You already know what <VAR CLASS="LITERAL" ->.*</TT +>.*</VAR > means, so the whole pattern translates to: Match from the start of the first <script> tag in a page to the end of the last <script> tag, provided that the text @@ -460,17 +469,17 @@ ><P > This is still not the whole story, since we have ignored the options and the > parentheses: The portions of the page matched by sub-patterns that are enclosed in parentheses, will be - remembered and be available through the variables <TT + remembered and be available through the variables <VAR CLASS="LITERAL" ->$1, $2, ...</TT +>$1, $2, ...</VAR > in - the substitute. The <TT + the substitute. The <VAR CLASS="LITERAL" ->U</TT +>U</VAR > option switches to ungreedy matching, which means - that the first <TT + that the first <VAR CLASS="LITERAL" ->.*</TT +>.*</VAR > in the pattern will only <SPAN CLASS="QUOTE" >"eat up"</SPAN @@ -488,9 +497,9 @@ of <SPAN CLASS="QUOTE" >"document.referrer"</SPAN ->, and that the second <TT +>, and that the second <VAR CLASS="LITERAL" ->.*</TT +>.*</VAR > will only span the text up to the <SPAN CLASS="emphasis" @@ -502,13 +511,13 @@ CLASS="QUOTE" >"</script>"</SPAN > - tag. Furthermore, the <TT + tag. Furthermore, the <VAR CLASS="LITERAL" ->s</TT +>s</VAR > option says that the match may span - multiple lines in the page, and the <TT + multiple lines in the page, and the <VAR CLASS="LITERAL" ->g</TT +>g</VAR > option again means that the substitution is global.</P ><P @@ -521,27 +530,27 @@ <SPAN CLASS="QUOTE" >"document.referrer"</SPAN -> as <TT +> as <VAR CLASS="LITERAL" ->$1</TT +>$1</VAR >, and the part following - that string, up to and including the closing tag, as <TT + that string, up to and including the closing tag, as <VAR CLASS="LITERAL" ->$2</TT +>$2</VAR >.</P ><P > Now the pattern is deciphered, but wasn't this about substituting things? So - lets look at the substitute: <TT + lets look at the substitute: <VAR CLASS="LITERAL" ->$1"Not Your Business!"$2</TT +>$1"Not Your Business!"$2</VAR > is - easy to read: The text remembered as <TT + easy to read: The text remembered as <VAR CLASS="LITERAL" ->$1</TT +>$1</VAR >, followed by - <TT + <VAR CLASS="LITERAL" ->"Not Your Business!"</TT +>"Not Your Business!"</VAR > (<SPAN CLASS="emphasis" ><I @@ -549,27 +558,27 @@ >including</I ></SPAN > - the quotation marks!), followed by the text remembered as <TT + the quotation marks!), followed by the text remembered as <VAR CLASS="LITERAL" ->$2</TT +>$2</VAR >. This produces an exact copy of the original string, with the middle part (the <SPAN CLASS="QUOTE" >"document.referrer"</SPAN ->) replaced by <TT +>) replaced by <VAR CLASS="LITERAL" >"Not Your - Business!"</TT + Business!"</VAR >.</P ><P > The whole job now reads: Replace <SPAN CLASS="QUOTE" >"document.referrer"</SPAN > by - <TT + <VAR CLASS="LITERAL" ->"Not Your Business!"</TT +>"Not Your Business!"</VAR > wherever it appears inside a <script> tag. Note that this job won't break JavaScript syntax, since both the original and the replacement are syntactically valid @@ -595,31 +604,31 @@ ></TABLE ></P ><P -> <TT +> <VAR CLASS="LITERAL" ->\s</TT +>\s</VAR > stands for whitespace characters (space, tab, newline, - carriage return, form feed), so that <TT + carriage return, form feed), so that <VAR CLASS="LITERAL" ->\s*</TT +>\s*</VAR > means: <SPAN CLASS="QUOTE" >"zero or more whitespace"</SPAN ->. The <TT +>. The <VAR CLASS="LITERAL" ->?</TT -> in <TT +>?</VAR +> in <VAR CLASS="LITERAL" ->.*?</TT +>.*?</VAR > - makes this matching of arbitrary text ungreedy. (Note that the <TT + makes this matching of arbitrary text ungreedy. (Note that the <VAR CLASS="LITERAL" ->U</TT +>U</VAR > - option is not set). The <TT + option is not set). The <VAR CLASS="LITERAL" ->['"]</TT +>['"]</VAR > construct means: <SPAN CLASS="QUOTE" >"a single @@ -630,13 +639,13 @@ >or</I ></SPAN > a double quote"</SPAN ->. Finally, <TT +>. Finally, <VAR CLASS="LITERAL" ->\1</TT +>\1</VAR > is - a backreference to the first parenthesis just like <TT + a backreference to the first parenthesis just like <VAR CLASS="LITERAL" ->$1</TT +>$1</VAR > above, with the difference that in the <SPAN CLASS="emphasis" @@ -700,22 +709,22 @@ <SPAN CLASS="QUOTE" >"<body>"</SPAN -> tags with the dummy word <TT +> tags with the dummy word <VAR CLASS="LITERAL" ->never</TT +>never</VAR >. - Note that the <TT + Note that the <VAR CLASS="LITERAL" ->i</TT +>i</VAR > option makes the pattern matching case-insensitive. Also note that ungreedy matching alone doesn't always guarantee - a minimal match: In the first parenthesis, we had to use <TT + a minimal match: In the first parenthesis, we had to use <VAR CLASS="LITERAL" ->[^>]*</TT +>[^>]*</VAR > - instead of <TT + instead of <VAR CLASS="LITERAL" ->.*</TT +>.*</VAR > to prevent the match from exceeding the <body> tag if it doesn't contain <SPAN CLASS="QUOTE" @@ -743,9 +752,9 @@ ></TABLE ></P ><P -> Note the <TT +> Note the <VAR CLASS="LITERAL" ->(?!\.com)</TT +>(?!\.com)</VAR > part (a so-called negative lookahead) in the job's pattern, which means: Don't match, if the string <SPAN @@ -785,14 +794,494 @@ ></TABLE ></P ><P -> The <TT +> The <VAR CLASS="LITERAL" ->x</TT +>x</VAR > option in this job turns on extended syntax, and allows for e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. </P ><P > You get the idea?</P ></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="PREDEFINED-FILTERS" +>9.2. The Pre-defined Filters</A +></H2 +><P +>The distribution <TT +CLASS="FILENAME" +>default.filter</TT +> file contains a selection of +pre-defined filters for your convenience:</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>js-annoyances</I +></SPAN +></DT +><DD +><P +> The purpose of this filter is to get rid of particularly annoying JavaScript abuse. + To that end, it + <P +></P +><UL +><LI +><P +> replaces JavaScript references to the browser's referrer information + with the string "Not Your Business!". This compliments the <VAR +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-REFERRER" +>hide-referrer</A +></VAR +> action on the content level. + </P +></LI +><LI +><P +> removes the bindings to the DOM's + <A +HREF="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events-eventgroupings-htmlevents"; +TARGET="_top" +>unload + event</A +> which we feel has no right to exist and is responsible for most <SPAN +CLASS="QUOTE" +>"exit consoles"</SPAN +>, i.e. + nasty windows that pop up when you close another one. + </P +></LI +><LI +><P +> removes code that causes new windows to be opened with undesired properties, such as being + full-screen, non-resizable, without location, status or menu bar etc. + </P +></LI +></UL +> + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>js-events</I +></SPAN +></DT +><DD +><P +> This is a very radical measure. It removes virtually all JavaScript event bindings, which + means that scripts can not react to user actions such as mouse movements or clicks, window + resizing etc, anymore. + </P +><P +> We <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>strongly discourage</I +></SPAN +> using this filter as a default since it breaks + many legitimate scripts. It is meant for use only on extra-nasty sites (should you really + need to go there). + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>html-annoyances</I +></SPAN +></DT +><DD +><P +> This filter will undo many common instances of HTML based abuse. + </P +><P +> The <VAR +CLASS="LITERAL" +>BLINK</VAR +> and <VAR +CLASS="LITERAL" +>MARQUEE</VAR +> tags + are neutralized (yeah baby!), and browser windows will be created as + resizable (as of course they should be!), and will have location, + scroll and menu bars -- even if specified otherwise. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>content-cookies</I +></SPAN +></DT +><DD +><P +> Most cookies are set in the HTTP dialogue, where they can be intercepted + by the + <VAR +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></VAR +> + and <VAR +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></VAR +> + actions. But web sites increasingly make use of HTML meta tags and JavaScript + to sneak cookies to the browser on the content level. + </P +><P +> This filter disables HTML and JavaScript code that reads or sets cookies. Use + it wherever you would also use the cookie crunch actions. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>refresh tags</I +></SPAN +></DT +><DD +><P +> Disable any refresh tags if the interval is greater than nine seconds (so + that redirections done via refresh tags are not destroyed). This is useful + for dial-on-demand setups, or for those who find this HTML feature + annoying. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>unsolicited-popups</I +></SPAN +></DT +><DD +><P +> This filter attempts to prevent only <SPAN +CLASS="QUOTE" +>"unsolicited"</SPAN +> pop-up + windows from opening, yet still allow pop-up windows that the user + has explicitly chosen to open. It was added in version 3.0.1, + as an improvement over earlier such filters. + </P +><P +> Technical note: The filter works by redefining the window.open JavaScript + function to a dummy function during the loading and rendering phase of each + HTML page access, and restoring the function afterwards. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all-popups</I +></SPAN +></DT +><DD +><P +> Attempt to prevent <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> pop-up windows from opening. + Note this should be used with more discretion than the above, since it is + more likely to break some sites that require pop-ups for normal usage. Use + with caution. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>img-reorder</I +></SPAN +></DT +><DD +><P +> This is a helper filter that has no value if used alone. It makes the + <VAR +CLASS="LITERAL" +>banners-by-size</VAR +> and <VAR +CLASS="LITERAL" +>banners-by-link</VAR +> + (see below) filters more effective and should be enabled together with them. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>banners-by-size</I +></SPAN +></DT +><DD +><P +> This filter removes image tags purely based on what size they are. Fortunately + for us, many ads and banner images tend to conform to certain standardized + sizes, which makes this filter quite effective for ad stripping purposes. + </P +><P +> Occasionally this filter will cause false positives on images that are not ads, + but just happen to be of one of the standard banner sizes. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>banners-by-link</I +></SPAN +></DT +><DD +><P +> This is an experimental filter that attempts to kill any banners if + their URLs seem to point to known or suspected click trackers. It is currently + not of much value and is not recommended for use by default. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>webbugs</I +></SPAN +></DT +><DD +><P +> Webbugs are small, invisible images (technically 1X1 GIF images), that + are used to track users across websites, and collect information on them. + As an HTML page is loaded by the browser, an embedded image tag causes the + browser to contact a third-party site, disclosing the tracking information + through the requested URL and/or cookies for that third-party domain, without + the use ever becoming aware of the interaction with the third-party site. + HTML-ized spam also uses a similar technique to verify email addresses. + </P +><P +> This filter removes the HTML code that loads such <SPAN +CLASS="QUOTE" +>"webbugs"</SPAN +>. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>tiny-textforms</I +></SPAN +></DT +><DD +><P +> A rather special-purpose filter that can be used to enlarge textareas (those + multi-line text boxes in web forms) and turn off hard word wrap in them. + It was written for the sourceforge.net tracker system where such boxes are + a nuisance, but it can be handy on other sites, too. + </P +><P +> It is not recommended to use this filter as a default. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>jumping-windows</I +></SPAN +></DT +><DD +><P +> Many consider windows that move, or resize themselves to be abusive. This filter + neutralizes the related JavaScript code. Note that some sites might not display + or behave as intended when using this filter. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>frameset-borders</I +></SPAN +></DT +><DD +><P +> Some web designers seem to assume that everyone in the world will view their + web sites using the same browser brand and version, screen resolution etc, + because only that assumption could explain why they'd use static frame sizes, + yet prevent their frames from being resized by the user, should they be too + small to show their whole content. + </P +><P +> This filter removes the related HTML code. It should only be applied to sites + which need it. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>demoronizer</I +></SPAN +></DT +><DD +><P +> Many Microsoft products that generate HTML use non-standard extensions (read: + violations) of the ISO 8859-1 aka Latin-1 character set. This causes those + HTML documents to display with errors on standard-compliant platforms. + </P +><P +> This filter translates the MS-only characters into Latin-1 equivalents. + It is not necessary when using MS products, and will cause corruption of + all documents that use 8-bit character sets other than Latin-1. It's mostly + worthwhile for Europeans on non-MS platforms, if wierd garbage characters + sometimes appear on some pages. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>shockwave-flash</I +></SPAN +></DT +><DD +><P +> A filter for shockwave haters. As the name suggests, this filter strips code + out of web pages that is used to embed shockwave flash objects. + </P +><P +> </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>quicktime-kioskmode</I +></SPAN +></DT +><DD +><P +> Change HTML code that embeds Quicktime objects so that kioskmode, which + prevents saving, is disabled. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>fun</I +></SPAN +></DT +><DD +><P +> Text replacements for subversive browsing fun. Make fun of your favorite + Monopolist or play buzzword bingo. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>crude-parental</I +></SPAN +></DT +><DD +><P +> A demonstration-only filter that shows how <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + can be used to delete web content on a keyword basis. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ie-exploits</I +></SPAN +></DT +><DD +><P +> A collection of text replacements to disable malicious HTML and JavaScript + code that exploits known security holes in Internet Explorer. + </P +><P +> Presently, it only protects against Nimda and a cross-site scripting bug, and + would need active maintenance to provide more substantial protection. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>site-specifics</I +></SPAN +></DT +><DD +><P +> Some web sites have very specific problems, the cure for which doesn't apply + anywhere else, or could even cause damage on other sites. + </P +><P +> This is a collection of such site-specific cures which should only be applied + to the sites they were intended for, which is what the supplied + <TT +CLASS="FILENAME" +>default.action</TT +> file does. Users shouldn't need to change + anything regarding this filter. + </P +></DD +></DL +></DIV +></DIV ></DIV ><DIV CLASS="NAVFOOTER" Index: index.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/index.html,v retrieving revision 1.19 retrieving revision 1.20 diff -u -d -r1.19 -r1.20 --- index.html 5 Sep 2002 23:26:22 -0000 1.19 +++ index.html 18 Jul 2006 14:48:55 -0000 1.20 @@ -1,11 +1,11 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE ->Privoxy 3.1.1 User Manual</TITLE +>Privoxy 3.0.3 User Manual</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="NEXT" TITLE="Introduction" HREF="introduction.html"><LINK @@ -26,14 +26,16 @@ ><H1 CLASS="TITLE" ><A -NAME="AEN2">Privoxy 3.1.1 User Manual</H1 +NAME="AEN2" +>Privoxy 3.0.3 User Manual</A +></H1 ><P CLASS="PUBDATE" > <SUB > <A HREF="copyright.html" >Copyright</A -> © 2001, 2002 by +> © 2001 - 2004 by <A HREF="http://www.privoxy.org/"; TARGET="_top" @@ -47,9 +49,11 @@ ><DIV ><DIV CLASS="ABSTRACT" -><A -NAME="AEN9"><P +><P ></P +><A +NAME="AEN9" +></A ><P > The <I CLASS="CITETITLE" @@ -69,7 +73,7 @@ CLASS="APPLICATION" >Privoxy</SPAN > is a web proxy with advanced filtering - capabilities for protecting privacy, filtering web page content, managing + capabilities for protecting privacy, modifying web page content, managing cookies, controlling access, and removing ads, banners, pop-ups and other obnoxious Internet junk. <SPAN CLASS="APPLICATION" @@ -295,7 +299,7 @@ ><DL ><DT >6.1. <A -HREF="configuration.html#AEN582" +HREF="configuration.html#AEN585" >Controlling <SPAN CLASS="APPLICATION" >Privoxy</SPAN @@ -486,12 +490,12 @@ ><DL ><DT >8.1. <A -HREF="actions-file.html#AEN1645" +HREF="actions-file.html#AEN1753" >Finding the Right Mix</A ></DT ><DT >8.2. <A -HREF="actions-file.html#AEN1652" +HREF="actions-file.html#AEN1760" >How to Edit</A ></DT ><DT @@ -508,12 +512,12 @@ ><DL ><DT >8.4.1. <A -HREF="actions-file.html#AEN1716" +HREF="actions-file.html#AEN1833" >The Domain Pattern</A ></DT ><DT >8.4.2. <A -HREF="actions-file.html#AEN1778" +HREF="actions-file.html#AEN1895" >The Path Pattern</A ></DT ></DL @@ -630,7 +634,7 @@ ></DT ><DT >8.5.21. <A -HREF="actions-file.html#AEN2706" +HREF="actions-file.html#AEN2855" >Summary</A ></DT ></DL @@ -649,12 +653,12 @@ ><DL ><DT >8.7.1. <A -HREF="actions-file.html#AEN2758" +HREF="actions-file.html#AEN2920" >default.action</A ></DT ><DT >8.7.2. <A -HREF="actions-file.html#AEN2915" +HREF="actions-file.html#AEN3086" >user.action</A ></DT ></DL @@ -670,9 +674,14 @@ ><DL ><DT >9.1. <A -HREF="filter-file.html#AEN3018" +HREF="filter-file.html#AEN3212" >Filter File Tutorial</A ></DT +><DT +>9.2. <A +HREF="filter-file.html#PREDEFINED-FILTERS" +>The Pre-defined Filters</A +></DT ></DL ></DD ><DT @@ -727,7 +736,7 @@ ><DL ><DT >12.1. <A -HREF="copyright.html#AEN3220" +HREF="copyright.html#AEN3561" >License</A ></DT ><DT @@ -761,7 +770,7 @@ ></DT ><DT >14.2. <A -HREF="appendix.html#AEN3474" +HREF="appendix.html#AEN3815" ><SPAN CLASS="APPLICATION" >Privoxy</SPAN Index: installation.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/installation.html,v retrieving revision 1.13 retrieving revision 1.14 diff -u -d -r1.13 -r1.14 --- installation.html 5 Sep 2002 23:26:22 -0000 1.13 +++ installation.html 18 Jul 2006 14:48:55 -0000 1.14 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Installation</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Introduction" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,7 +73,9 @@ ><H1 CLASS="SECT1" ><A -NAME="INSTALLATION">2. Installation</H1 +NAME="INSTALLATION" +>2. Installation</A +></H1 ><P > <SPAN CLASS="APPLICATION" @@ -115,7 +117,9 @@ ><H2 CLASS="SECT2" ><A -NAME="INSTALLATION-PACKAGES">2.1. Binary Packages</H2 +NAME="INSTALLATION-PACKAGES" +>2.1. Binary Packages</A +></H2 ><P >How to install the binary packages depends on your operating system:</P ><DIV @@ -123,11 +127,13 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-PACK-RPM">2.1.1. Red Hat, SuSE and Conectiva RPMs</H3 +NAME="INSTALLATION-PACK-RPM" +>2.1.1. Red Hat, SuSE and Conectiva RPMs</A +></H3 ><P -> RPMs can be installed with <TT +> RPMs can be installed with <VAR CLASS="LITERAL" ->rpm -Uvh privoxy-3.1.1-1.rpm</TT +>rpm -Uvh privoxy-3.0.3-1.rpm</VAR >, and will use <TT CLASS="FILENAME" @@ -157,9 +163,9 @@ automatically start Privoxy in the boot process.</P ><P > If you have problems with failed dependencies, try rebuilding the SRC RPM: - <TT + <VAR CLASS="LITERAL" ->rpm --rebuild privoxy-3.1.1-1.src.rpm</TT +>rpm --rebuild privoxy-3.0.3-1.src.rpm</VAR >. This will use your locally installed libraries and RPM version. </P ><P @@ -182,25 +188,28 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-DEB">2.1.2. Debian</H3 +NAME="INSTALLATION-DEB" +>2.1.2. Debian</A +></H3 ><P -> DEBs can be installed with <TT +> DEBs can be installed with <VAR CLASS="LITERAL" ->dpkg -i - privoxy_3.1.1-1.deb</TT ->, and will use - <TT +>apt-get install privoxy</VAR +>, + and will use <TT CLASS="FILENAME" >/etc/privoxy</TT -> for the location of configuration - files.</P +> for the location of + configuration files.</P ></DIV ><DIV CLASS="SECT3" ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-PACK-WIN">2.1.3. Windows</H3 +NAME="INSTALLATION-PACK-WIN" +>2.1.3. Windows</A +></H3 ><P > Just double-click the installer, which will guide you through the installation process. You will find the configuration files @@ -212,11 +221,13 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-PACK-BINTGZ">2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</H3 +NAME="INSTALLATION-PACK-BINTGZ" +>2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</A +></H3 ><P -> Create a new directory, <TT +> Create a new directory, <VAR CLASS="LITERAL" ->cd</TT +>cd</VAR > to it, then unzip and untar the archive. For the most part, you'll have to figure out where things go. </P @@ -226,7 +237,9 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-OS2">2.1.5. OS/2</H3 +NAME="INSTALLATION-OS2" +>2.1.5. OS/2</A +></H3 ><P > First, make sure that no previous installations of <SPAN @@ -266,39 +279,41 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-MAC">2.1.6. Mac OSX</H3 +NAME="INSTALLATION-MAC" +>2.1.6. Mac OSX</A +></H3 ><P > Unzip the downloaded file (you can either double-click on the file from the finder, or from the desktop if you downloaded it there). Then, double-click on the package installer icon named - <TT + <VAR CLASS="LITERAL" ->Privoxy.pkg</TT +>Privoxy.pkg</VAR > and follow the installation process. <SPAN CLASS="APPLICATION" >Privoxy</SPAN > will be installed in the folder - <TT + <VAR CLASS="LITERAL" ->/Library/Privoxy</TT +>/Library/Privoxy</VAR >. It will start automatically whenever you start up. To prevent it from starting automatically, remove or rename the folder - <TT + <VAR CLASS="LITERAL" ->/Library/StartupItems/Privoxy</TT +>/Library/StartupItems/Privoxy</VAR >. </P ><P > To start Privoxy by hand, double-click on - <TT + <VAR CLASS="LITERAL" ->StartPrivoxy.command</TT +>StartPrivoxy.command</VAR > in the - <TT + <VAR CLASS="LITERAL" ->/Library/Privoxy</TT +>/Library/Privoxy</VAR > folder. Or, type this command in the Terminal:</P ><P @@ -324,7 +339,9 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATION-AMIGA">2.1.7. AmigaOS</H3 +NAME="INSTALLATION-AMIGA" +>2.1.7. AmigaOS</A +></H3 ><P > Copy and then unpack the <TT CLASS="FILENAME" @@ -342,7 +359,9 @@ ><H3 CLASS="SECT3" ><A -NAME="INSTALLATTION-GENTOO">2.1.8. Gentoo</H3 +NAME="INSTALLATTION-GENTOO" +>2.1.8. Gentoo</A +></H3 ><P > Gentoo source packages (Ebuilds) for <SPAN CLASS="APPLICATION" @@ -359,13 +378,13 @@ CLASS="APPLICATION" >Privoxy</SPAN > under Gentoo just do - first <TT + first <VAR CLASS="LITERAL" ->emerge rsync</TT +>emerge rsync</VAR > to get the latest changes from the - Portage tree. With <TT + Portage tree. With <VAR CLASS="LITERAL" ->emerge privoxy</TT +>emerge privoxy</VAR > you install the latest version.</P ><P @@ -375,7 +394,7 @@ >, the documentation is in <TT CLASS="FILENAME" ->/usr/share/doc/privoxy-3.1.1</TT +>/usr/share/doc/privoxy-3.0.3</TT > and the Log directory is in <TT CLASS="FILENAME" @@ -388,7 +407,9 @@ ><H2 CLASS="SECT2" ><A -NAME="INSTALLATION-SOURCE">2.2. Building from Source</H2 +NAME="INSTALLATION-SOURCE" +>2.2. Building from Source</A +></H2 ><P > The most convenient way to obtain the <SPAN CLASS="APPLICATION" @@ -409,7 +430,7 @@ >the CVS repository</A > or simply download <A -HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"; +HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.bz2"; TARGET="_top" >the nightly CVS tarball.</A @@ -437,7 +458,7 @@ ><P > When building from a source tarball (either release version or <A -HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"; +HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.bz2"; TARGET="_top" >nightly CVS tarball</A @@ -451,8 +472,8 @@ ><TD ><PRE CLASS="SCREEN" -> tar xzvf privoxy-3.1.1-beta-src* [.tgz or .tar.gz] - cd privoxy-3.1.1-beta</PRE +> tar xzvf privoxy-3.0.3-src* [.tgz or .tar.gz] + cd privoxy-3.0.3</PRE ></TD ></TR ></TABLE @@ -505,37 +526,6 @@ ></TR ></TABLE ></P -><DIV -CLASS="WARNING" -><P -></P -><TABLE -CLASS="WARNING" -BORDER="1" -WIDTH="100%" -><TR -><TD -ALIGN="CENTER" -><B ->Warning</B -></TD -></TR -><TR -><TD -ALIGN="LEFT" -><P -> - The <SPAN -CLASS="QUOTE" ->"make install"</SPAN -> target is temporary quite broken! It is - recommended to use a binary package, or do a source build, and manually - install the components. Sorry. - </P -></TD -></TR -></TABLE -></DIV ><P > If you have gnu make, you can have the first four steps automatically done for you by just typing:</P @@ -569,7 +559,9 @@ ><H2 CLASS="SECT2" ><A -NAME="INSTALLATION-KEEPUPDATED">2.3. Keeping your Installation Up-to-Date</H2 +NAME="INSTALLATION-KEEPUPDATED" +>2.3. Keeping your Installation Up-to-Date</A +></H2 ><P > As user feedback comes in and development continues, we will make updated > versions of both the main <A @@ -595,9 +587,9 @@ >, ijbswa-announce@xxxxxxxxxxxxxxxxxxxxxx</P ><P > In order not to loose your personal changes and adjustments when updating - to the latest <TT + to the latest <VAR CLASS="LITERAL" ->default.action</TT +>default.action</VAR > file we <SPAN CLASS="emphasis" ><I @@ -605,9 +597,9 @@ >strongly recommend</I ></SPAN -> that you use <TT +> that you use <VAR CLASS="LITERAL" ->user.action</TT +>user.action</VAR > for your customization of <SPAN CLASS="APPLICATION" Index: introduction.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/introduction.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -d -r1.12 -r1.13 --- introduction.html 5 Sep 2002 23:26:22 -0000 1.12 +++ introduction.html 18 Jul 2006 14:48:55 -0000 1.13 @@ -1,16 +1,16 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Introduction</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="NEXT" TITLE="Installation" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,39 +73,23 @@ ><H1 CLASS="SECT1" ><A -NAME="INTRODUCTION">1. Introduction</H1 +NAME="INTRODUCTION" +>1. Introduction</A +></H1 ><P -> This documentation is included with the current alpha version of +> This documentation is included with the current stable version of <SPAN CLASS="APPLICATION" >Privoxy</SPAN ->, v.3.1.1, - 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 version 3.0 is currently nearing - completion, and includes many significant changes and enhancements over - earlier versions. The target release date for - stable v3.0 is <SPAN -CLASS="QUOTE" ->"soon"</SPAN -> ;-).</P -><P -> Since this is a alpha 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 <SPAN -CLASS="emphasis" -><I -CLASS="EMPHASIS" ->may be</I -></SPAN -> bugs, though hopefully - not many! </P +>, v.3.0.3.</P ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="FEATURES">1.1. Features</H2 +NAME="FEATURES" +>1.1. Features</A +></H2 ><P > In addition to <SPAN CLASS="APPLICATION" @@ -115,8 +99,7 @@ <SPAN CLASS="APPLICATION" >Privoxy</SPAN -> provides new features, - some of them currently under development:</P +> provides new features:</P ><P > <P ></P @@ -258,7 +241,7 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ->Privoxy 3.1.1 User Manual</TD +>Privoxy 3.0.3 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.11 retrieving revision 1.12 diff -u -d -r1.11 -r1.12 --- quickstart.html 5 Sep 2002 23:26:22 -0000 1.11 +++ quickstart.html 18 Jul 2006 14:48:55 -0000 1.12 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Quickstart to Using Privoxy</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Note to Upgraders" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,9 +73,11 @@ ><H1 CLASS="SECT1" ><A -NAME="QUICKSTART">4. Quickstart to Using <SPAN +NAME="QUICKSTART" +>4. Quickstart to Using <SPAN CLASS="APPLICATION" >Privoxy</SPAN +></A ></H1 ><P > <P @@ -140,13 +142,13 @@ CLASS="APPLICATION" >Privoxy</SPAN > as HTTP and - HTTPS proxy by setting the proxy configuration for address of - <TT + HTTPS (SSL) proxy by setting the proxy configuration for address of + <VAR CLASS="LITERAL" ->127.0.0.1</TT -> and port <TT +>127.0.0.1</VAR +> and port <VAR CLASS="LITERAL" ->8118</TT +>8118</VAR >. (<SPAN CLASS="APPLICATION" @@ -168,6 +170,11 @@ ><LI ><P > Flush your browser's disk and memory caches, to remove any cached ad > images. + If using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to manage cookies, you should + remove any currently stored cookies too. </P ></LI ><LI @@ -183,8 +190,7 @@ >Configuration section</A > for more configuration options, and how to customize your installation. - - </P + </P ></LI ><LI ><P @@ -222,6 +228,16 @@ ></LI ><LI ><P +> For easy access to Privoxy's most important controls, drag the provided + <A +HREF="appendix.html#BOOKMARKLETS" +>Bookmarklets</A +> into your browser's + personal toolbar. + </P +></LI +><LI +><P > Please see the section <A HREF="contact.html" >Contacting the @@ -242,7 +258,9 @@ ><H2 CLASS="SECT2" ><A -NAME="QUICKSTART-AD-BLOCKING">4.1. Quickstart to Ad Blocking</H2 +NAME="QUICKSTART-AD-BLOCKING" +>4.1. Quickstart to Ad Blocking</A +></H2 ><P > Ad blocking is but one of <SPAN CLASS="APPLICATION" @@ -351,25 +369,25 @@ or a server somewhere else on the Internet. Complex web pages will have many such embedded URLs.</P ><P -> The actions we need to know about for ad blocking are: <TT +> The actions we need to know about for ad blocking are: <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT ->, <TT +></VAR +>, <VAR CLASS="LITERAL" ><A HREF="actions-file.html#HANDLE-AS-IMAGE" >handle-as-image</A -></TT +></VAR >, and - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#SET-IMAGE-BLOCKER" >set-image-blocker</A -></TT +></VAR >:</P ><P > <P @@ -377,12 +395,12 @@ ><UL ><LI ><P -> <TT +> <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT +></VAR > - this action stops any contact between your browser and any URL patterns that match this action's configuration. It can be used for blocking ads, but also anything @@ -396,12 +414,12 @@ ></LI ><LI ><P -> <TT +> <VAR CLASS="LITERAL" ><A HREF="actions-file.html#HANDLE-AS-IMAGE" >handle-as-image</A -></TT +></VAR > - tells <SPAN CLASS="APPLICATION" @@ -429,24 +447,24 @@ ></LI ><LI ><P -> <TT +> <VAR CLASS="LITERAL" ><A HREF="actions-file.html#SET-IMAGE-BLOCKER" >set-image-blocker</A -></TT +></VAR > - tells <SPAN CLASS="APPLICATION" >Privoxy</SPAN > what to display in place of an ad image that has hit a block rule. For this to come into play, the URL must match a - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT +></VAR > action somewhere in the configuration, <SPAN CLASS="emphasis" @@ -455,12 +473,12 @@ >and</I ></SPAN >, it must also match an - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#HANDLE-AS-IMAGE" >handle-as-image</A -></TT +></VAR > action. </P ><P @@ -623,7 +641,9 @@ > <DIV CLASS="FIGURE" ><A -NAME="AEN391"><P +NAME="AEN389" +></A +><P ><B >Figure 1. Actions Files in Use</B ></P @@ -640,12 +660,12 @@ ><LI ><P > You should have a section with only - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT +></VAR > listed under <SPAN CLASS="QUOTE" @@ -667,12 +687,12 @@ >"Actions:"</SPAN >. This will bring up a list of all actions. Find - <TT + <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT +></VAR > near the top, and click in the <SPAN CLASS="QUOTE" @@ -689,12 +709,12 @@ ></LI ><LI ><P -> Now, in the <TT +> Now, in the <VAR CLASS="LITERAL" ><A HREF="actions-file.html#BLOCK" >block</A -></TT +></VAR > actions section, click the <SPAN CLASS="QUOTE" @@ -710,9 +730,9 @@ >Copy Link Location</SPAN >"</SPAN >. - Remove the <TT + Remove the <VAR CLASS="LITERAL" ->http://</TT +>http://</VAR > at the beginning of the URL. Then, click <SPAN CLASS="QUOTE" Index: seealso.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/seealso.html,v retrieving revision 1.11 retrieving revision 1.12 diff -u -d -r1.11 -r1.12 --- seealso.html 5 Sep 2002 23:26:22 -0000 1.11 +++ seealso.html 18 Jul 2006 14:48:55 -0000 1.12 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >See Also</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Privoxy Copyright, License and History" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,7 +73,9 @@ ><H1 CLASS="SECT1" ><A -NAME="SEEALSO">13. See Also</H1 +NAME="SEEALSO" +>13. See Also</A +></H1 ><P > Other references and sites of interest to <SPAN CLASS="APPLICATION" Index: startup.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/startup.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- startup.html 5 Sep 2002 23:26:22 -0000 1.7 +++ startup.html 18 Jul 2006 14:48:55 -0000 1.8 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Starting Privoxy</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Quickstart to Using Privoxy" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,9 +73,11 @@ ><H1 CLASS="SECT1" ><A -NAME="STARTUP">5. Starting <SPAN +NAME="STARTUP" +>5. Starting <SPAN CLASS="APPLICATION" >Privoxy</SPAN +></A ></H1 ><P > Before launching <SPAN @@ -99,7 +101,9 @@ > <DIV CLASS="FIGURE" ><A -NAME="AEN442"><P +NAME="AEN440" +></A +><P ><B >Figure 2. Proxy Configuration (Mozilla)</B ></P @@ -212,7 +216,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-REDHAT">5.1. Red Hat and Conectiva</H2 +NAME="START-REDHAT" +>5.1. Red Hat and Conectiva</A +></H2 ><P > We use a script. Note that Red Hat does not start Privoxy upon booting per default. It will use the file <TT @@ -240,7 +246,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-DEBIAN">5.2. Debian</H2 +NAME="START-DEBIAN" +>5.2. Debian</A +></H2 ><P > We use a script. Note that Debian starts Privoxy upon booting per default. It will use the file @@ -269,7 +277,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-SUSE">5.3. SuSE</H2 +NAME="START-SUSE" +>5.3. SuSE</A +></H2 ><P >We use a script. It will use the file <TT CLASS="FILENAME" @@ -297,7 +307,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-WINDOWS">5.4. Windows</H2 +NAME="START-WINDOWS" +>5.4. Windows</A +></H2 ><P >Click on the Privoxy Icon to start Privoxy. If no configuration file is specified on the command line, <SPAN @@ -315,7 +327,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-UNICES">5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</H2 +NAME="START-UNICES" +>5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</A +></H2 ><P >Example Unix startup command:</P ><P @@ -338,7 +352,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-OS2">5.6. OS/2</H2 +NAME="START-OS2" +>5.6. OS/2</A +></H2 ><P > During installation, <SPAN CLASS="APPLICATION" @@ -359,20 +375,22 @@ ><H2 CLASS="SECT2" ><A -NAME="START-MACOSX">5.7. Mac OSX</H2 +NAME="START-MACOSX" +>5.7. Mac OSX</A +></H2 ><P > During installation, <SPAN CLASS="APPLICATION" >Privoxy</SPAN > is configured to start automatically when the system restarts. To start Privoxy by hand, - double-click on the <TT + double-click on the <VAR CLASS="LITERAL" ->StartPrivoxy.command</TT +>StartPrivoxy.command</VAR > icon in the - <TT + <VAR CLASS="LITERAL" ->/Library/Privoxy</TT +>/Library/Privoxy</VAR > folder. Or, type this command in the Terminal:</P ><P @@ -398,7 +416,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-AMIGAOS">5.8. AmigaOS</H2 +NAME="START-AMIGAOS" +>5.8. AmigaOS</A +></H2 ><P > Start <SPAN CLASS="APPLICATION" @@ -428,7 +448,9 @@ ><H2 CLASS="SECT2" ><A -NAME="START-GENTOO">5.9. Gentoo</H2 +NAME="START-GENTOO" +>5.9. Gentoo</A +></H2 ><P > A script is again used. It will use the file <TT CLASS="FILENAME" @@ -455,9 +477,9 @@ CLASS="APPLICATION" >Privoxy</SPAN > is not automatically started at - boot time by default. You can change this with the <TT + boot time by default. You can change this with the <VAR CLASS="LITERAL" ->rc-update</TT +>rc-update</VAR > command.</P ><P @@ -482,7 +504,9 @@ ><H2 CLASS="SECT2" ><A -NAME="CMDOPTIONS">5.10. Command Line Options</H2 +NAME="CMDOPTIONS" +>5.10. Command Line Options</A +></H2 ><P > <SPAN CLASS="APPLICATION" @@ -603,6 +627,31 @@ ></LI ><LI ><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--chroot</I +></SPAN +> + + </P +><P +> Before changing to the user ID given in the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--user</I +></SPAN +> option, + chroot to that user's home directory, i.e. make the kernel pretend to the Privoxy + process that the directory tree starts there. If set up carefully, this can limit + the impact of possible vulnerabilities in Privoxy to the files contained in that hierarchy. + Unix only. + </P +></LI +><LI +><P > <SPAN CLASS="emphasis" ><I Index: templates.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/templates.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -r1.6 -r1.7 --- templates.html 5 Sep 2002 23:26:22 -0000 1.6 +++ templates.html 18 Jul 2006 14:48:55 -0000 1.7 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Templates</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="The Filter File" @@ -38,7 +38,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -74,7 +74,9 @@ ><H1 CLASS="SECT1" ><A -NAME="TEMPLATES">10. Templates</H1 +NAME="TEMPLATES" +>10. Templates</A +></H1 ><P > All <SPAN CLASS="APPLICATION" @@ -146,15 +148,15 @@ >Not recommended for the casual user</I ></SPAN >). Note that - just like in configuration files, lines starting with <TT + just like in configuration files, lines starting with <VAR CLASS="LITERAL" ->#</TT +>#</VAR > are ignored when the templates are filled in.</P ><P -> The place-holders are of the form <TT +> The place-holders are of the form <VAR CLASS="LITERAL" ->@name@</TT +>@name@</VAR >, and you will find a list of available symbols, which vary from template to template, in the comments at the start of each file. Note that these comments are not @@ -189,12 +191,12 @@ ></P ><P > If the "unstable" symbol is set, everything in between and including - <TT + <VAR CLASS="LITERAL" ->@if-unstable-start</TT -> and <TT +>@if-unstable-start</VAR +> and <VAR CLASS="LITERAL" ->if-unstable-end@</TT +>if-unstable-end@</VAR > will disappear, leaving nothing but an empty comment:</P ><P @@ -212,9 +214,9 @@ ></TABLE ></P ><P -> There's also an if-then-else construct and an <TT +> There's also an if-then-else construct and an <VAR CLASS="LITERAL" ->#include</TT +>#include</VAR > mechanism, but you'll sure find out if you are inclined to edit the templates ;-)</P @@ -223,9 +225,9 @@ <A HREF="http://config.privoxy.org/send-stylesheet"; TARGET="_top" -><TT +><VAR CLASS="LITERAL" ->http://config.privoxy.org/send-stylesheet</TT +>http://config.privoxy.org/send-stylesheet</VAR ></A >. This is, of course, locally served by <SPAN Index: upgradersnote.html =================================================================== RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/upgradersnote.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- upgradersnote.html 5 Sep 2002 23:26:22 -0000 1.7 +++ upgradersnote.html 18 Jul 2006 14:48:55 -0000 1.8 @@ -1,13 +1,13 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML ><HEAD ><TITLE >Note to Upgraders</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" -TITLE="Privoxy 3.1.1 User Manual" +TITLE="Privoxy 3.0.3 User Manual" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Installation" @@ -37,7 +37,7 @@ ><TH COLSPAN="3" ALIGN="center" ->Privoxy 3.1.1 User Manual</TH +>Privoxy 3.0.3 User Manual</TH ></TR ><TR ><TD @@ -73,7 +73,9 @@ ><H1 CLASS="SECT1" ><A -NAME="UPGRADERSNOTE">3. Note to Upgraders</H1 +NAME="UPGRADERSNOTE" +>3. Note to Upgraders</A +></H1 ><P > There are very significant changes from earlier <SPAN ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys -- and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV_______________________________________________ ijbswa-commits mailing list ijbswa-commits@xxxxxxxxxxxxxxxxxxxxx https://lists.sourceforge.net/lists/listinfo/ijbswa-commits |
|
| <Prev in Thread] | Current Thread | [Next in Thread> |
|---|---|---|
| Previous by Date: | current/doc/webserver/actions index.php, 1.26, 1.27 step3.php, 1.17, 1.18: 00008, noreply |
|---|---|
| Next by Date: | current/pcre vc_dftables.dsp, 1.8, 1.9 config.h, 1.4, 1.5: 00008, noreply |
| Previous by Thread: | current/doc/webserver/actions index.php, 1.26, 1.27 step3.php, 1.17, 1.18i: 00008, noreply |
| Next by Thread: | current/pcre vc_dftables.dsp, 1.8, 1.9 config.h, 1.4, 1.5: 00008, noreply |
| Indexes: | [Date] [Thread] [Top] [All Lists] |
| News | FAQ | advertise |