NAME
WMNETSELECT - A dock applet to send the X selection to Firefox (or
Seamonkey)
SYNOPSIS
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>]
DESCRIPTION
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
Firefox (or Seamonkey) 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 Firefox
to load the web page at this URL. If Firefox is not running,
wmnetselect will detect that, and launch Firefox, and then cause
Firefox to load the URL.
If you select the text apathos @ bham.net and click the middle mouse
button on wmnetselect, it will start the Firefox mail composer with the
selected text in the To: field.
If Firefox 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 Firefox 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 Firefox window is open. If Firefox
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.
OPTIONS
-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
Firefox) or specifies the full path name of an executable that
is not in your search path:
wmnetselect -e /usr/bin/mozilla
If you want to pass parameters to the executable put them in
quotes:
wmnetselect -e "firefox -safe-mode"
-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
Firefox mail composer with the selected text in the To: field.
Supplying a -i n option suppresses this behavior and supplies
the selection to Firefox 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 Firefox (by default) or the executable named in the -e
option when wmnetselect is started. This can be used to start
Firefox when your window manager is started. This allows
wmnetselect to better emulate a docked Firefox 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.
BUGS
Ctrl-left button click does not add a bookmark if Firefox is not
running.
AUTHORS
Patrick Hill <apathos@bham.net>
Contributors include Jerome Auge, Benjamin Holzman, and Daniel Kreft.
LATEST VERSION
http://members.home.net/happycorgi/apathos/wmnetsel.html
4 August 2000