File: urlview.sgml

package info (click to toggle)
urlview 0.9-11
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 316 kB
  • ctags: 94
  • sloc: ansic: 1,710; sh: 523; makefile: 57
file content (94 lines) | stat: -rw-r--r-- 2,857 bytes parent folder | download | duplicates (8)
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
<!doctype linuxdoc system>

<manpage title="urlview" sectnum="1">

<sect1>NAME
<p>
urlview - URL extractor/launcher

<sect1>SYNOPSIS
<p>
urlview &lt;filename&gt; &lsqb; &lt;filename&gt; ... &rsqb;

<sect1>DESCRIPTION
<p>
<em/urlview/ is a screen oriented program for extracting URLs from text
files and displaying a menu from which you may launch a command to view a
specific item.

<sect1>CONFIGURATION
<p>
<em/urlview/ attempts to read <em>&tilde;/.urlview</em> upon startup.
If this file doesn't exist, it will try to read a system wide file 
in <em>/etc/urlview/system.urlview</em>. There are
two configuration commands (order does not matter):
<p>
REGEXP &lt;regular expression to use for URL matching&gt;
<p>

<em/urlview/ uses a regular expression to extract URLs from the specified
text files.  &bsol;r, &bsol;t, &bsol;n and &bsol;f are all converted to
their normal printf(2) meanings.  The default REGEXP is

<verb>
(((http|https|ftp|gopher)|mailto):(//)?[^ <>"\t]*|(www|ftp)[0-9]?\.[-a-z0-9.]+)[^ .,;\t\n\r<">\):]?[^, <>"\t]*[^ .,;\t\n\r<">\):]
</verb>

<p>
COMMAND &lt;command to launch with URL&gt;
<p>
If the specified command contains a ``&percnt;s'', it will be subsituted
with the URL that was requested, otherwise the URL is appended to the
COMMAND string.  The default COMMAND is
<verb>
	url_handler.sh '%s'
</verb>
another possibility would be
<verb>
	Netscape -remote 'openURL(%s)'
</verb>
<bf/NOTE:/ you should always put single quotes ('') around usage of
``&percnt;s'' and never let the REGEXP to match any string containing
a single quote (note <tt/&lsqb;&caret;&apos;...&rsqb;/ in the default REGEXP)
to avoid characters in the selected URL from being interpreted
by your shell.  For example, I could put the following URL in my email
messages:
<verb>
	X-Nasty-Url: http://www.`program_to_execute_as_you`.com
</verb>
If you pass this URL to your shell, it could have nasty consequences.

<sect1>FILES
<p>
<descrip>
<tag>
/etc/urlview/system.urlview
<p>
system-wide urlview configuration file
<tag>
&tilde;/.urlview
<p>
urlview configuration file
</descrip>

<sect1>ENVIRONMENT
<p>
If the environment variable BROWSER is set to a browser command, or a
colon-delimited list of commands to try, then the specified browser is
used. %s is replaced with the quoted url to view. If %s is not part of a
command, the url is appended to the command.
<p>
The BROWSER environment variable is honored only if the rc-file doesn't 
contain the COMMAND option.
The rc-file provided by the Debian package contains a COMMAND option.

<sect1>SEE ALSO
<p>
regcomp(3)

<sect1>AUTHOR
<p>
Michael Elkins &lt;me@cs.hmc.edu&gt;.
Modified for Debian by Luis Francisco Gonzalez &lt;luisgh@debian.org&gt; and Emanuele Rocca &lt;ema@debian.org&gt;.
Modified for SuSE by Dr. Werner Fink &lt;werner@suse.de&gt; and Stepan Kasal &lt;kasal@suse.cz&gt;.
</manpage>