Sync.
[privoxy.git] / doc / source / user-manual.sgml
index 611fb71..3086c9d 100644 (file)
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: user-manual.sgml,v 1.53 2002/03/24 11:51:00 swa Exp $
+ $Id: user-manual.sgml,v 1.56 2002/03/24 16:17:06 swa Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  Privoxy team.  http://ijbswa.sourceforge.net
@@ -28,7 +28,7 @@ Hal Burgiss <hal@foobox.net>
 <artheader>
 <title>Privoxy User Manual</title>
 
-<pubdate>$Id: user-manual.sgml,v 1.53 2002/03/24 11:51:00 swa Exp $</pubdate>
+<pubdate>$Id: user-manual.sgml,v 1.56 2002/03/24 16:17:06 swa Exp $</pubdate>
 
 <authorgroup>
  <author>
@@ -75,6 +75,14 @@ You can find the latest version of the user manual at  <ulink url="http://ijbswa
  multi-user networks.
 </para>
 
+<para>
+ <application>Privoxy</application> is derived from 
+ <application>Internet Junkbuster</application> by Junkbusters Corporation, 
+ which is no longer under development. Many enhancements and 
+ new features have been added.
+
+</para>
+
 <para>
  This documentation is included with the current BETA version of
  <application>Privoxy</application> and is mostly complete at this
@@ -234,8 +242,8 @@ You can find the latest version of the user manual at  <ulink url="http://ijbswa
 
 <para>
  <screen>
- tar xzvf ijb_source_* [.tgz or .tar.gz]
- cd ijb_source_2.9.11_beta
+ tar xzvf privoxy-2.9.13-beta-src* [.tgz or .tar.gz]
+ cd privoxy-2.9.13-beta
  </screen>
 </para>
 
@@ -286,8 +294,8 @@ You can find the latest version of the user manual at  <ulink url="http://ijbswa
 
 <para>
  <screen>
- autoheader   [suggested for CVS source]
- autoconf     [suggested for CVS source]
+ autoheader
+ autoconf
  ./configure
  make redhat-dist
  </screen>
@@ -330,8 +338,8 @@ You can find the latest version of the user manual at  <ulink url="http://ijbswa
 
 <para>
  <screen>
- autoheader   [suggested for CVS source]
- autoconf     [suggested for CVS source]
+ autoheader
+ autoconf
  ./configure
  make suse-dist
  </screen>
@@ -712,16 +720,16 @@ Please choose from the following options:
 </para>
 
 <para>
- The <quote>default.action</quote> file contains patterns to specify the actions
- to apply to requests for each site. Default: Cookies to and from all
+ The <quote>default.action</quote> file contains patterns to specify the
actions to apply to requests for each site. Default: Cookies to and from all
  destinations are kept only during the current browser session (i.e. they are
  not saved to disk). Pop-ups are disabled for all sites. All sites are
  filtered through selected sections of <quote>default.filter</quote>. No sites
- are blocked. The <application>Privoxy</application> logo is displayed for
- filtered ads and other images. The syntax of this file is explained in detail
- <link linkend="actionsfile">below</link>. Other <quote>actions</quote> files
- are included, and you are free to use any of them. They have varying degrees
- of aggressiveness.
+ are blocked. <application>Privoxy</application> displays a checkboard type
+ pattern for filtered ads and other images. The syntax of this file is
+ explained in detail <link linkend="actionsfile">below</link>. Other
+ <quote>actions</quote> files are included, and you are free to use any of
them. They have varying degrees of aggressiveness.
 </para>
 
 <para>
@@ -1879,7 +1887,7 @@ Removed references to Win32. HB 09/23/01
 
 <para>
  The <quote>default.action</quote> file (formerly
- <filename>actionsfile</filename>) is used to define what actions
+ <filename>actionsfile</filename> or <filename>ijb.action</filename>) is used to define what actions
  <application>Privoxy</application> takes, and thus determines how images,
  cookies and various other aspects of HTTP content and transactions are
  handled. Images can be anything you want, including ads, banners, or just
@@ -2448,21 +2456,23 @@ Removed references to Win32. HB 09/23/01
   +image}</quote>, e.g an advertizement. There are five options.
   <quote>-image-blocker</quote> will send a HTML <quote>blocked</quote> page,
   usually resulting in a <quote>broken image</quote> icon.
-  <quote>+image-blocker{logo}</quote> will send a
-  <application>Privoxy</application> logo
-  image. <quote>+image-blocker{blank}</quote> will send a 1x1 transparent GIF
-  image. And finally, <quote>+image-blocker{http://xyz.com}</quote> will send
-  a HTTP temporary redirect to the specified image. This has the advantage of
-  the icon being being cached by the browser, which will speed up the display.
-  <quote>+image-blocker{pattern}</quote> will send a checkboard type pattern,
-  which scales better than the logo (which can get blocky if the browser
-  enlarges it too much).
+<!--   <quote>+image-blocker{logo}</quote> will send a -->
+<!--   <application>Privoxy</application> logo -->
+<!--   image. -->
+<quote>+image-blocker{blank}</quote> will send a 1x1 transparent GIF
+image. And finally, <quote>+image-blocker{http://xyz.com}</quote> will send a
+HTTP temporary redirect to the specified image. This has the advantage of the
+icon being being cached by the browser, which will speed up the display.
+<quote>+image-blocker{pattern}</quote> will send a checkboard type pattern
+<!-- , -->
+<!-- which scales better than the logo (which can get blocky if the browser -->
+<!-- enlarges it too much). -->
   </para>
   <para>
    <literal>
     <msgtext> 
      <literallayout>
-  <emphasis>+image-blocker{logo}</emphasis>
+<!--   <emphasis>+image-blocker{logo}</emphasis> -->
   <emphasis>+image-blocker{blank}</emphasis>
   <emphasis>+image-blocker{pattern}</emphasis>
   <emphasis>+image-blocker{http://p.p/send-banner}</emphasis>
@@ -3270,6 +3280,12 @@ For any other issues, feel free to use the <ulink url="http://sourceforge.net/ma
 
 <sect2>
 <title>History</title>
+<para>
+ <application>Privoxy</application> is derived from
+ <application>the Internet Junkbuster</application>, with many 
+ improvments and enhancements over the original.
+</para>
+
 <para>
  <application>Junkbuster</application> was originally written by Anonymous
  Coders and <ulink
@@ -3279,7 +3295,8 @@ For any other issues, feel free to use the <ulink url="http://sourceforge.net/ma
  Waldherr</ulink> made many improvements, and started the <ulink
  url="http://sourceforge.net/projects/ijbswa/">SourceForge project
  Privoxy</ulink> to rekindle development. There are now several active
- developers contributing.  The last stable release was v2.0.2, which has now
+ developers contributing.  The last stable release of
+ <application>Junkbuster</application> was v2.0.2, which has now
  grown whiskers ;-).
 </para>
 
@@ -3724,8 +3741,8 @@ For any other issues, feel free to use the <ulink url="http://sourceforge.net/ma
 <para>
  First, enter one URL (or partial URL) at the prompt, and then
  <application>Privoxy</application> will tell us 
- how current configuration will handle it. This will not
- help with filtering effects from the <filename>default.filter</filename>! It
+ how the current configuration will handle it. This will not
+ help with filtering effects from the <filename>default.filter</filename> file! It
  also will not tell you about any other URLs that may be embedded within the
  URL you are testing. For instance, images such as ads are expressed as URLs
  within the raw page source of HTML pages. So you will only get info for the
@@ -3943,6 +3960,16 @@ For any other issues, feel free to use the <ulink url="http://sourceforge.net/ma
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
  $Log: user-manual.sgml,v $
+ Revision 1.56  2002/03/24 16:17:06  swa
+ configure needs to be generated.
+
+ Revision 1.55  2002/03/24 16:08:08  swa
+ we are too lazy to make a block-built
+ privoxy logo. hence removed the option.
+
+ Revision 1.54  2002/03/24 15:46:20  swa
+ name change related issue.
+
  Revision 1.53  2002/03/24 11:51:00  swa
  name change. changed filenames.