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
|
.if n .ds Q \&"
.if t .ds Q ``
.if n .ds U \&"
.if t .ds U ''
.TH "urlview" 1
.tr \&
.nr bi 0
.nr ll 0
.nr el 0
.de DS
..
.de DE
..
.de Pp
.ie \\n(ll>0 \{\
.ie \\n(bi=1 \{\
.nr bi 0
.if \\n(t\\n(ll=0 \{.IP \\(bu\}
.if \\n(t\\n(ll=1 \{.IP \\n+(e\\n(el.\}
.\}
.el .sp
.\}
.el \{\
.ie \\nh=1 \{\
.LP
.nr h 0
.\}
.el .PP
.\}
..
.SH NAME
.Pp
urlview - URL extractor/launcher
.Pp
.SH SYNOPSIS
.Pp
urlview <filename> [ <filename> ... ]
.Pp
.SH DESCRIPTION
.Pp
\fIurlview\fP 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.
.Pp
.SH CONFIGURATION
.Pp
\fIurlview\fP attempts to read \fI~/.urlview\fP upon startup. If this file
doesn't exist, it will try to read a system wide file
in \fI/etc/urlview/system.urlview\fP. There are
two configuration commands (order does not matter):
.Pp
REGEXP <regular expression to use for URL matching>
.Pp
.Pp
\fIurlview\fP uses a regular expression to extract URLs from the specified
text files. \\r, \\t, \\n and \\f are all converted to
their normal printf(2) meanings. The default REGEXP is
.Pp
.DS
.sp
.ft RR
.nf
((((ht|f)tp)|mailto):(//)?[^ >"\t]*|www\.[-a-z0-9.]+)[^ .,;\t>">]
.DE
.fi
.ec
.ft P
.sp
.Pp
.Pp
COMMAND <command to launch with URL>
.Pp
If the specified command contains a ``%s'', it will be subsituted
with the URL that was requested, otherwise the URL is appended to the
COMMAND string. The default COMMAND is
.DS
.sp
.ft RR
.nf
netscape -remote 'openURL(%s)'
.DE
.fi
.ec
.ft P
.sp
\fBNOTE:\fP you should always put single quotes ('') around usage of
``%percnt;s'' 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:
X-Nasty-Url: http://www.`program_to_execute_as_you`.com
If you pass this URL to your shell, it could have nasty consequences.
.Pp
.SH FILES
.Pp
.nr ll +1
.nr t\n(ll 2
.if \n(ll>1 .RS
.IP "/etc/urlview/system.urlview"
.nr bi 1
.Pp
system-wide urlview configuration file
.IP "~/.urlview"
.nr bi 1
.Pp
urlview configuration file
.if \n(ll>1 .RE
.nr ll -1
.Pp
.SH SEE ALSO
.Pp
regcomp(3)
.Pp
.SH AUTHOR
.Pp
Michael Elkins <me@cs.hmc.edu>
Modified for Debian by Luis Francisco Gonzalez <luisgh@debian.org>
.Pp
|
