Submit new version of manual so some of Fabians work has some documentation.
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
index 9069a79..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"
@@ -17,7 +17,9 @@ TITLE="Quickstart to Using Privoxy"
 HREF="quickstart.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css"></HEAD
+HREF="../p_doc.css">
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
+</head
 ><BODY
 CLASS="SECT1"
 BGCOLOR="#EEEEEE"
@@ -37,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
@@ -77,252 +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 installed and 
-    started as a <SPAN
-CLASS="emphasis"
-><I
-CLASS="EMPHASIS"
->service</I
-></SPAN
->.
-   </P
-></LI
-><LI
-><P
->    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.
+>Privoxy 3.0.5</SPAN
+> to apply
+    the content filters to the headers as, well have been removed again.
    </P
 ></LI
 ></UL
@@ -354,6 +133,17 @@ CLASS="APPLICATION"
 ></LI
 ><LI
 ><P
+>  
+   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.
+   There are a number of new features, but most won't be available unless 
+   these features are incorporated into your configuration somehow.
+  </P
+></LI
+><LI
+><P
 >     See the full documentation on 
      <TT
 CLASS="LITERAL"
@@ -362,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
@@ -389,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
@@ -459,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