WMNETSELECT - A dock applet to send the X selection to Mozilla (or Netscape)

wmnetselect [-a <y|n>] [-display <Display>] [-e <program>] [-h] [-p <[+|-]X[+|-]Y>] [-q <y|n>] [-r <y|n>] [-s <y|n>] [-v] [-w <search engine>]

wmnetselect is a Window Maker dock applet that makes all text on your X display internet-aware, sort of. wmnetselect sends the X selection to Mozilla (or Netscape) when you click on it. In other words, if you select this text:

http://www.dpo.uab.edu/~grapeape/wmfaq.html

and click the middle mouse button on wmnetselect, it will cause Mozilla to load the web page at this URL. If Netscape is not running, wmnetselect will detect that, and launch Mozilla, and then cause Mozilla to load the URL.

If you select the text apathos @ bham.net and click the middle mouse button on wmnetselect, it will start the Mozilla mail composer with the selected text in the To: field.

If Mozilla has already been launched, you can open the URL in a new window by Ctrl-clicking the middle button (hold down the control key and click the middle mouse button on wmnetselect).

If you want to launch Netscape without sending it the X selection, double-click on wmnetselect with the left button, just like any other Window Maker docked appicon.

A single left mouse button click while holding the Ctrl key will add the selected text as a bookmark if a Mozilla window is open. If Mozilla is not open, the Ctrl-left button will open Mozilla to the selected text, but add no bookmark.

A single click of the right mouse button sends the selection as a query to the search engine specified by the -w option (Google by default). A Ctrl-right click will open a new window with the results of the query.

-a <y | n>

When the X selection is blank or is all spaces, wmnetselect pops up the Netscape open URL dialog allowing you to type in a URL. Supplying the -a n option suppresses this behavior and just beeps if there is no selection. Defaults to y

-display <display>

Use an alternate X Display. -d will also work.

-e <program>

Specifies an executable name other than mozilla, (such as netscape) or specifies the full path name of an executable that is not in your search path:

wmnetselect -e /usr/local/src/package/mozilla

If you want to pass parameters to the executable put them in quotes:

wmnetselect -e "netscrape -no-about-splash"

-h

Display a short summary of the command line options.

-i <y | n>

wmnetselect uses a heuristic that supplies the protocol of the URL when none is provided. For example, if the selection contains an @ and doesn't contain any slashes (/), it is interpreted as an email address, and wmnetselect opens the Mozilla mail composer with the selected text in the To: field. Supplying a -i n option suppresses this behavior and supplies the selection to netscape unaltered. Defaults to y

-n

causes wmnetselect to default to opening a new window for right and middle click actions. Control-clicks will reuse an existing window if possible.

-t

causes wmnetselect to default to opening a new tab for right and middle click actions. Control-clicks will reuse an existing window if possible.

-p <[+|-]X[+|-]Y>

Positions wmnetselect at a specific x y location on your display. This option is not really needed for Window Maker, it's mostly there for other window managers. To position wmnetselect near the top right corner of a medium size display, use:

wmnetselect -p +800+40

Defaults to +0+0

-q <y | n>

Use the -q y option to suppress the audible error indication. Defaults to n

-r <y | n>

Use -r n to prevent your browser from being deiconfied when the X selection is passed to it by wmnetselect. The option is mostly for CDE users to prevent the browser from becoming "sticky". Defaults to n

-s <y | n>

Starts netscape (by default) or the executable named in the -e option when wmnetselect is started. This can be used to start Netscape when your window manager is started. This allows wmnetselect to better emulate a docked Mozilla appicon. Defaults to y

-w <search engine>

Overrides the default search engine used on a right button click. Options include: google, altavista, yahoo, excite, hotbot, lycos, northernlight, alltheweb, or raging. Defaults to google. Misspellings will also get you google.

-v

Displays the release version.

Ctrl-left button click does not add a bookmark if Mozilla is not running.

Patrick Hill <apathos@bham.net>

Contributors include Jerome Auge, Benjamin Holzman, and Daniel Kreft.

http://members.home.net/happycorgi/apathos/wmnetsel.html