File: README.html

package info (click to toggle)
wmnetselect 0.85-5
  • links: PTS
  • area: main
  • in suites: woody
  • size: 472 kB
  • ctags: 91
  • sloc: ansic: 845; sh: 330; makefile: 53
file content (455 lines) | stat: -rw-r--r-- 17,354 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
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
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!-- Created 1 Feb 1999  Last modified 8 Aug 2000 -->
<HTML>
<HEAD>
<TITLE>wmnetselect: Window Maker Dock Applet</TITLE>
  <meta name="keywords" content="Window Maker, Dock Applet, Linux, Netscape, 
Mozilla">
</HEAD>

<BODY 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.85</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="#xpms">
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="wmnetxpm4.gif" alt="screenshot" WIDTH="64" HEIGHT="64">

<P><strong>wmnetselect version 0.85 released 8 August 2000.</strong></P>
<P><strong>Highlights of changes from previous version:</strong></P>

<ul>
<li> <P>Works with <a href="about:mozilla">Mozilla</a>!  (Milestone 17 and newer).</P>
<li> <P>User selectable search engine (with command line switch -w).
<BR>Choose from Google (default), Yahoo, Altavista, Raging, Excite, Hotbot, Lycos, Northernlight, or Alltheweb.</P>
<li> <P>Handles URLs with newlines and arbitrary whitespace.</P>
<li> <P>New command lines options for more flexibility.</P>
<li> <P>Automagically determines if selection is a local file.</P>
<li> <P>autoconfigure script for easy compilation on multiple architectures.</P>
<li> <P>RPMs for no compilation.</P>
<li> <P>Lots of bug fixes, more xpms, better documentation and a man page.</P>
</ul>

<P>See the <a href="ChangeLog">ChangeLog</a> for additional changes.</P>
<hr>
<P>Replace your Netscape (or Mozilla) docked appicon with my wmnetselect dock
applet to add these exciting features:<br>
<FONT SIZE="-1">(All occurrences of "Netscape" in this document can be 
substituted with "Mozilla" except where specifically noted.)</FONT></P>

<ul>
<li> <P>Double click left mouse button launches Netscape.<br>
       (Just like any docked window maker appicon).</P>
<li> <P>Single click middle mouse button sends X selection to<br>
        browser.<br>
       (Causes browser to go to URL represented by highlighted selection).</P>

<li> <P>Single click right mouse button sends X selection as queries to<br>
        user-chosen search engine. (Defaults to Google).</P>
<li> <P>Ctrl-click middle mouse button causes browser to open<br>
        the URL in a new window.</P>

<li> <P>Easily customized icons.</P>
<li> <P>Trims whitespace and newlines (carriage returns) from X selection.</P>
<li> <P>Short cuts for URLs to WindowMaker.org, Freshmeat, and Slashdot.</P>
<li> <P>GPL'd source code. (Some of the xpm's are MPL'd).</P>
</ul>

<br>
<a name="download"></a>
<table border="0" cellspacing="0" cellpadding="4" width="100%">
<tr>
<td align="center" bgcolor="#485068">
<table bgcolor="#ffffcc" border="0" cellspacing="0" cellpadding="4" width="100%">

<tr><td align="center">
<table width="65%" color="#485068" face="arial,helvetica" size="+1">
<tr>
<td> <!-- bgcolor="#ffffcc" -->
<STRONG>Source:</STRONG></td> <td><a
href="http://members.home.net/happycorgi/apathos/code/wmnetselect-0.85.tar.gz">wmnetselect-0.85.tar.gz</a>
</td> <td>(~123K)</td> </tr>

<tr> <td><STRONG>RPM (i386):</STRONG></td> <td><a
href="http://members.home.net/happycorgi/apathos/code/wmnetselect-0.85-1.i386.rpm">wmnetselect-0.85-1.i386.rpm</a>
</td> <td>(~40K)</td> </tr>

<tr>
<td><STRONG>RPM (sparc):</STRONG></td> <td> <a
href="http://members.home.net/happycorgi/apathos/code/wmnetselect-0.85-1.sparc.rpm">wmnetselect-0.85-1.sparc.rpm</a>
</td> <td>(~40K)</td> </tr>

<tr>
<td><STRONG>SRPM:</STRONG></td> <td><a
href="http://members.home.net/happycorgi/apathos/code/wmnetselect-0.85-1.src.rpm">wmnetselect-0.85-1.src.rpm</a>
</td> <td>(~127K)</td> </tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>

<br>
<h3>Middle Button Sends Selection to browser 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 your browser when you click on it.  In other words, if
you select this text:</P>

<pre><code>            http://www.dpo.uab.edu/~grapeape/wmfaq.html</code></pre>

<P>and click the middle mouse button on wmnetselect, it causes 
your browser to load the web page at this URL.  If Netscape 
is not running, wmnetselect will launch
Netscape, and cause 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 start the 
Netscape 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 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 will send the selection as a query
to the <a href="http://www.google.com">Google.com</a> search engine (by default). 
You can specify a different search engine with the <strong>-w</strong>
<a href="#options">command line option</a>. 
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>wmnetselect was designed specifically for the Window Maker window
manager, but should run on other window managers with varying
degrees of success.  I've personally tested it on Enlightenment, Sawfish, 
Fvwm2, and dtwm using CDE (running Solaris).</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 and newlines out of the X selection.  
Thanks to a patch from Dan Kreft  (bigdan at kreft.net), wmnetselect 
now correctly handles URLs such as:</P>
<pre>

             http://the.kreft. n e t/
 or:

             http://the.kreft	.net/

 or even:

             http://the.
                kreft.
                  net/
</pre>

<P>This is very useful when receiving email with long URLs that wrap across
lines.</P>

<P>wmnetselect has shortcuts for certain keywords.
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
for common (non-dotcom) websites.</P>

<P>Netscape can act a local file browser using a <code>file:/</code>
URL.  wmnetselect detects when the selection is a file (with pathname) and
supplies the <code>file:/</code> automatically.  To view the local version
this file using Netscape (assuming you untarred
the distribution in /usr/local/src/), select:</P>

<pre><code>            /usr/local/src/wmnetselect-0.85/README.html</code></pre>

<P>and middle-click on wmnetselect.</P>

<A name="xpms"></A>
<h3>Changing the xpm icons.</h3>

<img src="moz.gif" border="0" alt="" WIDTH="64" HEIGHT="64">

<P>wmnetselect provides feedback by displaying a different icon while it 
is processing a request.  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>

<hr>

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

<P>wmnetselect has many command line options to override the default behavior.
None of these options are required.  The default options should be acceptable 
to most users.</P>

<P><strong>Note:</strong>  many of the options have changed since the last
version.  Most options now require a <strong>y</strong> or <strong>n</strong> 
for yes or no.  This is to make the meaning more explicit.  The previous 
options were getting too confusing.</P>

<DL>
<DT><strong>-a &lt;y | n&gt; </strong>&nbsp; or &nbsp;
<strong>-ask &lt;y | n&gt;</strong>

<DD><P>When the X selection is blank or is all spaces, wmnetselect pops up
the Netscape <code>open URL dialog</code> allowing you to type in a URL.  
Supplying the <strong>-a n</strong> option
suppresses this behavior and just beeps if there is no selection.  (Use the 
<strong>-q y</strong> option to "quiet" the beep.)  Defaults to
<strong>y</strong>.</P>

<DT><strong>-d &lt;display&gt; </strong>&nbsp; or &nbsp;
<strong>-display &lt;display&gt;</strong>

<DD><P>Use an alternate X Display.</P>

<DT><strong>-e &lt;program&gt; </strong>&nbsp; or &nbsp;
<strong>-executable &lt;program&gt;</strong>

<DD><P>Use the <strong>-e</strong> option to specify an executable name other than
the netscape, (such as mozilla) or to specify the full path name of an 
executable not in your search path:</P>

<pre><code>            wmnetselect -e /usr/local/src/package/mozilla</code>
</pre>

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

<pre><code>            wmnetselect -e "netscape -no-about-splash"</code>
</pre>
 <P>Defaults to <strong>netscape</strong>.</P>


<DT><strong>-h</strong>&nbsp; or &nbsp;<strong>-help</strong>

<DD><P>Displays a short summary of the command line options.</P>


<DT><strong>-i &lt;y | n&gt; </strong>&nbsp; or &nbsp;
<strong>-infer-protocol &lt;y | n&gt;</strong>

<DD><P>wmnetselect uses a heuristic that supplies the
protocol of the URL when none is provided.  For example, if the selection
contains a <em>@</em> 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.
The <strong>-i n</strong> option suppresses this behavior and supplies the 
selection to netscape unaltered.  Defaults to <strong>y</strong>.</P>

<DT><strong>-p &lt;[+|-]x[+|-]y&gt; </strong>&nbsp; or &nbsp;
<strong>-position &lt;[+|-]x[+|-]y&gt;</strong>

<DD><P>Positions wmnetselect at a specific <strong>x y</strong>
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:</P>

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

<P>Defaults to <strong>+0+0</strong></P>


<DT><strong>-q &lt;y | n&gt; </strong>&nbsp; or &nbsp;
<strong>-quiet &lt;y | n&gt;</strong>

<DD><P>There are a few instances when wmnetselect uses an audible beep
to signify an error condition.  Use the <strong>-q y</strong>
option to suppress the audible error indication.  Defaults to
<strong>n</strong>.</P>

<DT><strong>-r &lt;y | n&gt; </strong>&nbsp; or &nbsp;
<strong>-raise &lt;y | n&gt;</strong>

<DD><P>Use <strong>-r n</strong> to prevent your browser from being deiconified
when the X selection is passed to it by wmnetselect.  (In other words, if
it is iconified, if stays iconified.)  The option is useful for CDE users
to prevent the browser from becoming "sticky".  Defaults to
<strong>n</strong>.</P>

<DT><strong>-s &lt;y | n&gt; </strong>&nbsp; or &nbsp;
<strong>-start &lt;y | n&gt;</strong>

<DD><P>This option starts netscape (by default) or the executable named in the
<strong>-e</strong> 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
<strong>n</strong>.</P>

<DT><strong>-w &lt;search engine&gt; </strong>&nbsp; or &nbsp;
<strong>-where &lt;search engine&gt;</strong>

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

<DT><strong>-v</strong>&nbsp; or &nbsp;<strong>-version</strong>

<DD><P>Displays the release version.</P>
</DL>

<hr>

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

<img src="wmnetxpm1.gif" border="0" alt="" WIDTH="64" HEIGHT="64">
<P>For quick Install instructions see the file: 
<a href="README.Install">README.Install</a></P>
<h4>RPM Install</h4>
<P>The i386 RPM was created on Redhat 6.2.  The sparc RPM was created on a
sparc 20 running Redhat 6.2.  Install the RPM like any other RPM file.  As root type:</P>

<pre><code>            rpm -Uhvv wmnetselect-0.85-1.i386.rpm</code></pre>

<P>Installs in <code>/usr/bin</code> by default.  Documentation will be in
<code>/usr/doc/wmnetselect-0.85</code></P>

<h4>Source Install</h4>
<P>wmnetselect now has a configure script.  It should compile without errors
on almost any Unix-type OS.  The configure script will verify that you have
dependencies required by wmnetselect [not many].  You will need
to have the XPM library in your library path. 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.  Most likely you already have some version
of the XPM library installed.</P>

<DL>
<DT><P>To untar the source of wmnetselect-0.85, cd to a convenient directory where
you have write permission and type:</P>

<DD><code>tar xfvz wmnetselect-0.85.tar.gz</code>

<DT>or
<DD><code>gzip -dc wmnetselect-0.85.tar.gz | tar xfv -</code>
<DT><P>Now cd to the directory wmnetselect-0.85 to make wmnetselect:</P>
<DD><code>./configure</code>
<DT>Then:
<DD><code>make</code>
<DT><P>To try it out type:</P>
<DD><code>./wmnetselect</code>
</DL>

<P>Select <code>slashdot</code> with your mouse and middle click on
wmnetselect's icon.  You should see a netscape window displaying the slashdot
main page.  If not, verify that an executable called <code>netscape</code>
is in your path.  [If <code>which netscape</code> does not return an error, it
should be in your path.]  Once you are satisfied that it works, type
<code>make install</code> as root, and wmnetselect will be installed in the
<code>/usr/local/bin</code> directory. You can override this location
with the configure script.  <code>./configure --help</code> displays the many
configure options, or see the INSTALL file.</P>

<h3>Acknowledgements</h3>

<P>wmnetselect was improved by patches from Jerome Auge, Benjamin Holzman, and
Daniel Kreft, and suggestions made by 
Morten Gulhaugen, Michael G. Henderson, Alan Jaffray, Sureshkumar Kaliannan, 
Andrea Mistrali, and Gert Scholten.  The original BSD port was submitted by 
David McNett.</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://members.home.net/happycorgi/apathos/wmnetsel.html">
http://members.home.net/happycorgi/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://members.home.net/happycorgi/apathos/index.html">
<strong>Apathos</strong></A>
</CENTER>
</TD>
</TR>
</TABLE></center>

</BODY>
</HTML>