README
1This program is FREE SOFTWARE. See the file COPYING for details.
2
3==================
4snarf version 2.0
5October 1, 1998
6==================
7
8Description
9-----------
10 Snarf is a utility I wrote to retrieve documents via the http and
11ftp protocols. It supports http redirect, http and ftp resume, http
12and ftp authentication, and other neat things.
13
14Usage
15-----
16 To use snarf to download a file from an url, type
17"snarf <your url>". This will transfer the file from the remote
18location to your computer. You can have as many URLs on the command
19line as you want: "snarf <URL> <URL> <URL>" will download three
20files. By default, it saves the file with the same name it had on the
21remote system; if you want to change this, you can do
22"snarf <URL> <filename>" and it will save your URL to the filename you
23provide.
24
25 To use the HTTP proxy feature, set the SNARF_PROXY, HTTP_PROXY,
26or FTP_PROXY environment variables to the address of your proxy, such
27as "proxy.mycompany.de:1080".
28
29 If you run snarf without any arguments, it prints some usage
30information.
31
32Notes
33-----
34 I wrote this in three days four years ago and it was majorly
35klugy, but it worked, and pretty niftily. I rewrote it from scratch
36over the past few days and I'm pleased to say that it's much nicer and
37cleaner inside, and this cleanliness has made it easy to add some
38features I always wanted to add to the old version.
39
40Version 2.0.3:
41
42 This version has a configure option of
43"--with-guess-winsize". This feature uses ioctl to determine what your
44operating system things the width of your terminal is. It's not
45enabled by default, because I don't know how well it works on all
46platforms. It's safe to enable on Linux and Solaris. If you manage to
47get it to work somewhere else, let me know.
48
49Email: xach@xach.com
50
51Snail mail: Zachary Beane, 17 Talmadge Rd., Waite, ME 04492, USA
52
53
54