Since the tinyproxy program has changed, the manual had to change as well.

Documents all the command line arguments, though I think I need to
document the configuration file as well.

doc/tinyproxy.8

@@ -2,155 +2,62 @@
 .\"
 .\" tinyproxy.1
 .\"
-.\" Copyright (c) 1999, Robert James Kaes, Steven Young.
+.\" Copyright (c) 1998-2000  Steven Young and Robert James Kaes.
 .\"
 .\" This program is distributed under the terms of the GNU General Public
 .\" License. See COPYING for additional information.
 .\"
-.TH tinyproxy 1 "December 23, 1999" "tinyproxy" "tinyproxy Manual"
+.TH tinyproxy 1 .\" "tinyproxy Manual" v1.3.4 "August 3, 2000"
 .SH NAME
-tinyproxy \- a small HTTP proxy server
+tinyproxy - A small HTTP proxy server
-.SH SYNOPSIS
+.SH SYNTAX
-tinyproxy [options]
+\fBtinyproxy\fR [ \fBoptions\fR ]
+.SH VERSION
+This man page documents tinyproxy version 1.3.4.
 .SH DESCRIPTION
-.B tinyproxy
+\fBtinyproxy\fR is an HTTP proxy server designed to consume a minimum of
-is an HTTP proxy server designed to consume a minimum of system resources.
+system resources. It listens on a given TCP port and handles HTTP proxy
-It listens on a given TCP port and handles HTTP proxy requests.
+requests.
 .SH OPTIONS
-.TP 5
+.IP "-c config_file"
-.BI "\-a headername"
+Use an alternate configuration file.
-Allow the header
+.IP -d
-.I headername
+Don't daemonize; stay in the foreground. Useful for debugging purposes.
-through to the server (anon mode only).  It is highly recommended that you
+.IP -h
-specify -a Host: and -a Authorization:, otherwise HTTP/1.1 virtual domains
-and basic authentication will fail. If anon mode is compiled into the
-program, but you do not provide a
-.I headername
-tinyproxy will run as if anon mode was not compiled in.
-.TP 5
-.BI "\-d" 
-Don't daemonize; stay in the foreground.
-.TP 5
-.BI "\-f filterfile"
-Block any sites/URL which are specified in the
-.I filterfile
-The domains/URLs are specified in a flat text file with one filter per line.
-.TP 5
-.BI "\-h"
 Display a short help screen of command line arguments and exit.
-.TP 5
+.IP -v
-.BI "\-i ip_address"
-Only listen to the specific address. Useful for systems with more than one
-network connection.
-.I ip_address
-needs to be in the dotted-decimal form (e.g. 192.168.0.1)
-.TP 5
-.BI "\-l logfile"
-Log to the file
-.I logfile
-instead of the default
-.B /var/log/tinyproxy.
-The default can be changed at compile time using the
-.B "\-\-with\-log\-file"
-directive.
-.TP 5
-.BI "\-n ip_address"
-Allow access from only those hosts in the subnet.
-.I ip_address
-should be of a form xxx.xxx.xxx. like 192.168.0.
-.TP 5
-.BI "\-p port"
-Listen to
-.I port
-instead of the default
-.B 8888.
-The default can be changed at compile time by using the
-.B "\-with\-port"
-directive.
-.TP 5
-.BI "\-r"
-Restrict the log file to only logging error conditions. The hosts connecting
-and the locations being accessed are not logged.
-.TP 5
-.BI "\-s stathost"
-Set the status host to
-.I stathost
-.TP 5
-.BI "\-S"
-Log to the syslog daemon
-.TP 5
-.BI "\-t domain:port"
-If you would like to use an upstream proxy along with tinyproxy then set
-this option. The
-.I domain
-is the address of the proxy, and the
-.I port
-is the
-decimal port number. The address can be either alphanumeric, or dotted-decimal.
-.TP 5
-.BI "\-u username"
-Begin running as
-.I username
-after the port has been bound and the logfile has been opened.  Only
-works if tinyproxy is being run as root.  "" to disable.
-.TP 5
-.BI "\-v"
 Display version information and exit.
-.TP 5
-.BI "\-w loadaverage"
-Stop handling requests when the load is
-.I loadaverage
-or higher.  Specifying a
-.I loadaverage
-of 0.00 will disable this feature.
-(disabled by default)
-.TP 5
-.BI "\-x domain"
-Add a
-.B XTinyproxy
-header with the peer's IP address.
-.I domain
-tells tinyproxy which domains to include the
-.B XTinyproxy
-header on. Basically, set this if you want to include the header only on
-your sites. Else, set to "" to have it sent on all connections.
 .SH SIGNALS
 In addition to these command line options, there are also several signals
 that can be sent to tinyproxy while it is running to generate debugging
 information and to force certain events.
 .TP 5
-.B SIGUSR1
-Dump a summary of all current connections to the logfile.
-.TP 5
 .B SIGHUP
-Force
+Force \fBtinyproxy\fR to do a garbage collection on the current connections
-.B tinyproxy
+linked list.  This is usually done automatically after a certain number of
-to do a garbage collection on the current connections linked list.  This
+connections have been handled.
-is usually done automatically after a certain number of connections have
-been handled.
 .SH FILES
-.SM /var/log/tinyproxy.log
+.nf
+/etc/tinyproxy/tinyproxy.conf
+/var/run/tinyproxy.pid
+/var/log/tinyproxy.log
+.fi
 .SH AUTHORS
+.nf
 Steven Young (sdyoung@well.com)
-.PP
 Robert James Kaes (rjkaes@flarenet.com)
+.fi
 .SH BUGS
-For some reason, when sent SIGTERM,
+Due to the way the thread control is implimented, when a SIGTERM is sent
-.B tinyproxy 
+\fBtinyproxy\fR may not instantly terminate. It will finish sometime in the
-occasionally waits for the
+following five seconds, but this could be problems when you need to stop and
-next incoming connection before exiting.  We believe this bug has 
+start \fBtinyproxy\fR quickly. If anyone knows how to fix this, please let one
-been corrected, but please e-mail the authors if you see this 
+of the authors know.
-behaviour occurring.
 .SH COPYRIGHT
-.B tinyproxy
+\fBtinyproxy\fR is distributed under the GNU Public License (GPL).  For more
-is distributed under the GNU Public License (GPL).  For more information
+information on the GPL, please see the file COPYING which should have been
-on the GPL, please see the file COPYING which should have been included in
+included in the archive with \fBtinyproxy\fR.  Failing that,
-the archive with tinyproxy.  Failing that, http://www.fsf.org/ will
+http://www.fsf.org/ will doubtless have a copy up for you to peruse.  Please
-doubtless have a copy up for you to peruse.  Please don't use this
+don't use this software if you don't agree to the terms specified therein.
-software if you don't agree to the terms specified therein.
 .SH AVAILABILITY
-The latest version of
+The latest version of \fBtinyproxy\fR can be acquired from: http://tinyproxy.sourceforge.net/
-.B tinyproxy
-can be acquired from:
-.PP
-http://tinyproxy.sourceforge.net/