← Back to branch summary

~ubuntu-branches/ubuntu/raring/surfraw/raring

« back to all changes in this revision

Viewing changes to surfraw.1.IN

  • Committer: Bazaar Package Importer
  • Author(s): Ian Beckwith
  • Date: 2008-03-11 14:07:35 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080311140735-8s6dh1auyn1ot7bi
Tags: 2.2.1-2
Remove my old email address from Uploaders.

Show diffs side-by-side

added added

removed removed

Lines of Context:
surfraw.1.IN
24
24
.B sr
25
25
.I elviname  [options]  search words ...
26
26
.br
27
 
.B sr -elvi
 
27
.B sr \-elvi
28
28
.br
29
29
.B sr
30
30
.I bookmark
35
35
Surfraw provides a fast unix command line interface to a variety of
36
36
popular WWW search engines and other artifacts of power.
37
37
It reclaims google, altavista, dejanews, freshmeat, research index,
38
 
slashdot and many others from the false-prophet, pox-infested heathen
39
 
lands of html-forms, placing these wonders where they belong, deep in
 
38
slashdot and many others from the false\(hyprophet, pox\(hyinfested heathen
 
39
lands of html\(hyforms, placing these wonders where they belong, deep in
40
40
unix heartland, as god loving extensions to the shell.
41
41
 
42
42
.PP
65
65
of typing sr or surfraw each time. You can regain the old
66
66
behaviour of running the elvi directly by adding the elvi
67
67
directory (\%@ELVIDIR@) to your path, either manually or using
68
 
\fB\%surfraw-update-path(1)\fP.
 
68
\fB\%surfraw\-update\-path(1)\fP.
69
69
 
70
70
.SS Bookmarks
71
71
 
87
87
 
88
88
.SH OPTIONS
89
89
 
90
 
Use     \fB\%sr elviname \-help\fP for elvi-specific options.
 
90
Use     \fB\%sr elviname \-help\fP for elvi\(hyspecific options.
91
91
 
92
92
The following options work with all elvi.
93
93
 
94
94
.TP
95
95
.B \-help
96
 
Show summary of options (including elvi-specific options).
 
96
Show summary of options (including elvi\(hyspecific options).
97
97
 
98
98
.TP
99
99
.B \-version
101
101
 
102
102
.TP
103
103
\fB\-browser=\fP\fIEXECUTABLE\fP
104
 
Set browser (default: sensible-browser).
 
104
Set browser (default: sensible\-browser).
105
105
 
106
106
.TP
107
107
.B \-elvi
108
108
Display a list of other Surfraw mechanisms for conquering evil.
109
109
 
110
110
.TP
111
 
.B \-escape-url-args=yes|no
 
111
.B \-escape\-url\-args=yes|no
112
112
Apply url escaping to arguments (default: yes)
113
113
 
114
114
.TP
146
146
.PP
147
147
 
148
148
@sysconfdir@/surfraw.conf and $HOME/.surfraw.conf are both fragments of
149
 
bourne-shell style shell script.
 
149
bourne\(hyshell style shell script.
150
150
 
151
151
@sysconfdir@/surfraw.conf should use def and defyn to define variables.
152
152
These functions set variables unless they are already set by the
157
157
 def     SURFRAW_text_browser   /usr/bin/lynx
158
158
 defyn   SURFRAW_graphical              no
159
159
 
160
 
$HOME/.surfraw.conf should use sh-style entries, eg:
 
160
$HOME/.surfraw.conf should use sh\(hystyle entries, eg:
161
161
 
162
162
 SURFRAW_text_browser=/usr/bin/lynx
163
163
 SURFRAW_graphical=no
177
177
 
178
178
.TP
179
179
.B SURFRAW_conf
180
 
Location of per-user configuration file.
 
180
Location of per\(hyuser configuration file.
181
181
 
182
182
Default:
183
183
 
198
198
 
199
199
Default:
200
200
 
201
 
def SURFRAW_text_browser sensible-browser
 
201
def SURFRAW_text_browser sensible\-browser
202
202
 
203
203
.TP
204
204
.B SURFRAW_graphical_browser
207
207
 
208
208
Default:
209
209
 
210
 
 def SURFRAW_graphical_browser sensible-browser
 
210
 def SURFRAW_graphical_browser sensible\-browser
211
211
 
212
212
.TP
213
213
.B SURFRAW_text_browser_args
227
227
 
228
228
.TP
229
229
.B SURFRAW_graphical_remote
230
 
Whether to use "\fB-remote openURL\fP" for graphical browser.
 
230
Whether to use "\fB\-remote openURL\fP" for graphical browser.
231
231
 
232
232
Default:
233
233
 
277
277
 
278
278
.TP
279
279
.B SURFRAW_quote_ifs
280
 
Whether to re-quote arguments if they have spaces in, ie so:
 
280
Whether to re\(hyquote arguments if they have spaces in, ie so:
281
281
 sr google foo "bar baz" bam
282
282
.br
283
283
works as expected.
316
316
 
317
317
.TP
318
318
.B $HOME/.surfraw.conf
319
 
Default per-user config file
 
319
Default per\(hyuser config file
320
320
 
321
321
.TP
322
322
.B @sysconfdir@/surfraw.bookmarks
324
324
 
325
325
.TP
326
326
.B $HOME/.surfraw.bookmarks
327
 
Per-user bookmarks file.
 
327
Per\(hyuser bookmarks file.
328
328
 
329
329
.SH BUGS
330
330
 
331
331
Please report any bugs found (or any web sites in need of surfrawizing)
332
332
either via the debian bug tracking system (\%http://bugs.debian.org/) or
333
 
to the surfraw-devel list (\%surfraw-devel@lists.alioth.debian.org).
 
333
to the surfraw\-devel list (\%surfraw\-devel@lists.alioth.debian.org).
334
334
 
335
335
.SH SEE ALSO
336
336
 
353
353
Bear witness to the truth.
354
354
Its love will set you free.
355
355
 
356
 
Join us on surfraw-devel@lists.alioth.debian.org
 
356
Join us on surfraw\-devel@lists.alioth.debian.org
357
357
 
358
358
.SH AUTHORS
359
359
 
360
360
Originally written by Julian Assange.
361
361
 
362
 
Now maintained by the surfraw-devel team
363
 
<\%surfraw-devel@lists.alioth.debian.org>.
 
362
Now maintained by the surfraw\-devel team
 
363
<\%surfraw\-devel@lists.alioth.debian.org>.
364
364
 
365
365
See the file AUTHORS for the full list of contributors.
366
366
 
369
369
 
370
370
.SH COPYRIGHT
371
371
 
372
 
  Copyright (c) 2003-2006 The Surfraw-Devel Team
373
 
                           <surfraw-devel@lists.alioth.debian.org>
 
372
  Copyright (c) 2003-2008 The Surfraw\-Devel Team
 
373
                           <surfraw\-devel@lists.alioth.debian.org>
374
374
  Copyright (c) 2000-2001 Julian Assange <proff@iq.org>
375
375
  Copyright (c) 2001 Australian Institute for Collaborative Research
376
376
  Copyright (c) 2000 Melbourne Institute for Advanced Study