Submit new version of manual so some of Fabians work has some documentation.
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
index b501f16..dd7d25f 100644 (file)
@@ -7,7 +7,7 @@ NAME="GENERATOR"
 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 "><LINK
 REL="HOME"
-TITLE="Privoxy 3.0.4 User Manual"
+TITLE="Privoxy 3.0.7 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Installation"
@@ -39,7 +39,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.4 User Manual</TH
+>Privoxy 3.0.7 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -79,291 +79,29 @@ NAME="WHATSNEW"
 ></A
 >3. What's New in this Release</H1
 ><P
-> There are many improvements and new features in <SPAN
+> There are many improvements and new features since <SPAN
 CLASS="APPLICATION"
->Privoxy</SPAN
-> 3.0.4
- :</P
+>Privoxy 3.0.6</SPAN
+>, the last stable release:</P
 ><P
 > <P
 ></P
 ><UL
 ><LI
 ><P
->    Mulitiple <A
-HREF="filter-file.html"
->filter files</A
-> can now be specifed 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.
-   </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
->    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&#38;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 various bug fixes and significant enhancements, including 
-    error pages should no longer be cached if the problem is fixed, better DNS
-    error handling, and various logging improvements.
+>Privoxy 3.0.5</SPAN
+> to apply
+    the content filters to the headers as, well have been removed again.
    </P
 ></LI
 ></UL
@@ -396,7 +134,7 @@ CLASS="APPLICATION"
 ><LI
 ><P
 >  
-   On the other hand, some installers may not overwrite any existing configuration 
+   On the other hand, other installers may not overwrite any existing configuration 
    files, thinking you will want to do that. You may want to manually check 
    your saved files against the newer versions to see if the improvements have
    merit, or whether there are new options that you may want to consider.
@@ -414,15 +152,42 @@ HREF="actions-file.html#FAST-REDIRECTS"
 >fast-redirects</A
 ></TT
 >
-     which has changed syntax, and may require adjustments to local configs.
+     which has changed syntax, and will require adjustments to local configs, 
+     such as <TT
+CLASS="FILENAME"
+>user.action</TT
+>. You must reference the new 
+     syntax: 
    </P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  { +fast-redirects{check-decoded-url} }
+   .example.com
+   mybank.com
+   .google.</PRE
+></TD
+></TR
+></TABLE
+></P
 ></LI
 ><LI
 ><P
 >     The <TT
 CLASS="FILENAME"
 >jarfile</TT
->, cookie logger, is off by default now.
+>, 
+     <A
+HREF="http://en.wikipedia.org/wiki/Browser_cookie"
+TARGET="_top"
+>cookie</A
+> logger, is off by default now.
     </P
 ></LI
 ><LI
@@ -441,6 +206,98 @@ CLASS="QUOTE"
 CLASS="QUOTE"
 >"off"</SPAN
 > by default.
+   There are also a number of new actions and filters you may want to
+   consider, most of which are not fully incorporated into the default
+   settings as yet (see above).
+  </P
+></LI
+><LI
+><P
+>    The default actions setting is now <TT
+CLASS="LITERAL"
+>Cautious</TT
+>. Previous
+    releases had a default setting of <TT
+CLASS="LITERAL"
+>Medium</TT
+>. Experienced
+    users may want to adjust this, as it is fairly conservative by <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    standards and past practices. See <A
+HREF="http://config.privoxy.org/edit-actions-list?f=default"
+TARGET="_top"
+>    http://config.privoxy.org/edit-actions-list?f=default</A
+>. New users
+    should try the default settings for a while before turning up the volume.
+   </P
+></LI
+><LI
+><P
+>    The default setting has filtering turned <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>off</I
+></SPAN
+>, which
+    subsequently means that compression is <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>on</I
+></SPAN
+>. Remember
+    that filtering does not work on compressed pages, so if you use, or want to
+    use, filtering, you will need to force compression off. Example:
+   </P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  { +<A
+HREF="actions-file.html#FILTER"
+>filter</A
+>{google}  +<A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+>prevent-compression</A
+> }
+   .google.</PRE
+></TD
+></TR
+></TABLE
+>
+   </P
+><P
+>    Or if you use a number of filters, or filter many sites, you may just want
+    to turn off compression for all sites in
+    <TT
+CLASS="FILENAME"
+>default.action</TT
+> (or
+    <TT
+CLASS="FILENAME"
+>user.action</TT
+>). 
+   </P
+></LI
+><LI
+><P
+>   Also, <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
+>session-cookies-only</A
+> is 
+   off by default now. If you've liked this feature in the past, you may want 
+   to turn it back on in <TT
+CLASS="FILENAME"
+>user.action</TT
+> now.
   </P
 ></LI
 ><LI
@@ -511,10 +368,7 @@ VALIGN="top"
 WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
->Quickstart to Using <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-></TD
+>Quickstart to Using Privoxy</TD
 ></TR
 ></TABLE
 ></DIV