File: wmnetselect.1

package info (click to toggle)
wmnetselect 0.85-6
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 488 kB
  • ctags: 91
  • sloc: ansic: 865; sh: 330; makefile: 54
file content (147 lines) | stat: -rw-r--r-- 4,573 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
.TH WMNETSELECT 1 "4 August 2000" 
.SH NAME
WMNETSELECT \- A dock applet to send the X selection to Netscape (or Mozilla)
.SH SYNOPSIS
.B 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>]

.SH DESCRIPTION
.PP
.B 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
Netscape (or Mozilla) 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 Netscape
to load the web page at this URL. If Netscape is not running, wmnetselect
will detect that, and launch Netscape, and then cause Netscape to load
the URL.

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

If Netscape 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 Netscape window is open. If Netscape is
not open, the Ctrl-left button will open Netscape 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 
.B -w
option (Google by default).  A Ctrl-right click will open a new window with
the results of the query.


.SH OPTIONS
.TP
.B \-a <y | n>
When the X selection is blank or is all spaces, wmnetselect pops up the
Netscape
.I open URL
dialog allowing you to type in a URL. Supplying the
.B -a n
option suppresses this behavior and just beeps if there is no
selection.  Defaults to
.B y
.TP
.B \-display <display>
Use an alternate X Display.
.B -d
will also work.
.TP
.B \-e <program>
Specifies an executable name other than netscape, (such as
mozilla) 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"

.TP
.B \-h
Display a short summary of the command line options.
.TP
.B \-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
.I @
and doesn't
contain any slashes (/), it is interpreted as an email address, and wmnetselect
opens the Netscape mail composer with the selected text in the
.I To:
field.  Supplying a
.B -i n
option suppresses this behavior and supplies the selection
to netscape unaltered.  Defaults to
.B y
.TP
.B \-p <[+|-]X[+|-]Y>
Positions wmnetselect at a specific
.B 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
.B +0+0
.TP
.B \-q <y | n>
Use the
.B -q y
option to suppress the audible error indication.  Defaults to
.B n
.TP
.B \-r <y | n>
Use
.B -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
.B n
.TP
.B \-s <y | n>
Starts netscape (by default) or the executable named in the
.B -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 Netscape appicon.  Defaults to
.B y
.TP
.B \-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
.B google\.
Misspellings will also get you google.
.TP
.B \-v
Displays the release version.
.SH BUGS
Ctrl-left button click does not add a bookmark if Netscape is not running.
.SH AUTHORS             
Patrick Hill <apathos@bham.net>
.TP 
Contributors include  Jerome Auge, Benjamin Holzman, and Daniel Kreft.
.SH LATEST VERSION             
http://members.home.net/happycorgi/apathos/wmnetsel.html