File: README.html

package info (click to toggle)
wmnetselect 0.8-4
  • links: PTS
  • area: main
  • in suites: potato
  • size: 256 kB
  • ctags: 370
  • sloc: ansic: 720; makefile: 385
file content (342 lines) | stat: -rw-r--r-- 13,475 bytes parent folder | download
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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!-- Created 1 Feb 1999  Last modified 21 Apr 1999 -->
<HTML>
<HEAD>
<TITLE>wmnetselect: Window Maker Dock Applet</TITLE>
  <meta name="keywords" content="Window Maker, Dock Applet, Linux, Netscape, Mozilla">
</HEAD>
<BODY BGCOLOR="#C0C0C0">

<!-- BODY TEXT="#000000" LINK="#0000FF" VLINK="#551A8B" ALINK="#FF0000"
BGCOLOR="#C0C0C0" -->

<table border="0" cellspacing="0" cellpadding="4" width="100%">
<tr>
<td align="center" colspan="2">
<table border="0" cellspacing="0" cellpadding="4" width="100%">
<tr>
<td bgcolor="#485068"><font color="white" face="arial,helvetica" size="+1"><b>
wmnetselect Version 0.8</b></font></td>
<td align="right" bgcolor="#485068"><font color="white" face="arial,helvetica"
size="+1"><b>Window Maker Dock Applet</b></font></td>
</tr>
</table>
</td>
</tr>
</table>

<center>
<table border="0" cellspacing="0">
<tr bgcolor="ffffcc">
<td align="center"><font color="black" size="-1" face= 
"arial,helvetica">&nbsp;<a href="#download">
Download</a>&nbsp;</font></td>
<td align="center">|</td>
<td align="center"><font color="black" size="-1"
face="arial,helvetica">&nbsp;<a href="#features">
Other&nbsp;Features</a>&nbsp;</font></td>
<td align="center">|</td>
<td align="center"><font color="black" size="-1" face= 
"arial,helvetica">&nbsp;<a href="#options">
Options</a>&nbsp;</font></td>
<td align="center">|</td>
<td align="center"><font color="black" size="-1" face= 
"arial,helvetica">&nbsp;<a href="#install">
Install</a>&nbsp;</font></td>
<td align="center">|</td>
<td align="center"><font color="black" size="-1" face= 
"arial,helvetica">&nbsp;<a href="NewXPMs.txt">
XPMs</a>&nbsp;</font></td>
<td align="center">|</td>
<td align="center"><font color="black" size="-1" face= 
"arial,helvetica">&nbsp;<a href="ChangeLog">
ChangeLog</a>&nbsp;</font></td>
</tr>
</table>
</center>

<img src="images/wmnetxpm4.gif" border="2" alt="" WIDTH="64" HEIGHT="64">

<P><strong>wmnetselect version 0.8 released  22 Apr 1999.</strong></P>
<P><strong>Highlights of changes from previous version:</strong></P>

<ul>
<li> <P>Much faster, less resource-intensive.</P>
<li> <P>Search Google.com with one click on right button.</P>
<li> <P>Email addresses now launch Netscape's mail composer.</P>
<li> <P>Add Netscape bookmarks with one click on ctrl-left button.</P>
<li> <P>Prompts for URL when nothing or only spaces selected.</P>
<li> <P>New <a href="#options">command line options</a>, include starting Netscape on startup.</P>
<li> <P>Encodes "unsafe" characters per RFC1738.</P>
</ul>

<P>See the <a href="ChangeLog">ChangeLog</a> for additional changes.</P>
<hr>
<P>Replace your Netscape docked appicon with my wmnetselect dock
applet to add these exciting features:</P>

<ul>
<li> <P>Double click left mouse button to launch Netscape<br>
       (Just like any docked window maker appicon).</P>
<li> <P>Single click middle mouse button to send X selection to<br>
        Netscape, (causes Netscape to go to URL represented by selection).</P>

<li> <P>Ctrl-click middle mouse button to instruct Netscape to open<br>
        a new window with URL.</P>

<li> <P>Easily customized icons.</P>
<li> <P>Trims whitespace from X selection.</P>
<li> <P>Short cuts for WindowMaker.org, Freshmeat, and Slashdot.</P>
<li> <P>GPL'd source code.</P>
</ul>

<A name="download"></A>
<table border="0" cellspacing="0" cellpadding="4" width="100%">
<tr>
<td align="center" bgcolor="#485068">
<table border="0" cellspacing="0" cellpadding="4" width="100%">
<tr>
<td bgcolor="#ffffcc"><center><font color="#485068" face="arial,helvetica" size="+1"><b>
Download:&nbsp;&nbsp; &nbsp;&nbsp;<a href="code/wmnetselect-0.8.tar.gz">wmnetselect-0.8.tar.gz</a>
</b> &nbsp; &nbsp;&nbsp;&nbsp;(~70K)</font></center></td>
</tr>
</table>
</td>
</tr>
</table>

<h3>Middle Button Sends Selection to Netscape as URL</h3>

<P>wmnetselect is a <a href="http://www.windowmaker.org">Window Maker</a>
dock applet that makes all text on
your X display internet-aware, sort of.  wmnetselect sends the X
selection to Netscape when you click on it.  In other words, if
you select this text:</P>

<P><code>http://people.delphi.com/crc3419/WMUserGuide/index.htm</code></P>

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

<P>If you select the text: <em>apathos@bham.net</em> and click the
middle mouse button on wmnetselect, it will instruct Netscape
to start the mail composer with the selected text in the "To:"
field.</P>

<P>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 button on wmnetselect).</P>

<h3>Double Click Left Button to Launch Netscape</h3>

<P>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.</P>

<h3>Ctrl-(Single Click Left Button) to Add a Bookmark</h3>

<P>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.  For now, if Netscape
is not open, the Ctrl-Left button will open Netscape to the selected text,
but add no bookmark.  This is considered a bug, and hopefully will be fixed
in a future version.</P>

<h3>Right Button Sends Selection to Google.com as a Query</h3>

<P>A single click of the Right mouse button send the selection as a query
to the <a href="http://www.google.com">Google.com</a> search engine.
A Ctrl-Right mouse button will open a new window with the results of the
query.  (Click near the middle of the icon. A Right click in the edge of the
icon brings up a Window Maker menu.)</P>

<P>For example, if you select <code>Window Maker</code> and click the right
mouse button on wmnetselect, you will soon be seeing the first 30 "hits" for
Window Maker found by the Google search engine in your Netscape browser window.
wmnetselect's search engine queries were suggested by both Alan Jaffray and
Jerome Auge.</P>

<P><em>URLs cannot (legally) contain spaces, but of course search engine
queries can.  wmnetselect transforms spaces to plus signs to facilitate
searches.</em></P>

<P>wmnetselect was designed specifically for the Window Maker window
manager, but should run on other window managers with varying
degrees of success.</P>

<BR>
<A name="features"></A>
<h3>Other Features</h3>

<P>wmnetselect has some other convenient features to enhance your
surfing pleasure.</P>

<P>wmnetselect trims whitespace from the ends of the X selection.
You can be a little sloppy with the selection, by including
newlines, or extra blank space on either end. wmnetselect will
trim the offending whitespace to prevent Netscape from barfing.</P>

<P>As you may know, Netscape has a feature that tries to turn any
word into a URL.  For example, if you type LinuxToday in
Netscape's <code>Location:</code> entry box, Netscape will turn LinuxToday into
<A HREF="http://www.linuxtoday.com.">http://www.linuxtoday.com.</A>  wmnetselect allows you to take full
advantage of this feature.  Just select the word <code>linuxhq</code>, and
middle-click on wmnetselect to find the latest Linux kernel.</P>
 
<P>Unfortunately, if you type <code>windowmaker</code>, into Netscape's location
entry box, you will soon be looking at www.windowmaker.com when
you most likely wanted to go to www.windowmaker.org instead. 
wmnetselect turns <code>windowmaker</code> into windowmaker.org,
<code>freshmeat</code> into freshmeat.net, and <code>slashdot</code> into
slashdot.org, allowing you to select the word <code>slashdot</code> and
view the slashdot home page with one click on wmnetselect.  If you ever want
to go to windowmaker.com for some bizarre reason, just select
windowmaker.com instead of windowmaker.  Of course you can
select the full url, http://www.slashdot.org also, these are just shortcuts. 
</P>

<P>Netscape can act as kind of a local file browser using a <code>file:/</code>
URL.  To view the local version this file using Netscape (assuming you untarred
the distribution in /usr/local/src/), select:</P>

<P><code>file:/usr/local/src/wmnetselect-0.8/README.html</code></P>

<P>and click on wmnetselect.  (Notice there is only one slash after the colon,
<code>file://</code> will not work.)</P>

<P>wmnetselect attempts to provide you feedback by displaying a
different icon while it is processing your request.  This feature
is somewhat immature at this point, but the icon does change briefly
after you click on wmnetselect.</P>

<h3>Changing the xpm icons.</h3>

<img src="images/wmnetxpm1.gif" border="2" alt="" WIDTH="48" HEIGHT="48">

<P>You can easily change the icons wmnetselect uses.  How to do this
is discussed in the file <a href="NewXPMs.txt">NewXPMs.txt</a></P>

<A name="options"></A>
<h3>Command line options</h3>

<P>wmnetselect has 6 command line options: -d (dontask), -e (executable name),
-n (noprotocol), -o (onstartup), -p (position), and -q (quiet).</P>

<P>No options are required.  They are all used to overide the default options,
which should be acceptable to most users.</P>

<P><strong>-d or -dontask</strong></P>

<P>When the X selection is blank or is all spaces, wmnetselect now pops up
the Netscape open URL dialog "asking" you to type in a URL.  The -d option
suppresses this behavior and just beeps if there is no selection.  Use the -q
along with the -d option to "quiet" the beep.  Prompting for a URL was
suggested by Morten Gulhaugen.</P>

<P><strong>-e or -executable</strong></P>

<P>Use the -e option to specify an executable name other than
netscape, or specify the full path name if an executable called netscape
is not in your search path.  If you have multiple versions of Netscape
installed, as I do, use the -e option to specify the one to use
with wmnetselect, ie:</P>

<P><code>wmnetselect -e /usr/local/netscape4/netscrape</code></P>

<P>If you want to pass parameters to the executable put them in quotes:</P>

   <P><code>wmnetselect -e "netscrape -no-about-splash"</code></P>
 
<P><strong>-n or -noprotocol</strong></P>

<P>wmnetselect uses a heuristic (enhanced by Jerome Auge) that supplies the
protocol of the URL when none is provided.  For example, if the selection
contains a "@" 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 "To:" field.  See the ChangeLog file for more details.
Use the -n option to prevent any interpretation of the selection.</P>

<P><strong>-o or -onstartup</strong></P>

<P>This option 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 Netscape appicon.  Suggested by Michael Henderson.</P>

<P><strong>-p or -position</strong></P>

<P>Use the -p option to position wmnetselect at a specific location
on your display.  This option is not needed for Window Maker,
it's mostly there for other window managers.  To position
wmnetselect near the top left corner of the display, use:</P>

<P><code>wmnetselect -p +800+40</code></P>

<P><strong>-q or -quiet</strong></P>

<P>There are a (very) few instances when wmnetselect uses an audible beep
to signify an error condition.  (See the description of the -d option
for one example.)  Use the -q option (formerly -s) to keep wmnetselect
completely quiet.</P>


<A name="install"></A>
<h3>Installing wmnetselect</h3>

<P>To untar the source of wmnetselect-0.8, cd to a convenient directory that
you have write permission in and type:</P>

   <code>tar xfvz wmnetselect-0.8.tar.gz</code>
<P>or</P>
   <code>gzip -dc wmnetselect-0.8.tar.gz | tar xfv -</code>

<P>Now cd to the directory wmnetselect-0.8 and make wmnetselect.</P>
<P>wmnetselect includes an Imakefile.  To make wmnetselect type:</P>

<P><code> xmkmf ; make</code></P>

<P>If you don't have xmkmf, you can attempt to use my makefile. 
Just rename mymakefile to Makefile, and type make.  You will need
to have the XPM library in your library path. According to the
documentation I have, xpm-3.4k can be found at
<A HREF="ftp://ftp.x.org/contrib/libraries/xpm-3.4k.tar.gz">
ftp://ftp.x.org/contrib/libraries/xpm-3.4k.tar.gz</A>,
but there may be newer versions.</P>

<P>If you do a make install, the make file will attempt to install
wmnetselect in directory /usr/X11R6/bin.  I suggest just copying
it by hand to /usr/local/bin instead.</P>

<P>For now, this file serves as the man page for wmnetselect.</P>

<h3>Acknowledgements</h3>

<P>wmnetselect was improved by suggestions made by Jerome Auge,
Morten Gulhaugen, Michael G. Henderson, Alan Jaffray, and Andrea Mistrali.</P>

<br>
<h3>Send bugs and bugfixes to Patrick Hill, <a
href="mailto:apathos
@bham.net">apathos@bham.net</a></h3>

<P><font =-1>The latest version of this documentation is located at <a
href="http://home.att.net/~apathos/wmnetsel.html">
http://home.att.net/~apathos/wmnetsel.html</a></font></P>

<P><a href="TODO">TODO</a> list.</P>

<HR><center>
<BR>
<TABLE CELLPADDING="5" BORDER="1">
<TR>
<TD WIDTH=250 BGCOLOR="#FFCC33">
<CENTER><A
HREF="http://home.att.net/~apathos/index.html"><strong>Apathos</strong></A>
</CENTER>
</TD>
</TR>
</TABLE></center>

</BODY>
</HTML>