1<!doctype linuxdoc system>
2
3<manpage title="urlview" sectnum="1">
4
5<sect1>NAME
6<p>
7urlview - URL extractor/launcher
8
9<sect1>SYNOPSIS
10<p>
11urlview &lt;filename&gt; &lsqb; &lt;filename&gt; ... &rsqb;
12
13<sect1>DESCRIPTION
14<p>
15<em/urlview/ is a screen oriented program for extracting URLs from text
16files and displaying a menu from which you may launch a command to view a
17specific item.
18
19<sect1>CONFIGURATION
20<p>
21<em/urlview/ attempts to read <em>&tilde;/.urlview</em> upon startup.
22If this file doesn't exist, it will try to read a system wide file
23in <em>/usr/local/etc/urlview/system.urlview</em>. There are
24two configuration commands (order does not matter):
25<p>
26REGEXP &lt;regular expression to use for URL matching&gt;
27<p>
28
29<em/urlview/ uses a regular expression to extract URLs from the specified
30text files.  &bsol;r, &bsol;t, &bsol;n and &bsol;f are all converted to
31their normal printf(2) meanings.  The default REGEXP is
32
33<verb>
34(((http|https|ftp|gopher)|mailto):(//)?[^ <>"\t]*|(www|ftp)[0-9]?\.[-a-z0-9.]+)[^ .,;\t\n\r<">\):]?[^, <>"\t]*[^ .,;\t\n\r<">\):]
35</verb>
36
37<p>
38COMMAND &lt;command to launch with URL&gt;
39<p>
40If the specified command contains a ``&percnt;s'', it will be subsituted
41with the URL that was requested, otherwise the URL is appended to the
42COMMAND string.  The default COMMAND is
43<verb>
44	url_handler.sh '%s'
45</verb>
46another possibility would be
47<verb>
48	Netscape -remote 'openURL(%s)'
49</verb>
50<bf/NOTE:/ you should always put single quotes ('') around usage of
51``&percnt;s'' and never let the REGEXP to match any string containing
52a single quote (note <tt/&lsqb;&caret;&apos;...&rsqb;/ in the default REGEXP)
53to avoid characters in the selected URL from being interpreted
54by your shell.  For example, I could put the following URL in my email
55messages:
56<verb>
57	X-Nasty-Url: http://www.`program_to_execute_as_you`.com
58</verb>
59If you pass this URL to your shell, it could have nasty consequences.
60
61<p>
62QUITONLAUNCH
63<p>
64Will cause urlview to quit after you launch a URL.
65
66<sect1>FILES
67<p>
68<descrip>
69<tag>
70/usr/local/etc/urlview/system.urlview
71<p>
72system-wide urlview configuration file
73<tag>
74&tilde;/.urlview
75<p>
76urlview configuration file
77</descrip>
78
79<sect1>ENVIRONMENT
80<p>
81If the environment variable BROWSER is set to a browser command, or a
82colon-delimited list of commands to try, then the specified browser is
83used. %s is replaced with the quoted url to view. If %s is not part of a
84command, the url is appended to the command.
85<p>
86The BROWSER environment variable is honored only if the rc-file doesn't
87contain the COMMAND option.
88The rc-file provided by the Debian package contains a COMMAND option.
89
90<sect1>SEE ALSO
91<p>
92regcomp(3)
93
94<sect1>AUTHOR
95<p>
96Michael Elkins &lt;me@sigpipe.org&gt;.
97Modified for Debian by Luis Francisco Gonzalez &lt;luisgh@debian.org&gt; and Emanuele Rocca &lt;ema@debian.org&gt;.
98Modified for SuSE by Dr. Werner Fink &lt;werner@suse.de&gt; and Stepan Kasal &lt;kasal@suse.cz&gt;.
99</manpage>
100