Removing "tinygif" option.
[privoxy.git] / config
diff --git a/config b/config
index 2dea618..69cbbf0 100644 (file)
--- a/config
+++ b/config
@@ -1,7 +1,7 @@
 #  Sample Configuration file for the Internet Junkbuster 2.0
 
 #
-# $Id: config,v 1.5 2001/05/23 10:39:05 oes Exp $
+# $Id: config,v 1.8 2001/05/31 21:52:16 jongfoster Exp $
 #
 
 #  Table of Contents
 #  files in the current working directory.  In either case, an
 #  absolute path name can be used to avoid problems.
 
-#
-#  The blockfile contains regular expressions, one per line, of URLs
-#  to be blocked by Junkbuster.
-#
-#  Default: Don't block anything.
-#
-blockfile   ./blocklist
-
-#
-#  The imagefile contains regular expressions, one per line, of URLs
-#  to be blocked as images by Junkbuster, regardless of whether they
-#  look like image URLs or not.
-#
-#  Default: Block all URLs as HTML requests.
-#
-imagefile   ./imagelist 
-
 #
 #  The permissions file contains patterns to specify the
-#  cookie and filtering rules to apply to each site.
+#  filtering rules to apply to each site.
 #
 #  Default: Cookies to and from all destinations are filtered.
 #           Popups are disabled for all sites.
 #           All sites are filtered if re_filterfile specified.
+#           No sites are blocked.  Nothing is an image.
 #
 permissionsfile ./permissionsfile
 
@@ -105,8 +89,7 @@ re_filterfile   ./re_filterfile
 #  Junkbuster (e.g., it's not blocking an ad you think it should
 #  block) but in most cases you probably will never look at it.
 #
-#  If you do not use 'log-buffer-size'/'log-max-lines' (see below)
-#  your logfile will grow indefinitely, and you will probably want to
+#  Your logfile will grow indefinitely, and you will probably want to
 #  periodically remove it.  On Unix systems, you can do this with a
 #  cron job (see 'man cron').
 #
@@ -164,64 +147,6 @@ forwardfile   ./forward
 #  how Junkbuster operates.
 #
 
-#
-#  If 'add-forwarded-header' is set, an "X-Forwarded-For:"
-#  specification will be added to each request header.  Generally,
-#  this is not needed and will reduce your privacy, as the server
-#  will not only see which proxy the request came through, but also
-#  which machine behind that proxy the request originally came from.
-#
-#  Default: Don't add the "X-Forwarded-For:" header.
-#
-#add-forwarded-header
-
-#
-#  Junkbuster can add "wafers", i.e. fake cookies, to each request
-#  header it sends out.
-#  These wafers can be seen by Web site operators in their log files,
-#  so it's a way for you to communicate (very indirectly!) with
-#  them. Junkbuster will add as many wafers as you like to each
-#  request, just list them all here.  Here's an example:
-#
-#     wafer    NOTE=Like most people, I want my browsing to be anonymous.
-#     wafer    WARNING=Please do not attempt to track me.
-#
-#  Wafers make each request larger and will have a (small) impact on
-#  your browsing speed, so you probably don't want to do this unless
-#  you have a particular need.
-#
-#  Default: Don't add a wafer
-#
-#wafer NOTE=Add your wafer here...
-
-#
-# There's also a pre-defined wafer containing a privacy message,
-# called the vanilla wafer, which is sent by default. Setting
-# suppress-vanilla-wafer suppresses this. You guessed that, didn't you?
-#
-# Default: Send the vanilla wafer
-#
-suppress-vanilla-wafer
-
-#
-#  In fact, Junkbuster can add anything at all to the request headers.
-#  You can specify the headers to add with the add-header option.  For
-#  example: 
-#
-#     add-header  Forwarded: by http://stay-out-of-my-backyard.net
-#
-#  Generally, random headers will simply be ignored by the Web site,
-#  so there's little use in adding them.  However, there are some
-#  cases where you might want to add a header, e.g., if you're
-#  forwarding Junkbuster requests to another proxy you might want to
-#  add:
-#
-#     add-header    Proxy-Connection: Keep-Alive
-# 
-#  to every request.
-#
-#add-header My-Header: Whatever you'd like...
-
 #
 #  Listen-address specifies the address and port where Junkbuster will
 #  listen for connections from your Web browser.  The default is to
@@ -258,129 +183,6 @@ suppress-vanilla-wafer
 #            listen-address    127.0.0.1:8000
 #
 
-#
-#  When your Web browser makes a request from a Web site, it informs
-#  the Web site what sort of browser it is, e.g., "Internet Explorer
-#  V2.0" or some such.  In theory, Web sites can use this information
-#  to tailor themselves for your browser.
-#
-#  The 'user-agent' option controls whether Junkbuster will conceal
-#  your browser type or not.  If user-agent is set to . (period) the
-#  User-Agent header is passed to the server unchanged, along with any
-#  UA headers produced by MS-IE (which would otherwise be deleted). If
-#  user-agent is set to @ (at) these headers are sent unchanged in
-#  cases where the cookiefile specifies that a cookie would be sent,
-#  otherwise only a default User-Agent header is sent. That default is
-#  Mozilla/3.0 (Netscape) with an unremarkable Linux configuration. 
-#  If left unset, the default header is always sent.
-#
-#  Note that if you choose to mislead Web sites about your browser
-#  type, you may get Web pages that confuse your browser or display
-#  incorrectly.  In most cases, it's probably fine to send your real
-#  browser type.
-#
-#  Default: Always send the (forged) default user agent header
-#
-user-agent    .
-
-#
-#  When your Web browser requests a page from a Web site, it also
-#  informs the Web site where it came from, i.e., when you click
-#  through to a new web page, your browser tells the new web site the
-#  URL of the old web page.  This is called the "Referer" header.
-#
-#  Junkbuster has the ability to mask the Referer header.  Referer
-#  headers can be used to track users as they browse around the web,
-#  and many consider them invasive.  Junkbuster provides several
-#  options for dealing with referer headers:
-#
-#       VALUE       EFFECT
-#       =====       ======
-#       default     Kill the referrer-header from the client.
-#       .           Pass the referrer unchanged.
-#       @           Pass the referrer if the server is in the cookie file,
-#                   kill the referrer otherwise.
-#       L           Pass the referrer if the server is in the cookie file,
-#                   send a forged referrer that points to the
-#                   root-directory URL of the current request otherwise.
-#       'text'      Always send <text> as the referrer.
-#
-#  L is probably preferable to @, because it will break fewer Web
-#  sites while still concealing your browsing path.
-#
-#  Default: see above
-#
-referer     L
-
-#
-#  Some browsers provide a "From:" header that gives Web sites your
-#  email address.  The only real effect of this is to make you a
-#  target for unsolicited email (spam).  There are three options
-#  what to do with the "From:" header if it is present:
-# 
-#       VALUE       EFFECT
-#       =====       ======
-#       default     Kill every "From:" header
-#       .           Pass the "From:" header unchanged
-#       'text'      replace the email address in the "From:" header with 'text'
-#
-#  Default: see above
-#
-#from   spam-me-senseless@sittingduck.xqq
-
-#
-#  The 'tinygif' option lets you change how Junkbuster treats blocked
-#  images.  The default behavior is to send an HTML answer to requests
-#  for images, resulting in a "broken image icon" in place of the blocked
-#  image.  That's a little ugly, so several other options are available:
-#
-#     VALUE       EFFECT
-#     =====       ======
-#     0           Send HTML
-#     1           Send a GIF of one transparent pixel
-#     2           Send a GIF with the word "JUNKBUSTER"
-#     3 <url>     Send a redirect to the image indicated by the <url>
-#
-#  As an example of the last option:
-#
-#    tinygif 3 http://no.where/ijb-send-banner.gif
-#
-#  Will replace every blocked image with an image built into junkbuster.
-#
-#  There is one non-obvious benefit to using option "3".  If you use
-#  option 3, your Web browser will likely cache the image you specify
-#  on your local machine.  That means that after the first use, that
-#  image will load very quickly (and won't require a request to the
-#  junkbuster proxy)
-#
-#  Default: 0, i.e. send HTML
-#
-tinygif   2
-
-#
-#  Many sites, like yahoo.com, don't just link to other sites.
-#  Instead, they will link to some script on their own server,
-#  giving the destination as a parameter, which will then redirect
-#  you to the final target. 
-#
-#  URLs resulting from this scheme typically look like:
-#  http://some.place/some_script?http://some.where-else
-#
-#  Sometimes, there are even multiple consecutive redirects encoded
-#  in the URL. These redirections via scripts make your web browing
-#  more traceable, since the server from which you follow such a link
-#  can see where you go to. Apart from that, valuable bandwidth and
-#  time is wasted, while your browser aks the server for one redirect
-#  after the other. Plus, it feeds the advertisers.
-#
-#  The fast-redirects option enables interception of these requests
-#  by junkbuster, who will cut off all but the last valid URL in the
-#  request and send a local redirect back to your browser without
-#  contacting the remote site.
-#
-#  Default: Don't intercept script-redirect URLs
-#
-fast-redirects 
 
 #
 #  The debug option sets the level of debugging information to log in
@@ -417,7 +219,8 @@ fast-redirects
 #
 #  Default: 0, i.e. log nothing but fatal errors
 #
-debug   1
+debug   1    # URLs
+debug   4096 # Info
 debug   8192 # Errors - *we highly recommended enabling this*
 
 #
@@ -432,28 +235,27 @@ debug   8192 # Errors - *we highly recommended enabling this*
 #single-threaded
 
 #
-#    'toggle' controls whether Junkbuster can temporarily be toggled on
-#    and off.
+#    'toggle' allows you to temporarily disable all Junkbuster's 
+#    filtering.  Just set "toggle 0".
 #    
 #    The Windows version of Junkbuster puts an icon in the system
-#    tray.  If you right-click on that icon (or select the 'Options'
-#    menu), one choice is "Enable".  Clicking on enable toggles
-#    Junkbuster on and off.  This is useful if you want to temporarily
-#    disable Junkbuster, e.g., to access a site that requires cookies
-#    which you normally have blocked.
-#
-#    Unix versions of Junkbuster are toggled on and off by sending a
-#    SIGHUP to Junkbuster.
+#    tray, which allows you to change this option without having
+#    to edit this file.  If you right-click on that icon (or select
+#    the 'Options' menu), one choice is "Enable".  Clicking on enable
+#    toggles Junkbuster on and off.  This is useful if you want to
+#    temporarily disable Junkbuster, e.g., to access a site that
+#    requires cookies which you normally have blocked.
 #
-#    'toggle 1' means permit toggling of Junkbuster, 'toggle 0' means
-#    don't.
+#    'toggle 1' means Junkbuster runs normally, 'toggle 0' means
+#    that Junkbuster becomes a non-anonymizing non-blocking
+#    proxy.
 #
 #  Default: 1
 #
 toggle 1
 
 #
-#  5. WINDOWS GUI OTPIONS
+#  5. WINDOWS GUI OPTIONS
 #
 #  Junkbuster has a number of options specific to the Windows GUI
 #  interface:
@@ -509,8 +311,8 @@ toggle 1
 
 #    show-on-task-bar        {1 or 0}
 #
-#    Controls whether or not Junkbuster will appear on the Task bar
-#    when minimized.
+#    Controls whether or not Junkbuster will appear as a button on the Task
+#    bar when minimized.
 #
 #Win32-only: show-on-task-bar        0