Rename doc directory to docs

3 files changed, 178 insertions, 0 deletions

diff --git a/docs/man8/.gitignore b/docs/man8/.gitignore
new file mode 100644
index 0000000..5ff70f3
--- /dev/null
+++ b/docs/man8/.gitignore
@@ -0,0 +1,3 @@
+*.1
+*.xml
+*.txt
diff --git a/docs/man8/Makefile.am b/docs/man8/Makefile.am
new file mode 100644
index 0000000..b9eefaa
--- /dev/null
+++ b/docs/man8/Makefile.am
@@ -0,0 +1,23 @@
+MAN8_FILES  = \
+	tinyproxy.txt
+
+A2X_ARGS = \
+	-d manpage \
+	-f manpage
+
+man_MANS = \
+	$(MAN8_FILES:.txt=.8)
+
+.txt.8:
+if HAVE_A2X
+	a2x $(A2X_ARGS) $<
+else
+	@echo "*** a2x (asciidoc) is required to regenerate $(@) ***"; exit 1;
+endif
+
+EXTRA_DIST = \
+        $(man_MANS)
+
+CLEANFILES = \
+	$(MAN8_FILES:.txt=.8) \
+	$(MAN8_FILES:.txt=.xml)
diff --git a/docs/man8/tinyproxy.txt.in b/docs/man8/tinyproxy.txt.in
new file mode 100644
index 0000000..569bb81
--- /dev/null
+++ b/docs/man8/tinyproxy.txt.in
@@ -0,0 +1,152 @@
+TINYPROXY(8)
+============
+:man source:   Version @VERSION@
+:man manual:   Tinyproxy manual
+
+NAME
+----
+
+tinyproxy - A light-weight HTTP proxy daemon
+
+
+SYNOPSIS
+--------
+
+*tinyproxy* [-vldch]
+
+
+DESCRIPTION
+-----------
+
+*tinyproxy* is a light-weight HTTP proxy daemon designed to consume a
+minimum amount of system resources. It listens on a given TCP port and
+handles HTTP proxy requests. Designed from the ground up to be fast and
+yet small, it is an ideal solution for use cases such as embedded
+deployments where a full featured HTTP proxy is required, but the system
+resources for a larger proxy are unavailable.
+
+
+OPTIONS
+-------
+
+*tinyproxy* accepts the following options:
+
+*-c <config-file>*::
+    Use an alternate configuration file.
+
+*-d*::
+    Don't daemonize and stay in the foreground. Useful for debugging purposes.
+
+*-h*::
+    Display a short help screen of command line arguments and exit.
+
+*-l*::
+    Display the licensing agreement.
+
+*-v*::
+    Display version information and exit.
+
+
+SIGNALS
+-------
+
+In addition to 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.
+
+*SIGHUP*::
+    Force Tinyproxy to do a garbage collection on the current
+    connections linked list. This is usually done automatically after a
+    certain number of connections have been handled.
+
+
+TEMPLATE FILES
+--------------
+
+There are two occasions when Tinyproxy delivers HTML pages to
+the client on it's own right:
+
+. When an error occurred, a corresponding error page is returned.
+. When a request for the stathost is made, a page summarizing the
+  connection statistics is returned. (See STATHOST below.)
+
+The layout of both error pages and the statistics page can be
+controlled via configurable HTML template files that are plain
+HTML files that additionally understand a few template
+variables.
+
+
+TEMPLATE VARIABLES
+------------------
+
+There are several standard HTML variables that are available in every
+template file:
+
+*request*::
+    The full HTTP request line.
+
+*cause*::
+    The abbreviated cause of the error condition.
+
+*clientip*::
+    The IP address of the client making the request.
+
+*clienthost*::
+    The hostname of the client making the request.
+
+*version*::
+    The version of Tinyproxy.
+
+*package*::
+    The package name. Presently, resolves to 'tinyproxy'.
+
+*date*::
+    The current date/time in HTTP format.
+
+In addition, almost all templates support:
+
+*detail*::
+    A detailed, plain English explanation of the error and possible
+    causes.
+
+When Tinyproxy finds a variable name enclosed in braces, e.g.
+"\{request}", then this is replaced by the value of the corresponding
+variable before delivery of the page.
+
+
+STATHOST
+--------
+
+Tinyproxy returns a HTML page with connection statistics when it
+receives a HTTP request for a certain host -- the stathost.  The
+stathost name defaults to `tinyproxy.stats` and can be changed at
+compile-time with the configure switch `--with-stathost` to any name or
+IP address.
+
+The stat file template can be changed at runtime through the
+configuration variable `StatFile`.
+
+
+FILES
+-----
+
+`/etc/tinyproxy/tinyproxy.conf`, `/var/run/tinyproxy.pid`, `/var/log/tinyproxy.log`
+
+BUGS
+----
+
+To report bugs in Tinyproxy, please visit
+<https://www.banu.com/tinyproxy/support/[https://www.banu.com/tinyproxy/support/]>.
+
+
+COPYRIGHT
+---------
+
+Copyright (c) 1998-2000 Steven Young;
+Copyright (c) 2000-2001 Robert James Kaes;
+Copyright (c) 2009 Mukund Sivaraman;
+Copyright (c) 2009 Michael Adam.
+
+This program is distributed under the terms of the GNU General Public
+License version 2 or above. See the COPYING file for additional
+information.