From 1a3602012e1a199e0b11e6fec89a4b089569086d Mon Sep 17 00:00:00 2001
From: rakshasa <sundell.software@gmail.com>
Date: Sun, 2 Oct 2011 11:50:39 +0000
Subject: [PATCH] * Added support for Cyrus RC4 to work around an OpenSSL RC4
 bug.

* Added manual for logging facilities.

* Fixed bugs in the choking code.


git-svn-id: svn://rakshasa.no/libtorrent/trunk/rtorrent@1288 e378c898-3ddf-0310-93e7-cc216c733640
---
 doc/manual/logging.tex | 61 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 doc/manual/logging.tex

diff --git a/doc/manual/logging.tex b/doc/manual/logging.tex
new file mode 100644
index 00000000..67aa294e
--- /dev/null
+++ b/doc/manual/logging.tex
@@ -0,0 +1,61 @@
+\section{Logging}
+
+\subsection{Opening log files}
+
+\begin{verbatim}
+# log.open_file = "log name", "file path"
+
+log.open_file = "rtorrent.log", (cat,/tmp/rtorrent.log.,(system.pid))  
+\end{verbatim}
+
+A newly opened log file is not connected to any logging events.
+
+Some control over formatting will be provided at a later date.
+
+
+\subsection{Adding outputs to events}
+
+\begin{verbatim}
+# log.add_output = "logging event", "log name"
+
+log.add_output = "info", "rtorrent.log"
+
+log.add_output = "dht_debug", "tracker.log"
+log.add_output = "tracker_debug", "tracker.log"
+\end{verbatim}
+
+Each log handle can be added to multiple different logging events.
+
+
+\subsection{Logging events}
+
+\begin{verbatim}
+"critical"
+"error"
+"warn"
+"notice"
+"info"
+"debug"
+\end{verbatim}
+
+The above events receive logging events from all the sub-groups
+displayed below, and each event also reciving events from the event
+above in importance.
+
+Thus some high-volume sub-group events such as ``tracker\_debug'' are
+not part of ``debug'' and every ``warn'' event will receive events
+from ``error'', ``critical''.
+
+\begin{verbatim}
+"connection_*"
+"dht_*"
+"peer_*"
+"rpc_*"
+"storage_*"
+"thread_*"
+"tracker_*"
+"torrent_*"
+\end{verbatim}
+
+All sub-groups have events from ``critical'' to ``debug'' defined.
+