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 <filename> [ <filename> ... ] 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>˜/.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 <regular expression to use for URL matching> 27<p> 28 29<em/urlview/ uses a regular expression to extract URLs from the specified 30text files. \r, \t, \n and \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 <command to launch with URL> 39<p> 40If the specified command contains a ``%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``%s'' and never let the REGEXP to match any string containing 52a single quote (note <tt/[⁁'...]/ 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˜/.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 <me@sigpipe.org>. 97Modified for Debian by Luis Francisco Gonzalez <luisgh@debian.org> and Emanuele Rocca <ema@debian.org>. 98Modified for SuSE by Dr. Werner Fink <werner@suse.de> and Stepan Kasal <kasal@suse.cz>. 99</manpage> 100