*******************************************************************************
Config Control
*******************************************************************************

Contents:

  Header Filters Window
    1 General
    2 Proxies
    3 Logging
    4 Cookie Handling
    5 Cache Handling

  Web Filters Window
    Display I
    Popups
    Ads
    JavaScript
    Various


*******************************************************************************
Header Filters Window
*******************************************************************************

-------------------------------------------------------------------------------
1      General
-------------------------------------------------------------------------------

1.1    Use Light Settings (off)
...............................................................................

If active, filters that are more likely to cause problems are bypassed.
Filters affected by this switch are marked with "full".
Also accessible from the Proxomitron menu.


1.2    Use Debug Mode (off)
...............................................................................

This switch activates several verbose JavaScript and filter subroutines, as
well as the "Debug Mode: Log Time" and "Bottom Add: Display Variables - Debug"
filters.
Also accessible from the Proxomitron menu.


1.3    Use Half-SSL (off)
...............................................................................

If active, secure links (https://) get redirected or converted to a Proxomitron
URL command (http://https..).

Pro:    You may save some time because Proxomitron doesn't need to re-encrypt
        the document after filtering - and the browser doesn't need to decrypt
        it.
        You don't get a warning message in Mozilla and Opera, saying that
        Proxomitron's certificate doesn't match the site in question.

Contra: The browser is completely unaware that it is dealing with a secure
        page.  All responsibility goes to Proxomitron.  You may not feel
        comfortable with this fact.

This option requires a URL-based Proxomitron command.
Do *not* check "Disable URL-based Proxomitron commands", under
"Config -> Access" in Proxomitron's main window.

Proxomitron *must* have access to the SSL DLLs.  The browser's HTTPS proxy
setting will not matter when this technique is in effect.

More info:
The "Installation" chapter in the ReadMe.
Scott R. Lemmon's thoughts in Proxomitron's ReadMe.


1.4    Allow Page Layout Changes (on)
...............................................................................

If active, some aspects of the original page layout may be modified.  This
includes for instance dimmed white backgrounds and increased small fonts.
Filters affected by this switch are marked with "lao".
Also accessible from the Proxomitron menu.


1.5    Block Scripts by Default (off)
...............................................................................

Self-explanatory.
Also accessible from the Proxomitron menu.


-------------------------------------------------------------------------------
2      Proxies
-------------------------------------------------------------------------------

2.1    Proxy Spoofing by Default (off)
...............................................................................

Enable this and Proxomitron will try to hide your real IP address from nosey
websites by pretending that your computer is a proxy server forwarding requests
for another (US) IP address.
The "spoofed" IP address will be constant per domain.
The "spoofed" IP address will change when the config is reloaded.

Note: Your IP address isn't *really* hidden by this.  A webmaster with an
      average IQ will detect the spoof when inspecting the log.
      Also, you may have problems accessing some sites, Yahoo! is already
      excluded by default.

Also accessible from the Proxomitron menu.


2.2    Use Proxy by Default (off)
...............................................................................

As long as you use a standard proxy, there is no real difference between this
option and the "Use Remote Proxy" checkbox in Proxomitron's main window.

If your main proxy requires authentication and your proxy list contains more
than one entry, you *always* need to use this switch instead of the built-in
one.


2.3    Use Proxy with FTP and Gopher (off)
...............................................................................

This switch enables Proxomitron to filter documents that are located on FTP or
Gopher servers.  To make this possible, the address of an intermediate proxy
that translates the protocols into HTTP must be entered inside the filter.

See the "Installation" chapter in the ReadMe for further details.


2.4.a  Use Standard Proxy (on)
...............................................................................

Self-explanatory.


2.4.b  Use Auth Proxy (off)
...............................................................................

Check this option and uncheck the one above if your remote proxy requires
authentication.  See the "Installation" chapter in the ReadMe for additional
mandatory steps to get your remote proxy up and running.


-------------------------------------------------------------------------------
3      Logging (only enable one or none)
-------------------------------------------------------------------------------

3.1.a  Log to Main (L-key) + Rare (on)
...............................................................................

The majority of filters can log their hits to files.
If this option is active, rare or crucial hits are logged to Log-Rare.log.
If you press and hold the "L" key, those and all other hits also go timestamped
to Log-Main.log.


3.1.b  Log to Main + Rare (off)
...............................................................................

If this option is active:
All hits are logged to Log-Main.log.
Rare or crucial hits are also logged to Log-Rare.log.


-------------------------------------------------------------------------------
4      Cookie Handling (only enable one or none)
-------------------------------------------------------------------------------

4.1.a  Session Cookies by Default (on)
...............................................................................

All persistent cookies are converted to session cookies that will be lost, when
the current browser session ends.
*Except* cookies from sites listed in the default "AllowCookies" list.


4.1.b  Block Cookies by Default (off)
...............................................................................
No cookies are allowed to arrive at or leave your browser.
*Except* cookies from sites listed in the default "AllowCookies" list.


-------------------------------------------------------------------------------
5      Cache Handling (only enable one or none)
-------------------------------------------------------------------------------

5.1.a  Always Cache (off)
...............................................................................

Details:
- Everything is cached for 24 hours.

- Reload sends a conditional request to the server that asks if the document
  has changed since the last fetch.  If there was no such information
  (Last-Modified or ETag), the document is re-requested anyway.

- CTRL-Reload unconditionally re-requests the document, no matter if it has
  changed or not.

- This behavior is the same for all browsers and all documents - the HTML page
  and everything that is embedded, images, external scripts, stylesheets, etc..

Pro:    Browsing can be very fast.

Contra: You may hit the reload button pretty often, for instance when logging
        into/out of an account or editing a post.

Always inactive while pressing the CTRL or SHIFT key.


5.1.b  Always Cache except for HTML (on)
...............................................................................

This is a trade-off between options "a" and "c".

Details:
- When navigating back/forward in a browser window, everything is fetched
  from the cache.

- When revisiting a page, only the page itself (not images, ...) is
  conditionally re-requested - if supported by browser and server.

- Same as option "a" otherwise.

Always inactive while pressing the CTRL or SHIFT key.


5.1.c  Always Fresh (off)
...............................................................................

All documents are re-fetched from the server in all situations.

Always active while pressing the CTRL key.
Always inactive while pressing the SHIFT key.


*******************************************************************************
Web Filters Window
*******************************************************************************

-------------------------------------------------------------------------------
Display I
-------------------------------------------------------------------------------

Add Proxomitron Menu (on)
...............................................................................

Activates the menu.  See "Prox_Menu.txt" for details.


.  + Open normal Links in new Windows (off)
...............................................................................

Activating this option will cause all normal links in the Proxomitron Menu to
open in a new window - except "Up" and "Top".


Add Style Selector (on)
...............................................................................

If a document contains alternate stylesheets (more exactly, titled links to
external stylesheets), you will see a "styles" link at the bottom of that page.

Clicking on it opens a small popup that shows you a list of styles to select
from and apply.

Gecko and Internet Explorer based browsers only.


Last-Modified or ETag to Title (on)
...............................................................................

If the server sends a Last-Modified header with the document, the GMT (UTC)
time will be displayed in the right part of the title.  This also indicates
that the document is easily cacheable.

Sometimes only an ETag header is sent, making caching just as easy.  In this
case "ETag" is displayed instead.


Images: Alt to Title (on)
...............................................................................

The ALT text of an image gets duplicated to the TITLE attribute, if there is
no title.  That way you will see the text in the image's flyover.

Gecko based browsers and Opera only.  Internet Explorer and Netscape Navigator
do that anyway.


Display Important Info (on)
...............................................................................

Important things like exploit attempts or site-specific actions are displayed
as a flyover, if you hover over the respective links at the bottom of the page.


Display Kills (off)
...............................................................................

Information about almost all blocked or removed code is displayed in the page.
You can always show/hide this information with the "Toggle Kills" bookmarklet
or the "Toggle Kills" link in the Proxomitron Menu.
Always active while in Debug Mode.


Error Messages to Footer (off)
...............................................................................

JavaScript Errors will be printed at the bottom of a page - as they appear.
Always active while in Debug Mode.


Flash & Media Toggle: Show/Play by Default (off)
...............................................................................

By default background sounds, Flash, and movies don't start or show up until
you click a "toggle" link.  This switch reverses that principle: Everything is
displayed until you click the respective link.


(to be continued...)
*EOF*
