*******************************************************************************
Some Hints regarding the Proxomitron Menu
*******************************************************************************

The Menu appears when you put the mouse on the Proxomitron Menu icon.
Left-click anywhere on the page and the icon, a triangle inside a circle, will
appear.  Scroll the window with the mouse and the icon will disappear, until
you left-click again.  If you left-click the icon it disappears and will only
return to that page after a reload.

Some items in the menu vary.  They depend on browser, page, or chosen config
settings.

Links followed by a 3-dot symbol are JavaScript links that alter the page
layout or open in a popup window.  Those followed by ">>" symbol will always
open in a new tab (if supported by the browser).
All other links are normal ones.  Current versions of Mozilla, Opera, or
Maxthon/Sleipnir/etc. can open them in a new tab/window by middle-clicking.

Several menu links use URL commands.  Checking "Disable URL-based Proxomitron
commands" under "Config -> Access" in Proxomitron's main window will disable
them.


-------------------------------------------------------------------------------
Sections
-------------------------------------------------------------------------------

The top-left menu section header displays the window's name or "Dynamic".
...............................................................................

Toggle Kills:
Shows/Hides information about most killed advertisements.  Complete info is
available in Debug Mode (see Config_Control.txt),


Toggle Comments:
Shows/Hides the content of comment-blocks and commented-out code. General Prox
comments are excluded, while site-specific ones are shown.  Comments collected
from the <head> tag - if any - are displayed inside a blue box.  Functional
commented-out code will get parsed, except for scripts.


Toggle "xxx" CSS:
Disables/enables all stylesheets - except the Proxomitron ones.  "xxx" shows
the number of external and inline CSS entities - minus ours - including those
that are disabled by default (e.g. thru the "alternate stylesheet" flag).

This menu item is hidden if there is no style information.  Part of the code
written by Jesse Ruderman.


Toggle DOM Path:
Lists the ancestors of any element you hover over in the status bar.

Example:  "HTML[2] > BODY > SPAN[2].subtitle > I" means that your mouse is over
          an italic block, inside the second span block, which has the class
          value "subtitle".

Most of the code is from a bookmarklet by Jesse Ruderman.


Toggle Topo View:
Shows the nesting level of every element using shading, IOW the "topographic"
structure of the page.  Also comes in handy for pages with weird colors.
Based on code by Jesse Ruderman and Joseph Pearson.


Kill Timers:
Stops all (actually, the first 10,000) timers that may eat up your CPU time.


The first row's second header shows the mode in which the page is rendered.
...............................................................................

Show "xxx" Script(s):
Opens a window displaying the content of all linked (external) and embedded
(inline) scripts.  Proxomitron's standard scripts are not displayed.  Besides
the active scripts, blocked scripts are shown as well - titled with "Blocked".
"xxx" represents the number of page scripts - minus ours.

Notes/Restrictions/Browser Peculiarities:
The menu item doesn't work, if a page script is setting "document.domain" to
something else than the current host.  In this case temporarily switching to
Debug Mode ("Session" button plus one more CTRL-Refresh) - where manipulating
above JS property is blocked -  should help.

*Blocked* inline and external scripts are shown unfiltered.  In IE *all*
external scripts are shown unfiltered, even if normally blocked when incoming.
Opera doesn't show the content of blocked inline scripts.

This menu item is hidden if there are no page scripts.
Original idea by Jesse Ruderman.


JavaScript Shell:
Opens a console where you can run JS commands in the context of the current
page.  You can also load user scripts, or inquire about your browser's JS
support - try e.g. "props(window)" or "props(document)".
See the console's "Help" link for details.  The JS Shell project is maintained
by Jesse Ruderman.


JS Variables:
Opens a window with name, type, and content of all variables/object/functions
in the current environment.  Proxomitron's own JS code is not displayed, unless
while in Debug Mode.
This item only shows up in Gecko browsers and Opera.  Code by Jesse Ruderman.


Classes & IDs:
Opens a window showing number and name of all HTML tags with "class" or "id"
attributes, as well as the respective attribute's value.  Proxomitron's own
classes/IDs are not displayed, unless while in Debug Mode.
Code by Jesse Ruderman.


Doc Properties:
Shows various information about the currently displayed document - minus any
additions by Proxomitron.  Code by Paul Rupe.


DOM Source:
Opens a new tab with the page source, as the browser is seeing it, including
everything that's added (or removed) by scripts.
This function supports syntax highlighting.  It uses the same stylesheet like
Proxomitron does for "src.." view.  The file is called "ViewSource.css" and is
in the "html" directory.  There's an alternative version in "sidki-etc\html".
Original idea by Jesse Ruderman.


The first row's bottom header shows the config version you're using.
...............................................................................

Verify Ad Lists:
Compares the entries in the AdHosts and AdDomains lists with Peter Lowe's Hosts
file and displays the number of entries/hits/missed at the bottom.  Note that
you can only get zero misses if you uncomment the "Uncomment when verifying"
section in AdHosts, which contains dead and unneeded entries.


Config Updates:
Links to my "Config Download" page, which may or may not contain updates or
hotfixes - called WIP filters - for the current config release.


"Translate"
...............................................................................

Google: automatic:
Google detects the page's language on its own and translates it into English.
Currently supports Arabic, Chinese simplified, French, German, Italian,
Japanese, Korean, Portuguese, Russian, and Spanish.


BabelFish: choose:
Gets you to a cleaned BabelFish page where you can select a language pair for
translation of the current page.


InterTran: choose:
Similar to above item, but gets you to a minimalized InterTran selector, which
is slower than BabelFish, sometimes dead, but supports a lot more languages.


The top-middle header displays the document size (IE only) or "Navigate".
...............................................................................

Top:
Goes to the site's top level.  Doesn't show up if you're already there.


Up:
Goes up one level in the site's directory structure.  Doesn't show up if there
is no more up-level or if the up-level is the top-level.


Referrer:
Goes back to the page that linked you to the current page.  Doesn't show up if
you got there directly.


"Prox"
...............................................................................

The links listed here open the current page with the specified URL command.
However, the command is converted from a "subdomain" to a query string, which
solves several problems related to security and cookies.


"Site"
...............................................................................

Validate:
Sends the current document to W3's HTML validator.  Error report is set to
verbose.


Netcraft:
Links to Netcraft's uptime, OS, and IP stats for the current site.


Cached:
Shows Google's cached copy of the current page.  The "last crawled" date should
appear at the bottom of the page.


Wayback:
Shows all snapshots of the current page - as collected by Internet Archive's
(== Alexa's) Wayback crawler - if any.


Alexa:
Links to detailed traffic stats for the current site, if among the top 100,000.
Note that - when clicking the menu link - the fact that you've visited the
current page is sent to alexa.com - that's how they get their stats after all.
Restrictive ad-blocking Hosts files will block connections to alexa.com.


Popularity:
Opens a window that shows the number of pages that link to the current document
- as determined by Google, Yahoo, and MSN.  Clicking left to the numbers opens
the respective search result page.  Service provided by seo.3000.it.


BugMeNot:
Opens a window with user/password pairs for the current site.  Only useful if -
surprise - called from a page that actually utilizes logins.
Service provided by BugMeNot.com.


"Host or IP"
...............................................................................

SmartWhois:
Opens a window showing "IP address / hostname alias" pair, owner, and netblock
of the IP or hostname that you've marked (i.e, selected prior to clicking the
link) or entered.  Service provided by All-NetTools.com.


Whois:
Shows detailed registration data about the IP or hostname that you've marked or
entered.  Service provided by SamSpade.org.


Location:
Shows the geographical location of the IP or hostname that you've marked or
entered.  Some tight public Hosts files block connections to geobytes.com,
which is providing this service (and shuts it down after some dozens of requests
per IP and day).


"Allow"
...............................................................................

The entries listed here set the most common bypass keywords for the current
page.  You can check multiple items.

Hint:  Click "Toggle Kills" before, to see which filters may need to be
       bypassed.


Separator
...............................................................................

These entries invert the options that you've set in the "Config Control"
section of Proxomitron's "Header Filters" window.  Again, more than one item
may be checked.


Separator
...............................................................................

Lets you switch between the available config modes.  The current mode is
selected by default.  Only one mode can be checked at a time.


"Go" button
...............................................................................

Reloads the current page with the selected options (keywords).  Strips all
keywords from the URL if none of the above entries is checked.


"Session" button
...............................................................................

Selected options become the "temporary default".  They are reset when the
button is pushed again without any of above entries being checked, or when the
config is reloaded.


"List" button
...............................................................................

Opens the "Add to Blockfile" dialog, with the path of the current page and the
chosen keywords being preset.


*EOF*
