From d0f56a21eb73647cad6c9beff60af61fda1c5b3a Mon Sep 17 00:00:00 2001
From: Daira Hopwood <daira@jacaranda.org>
Date: Thu, 5 Sep 2013 18:08:50 +0100
Subject: [PATCH] Sat Mar 31 23:39:34 BST 2012  david-sarah@jacaranda.org   *
 Document PYTHONPATH problem when running flogtool. refs #1693

---
 docs/logging.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/logging.rst b/docs/logging.rst
index 5a24700e..9609de45 100644
--- a/docs/logging.rst
+++ b/docs/logging.rst
@@ -23,12 +23,16 @@ record information about what is happening inside the Tahoe node. This is
 primarily for use by programmers and grid operators who want to find out what
 went wrong.
 
-The foolscap logging system is documented at
+The Foolscap logging system is documented at
 `<http://foolscap.lothar.com/docs/logging.html>`_.
 
-The foolscap distribution includes a utility named "``flogtool``" (usually at
-``/usr/bin/flogtool`` on Unix) which is used to get access to many foolscap
-logging features.
+The Foolscap distribution includes a utility named "``flogtool``" that is
+used to get access to many Foolscap logging features. However, using this
+command directly on Tahoe log files may fail, due to use of an incorrect
+PYTHONPATH. Installing Foolscap v0.6.1 or later and then running
+``bin/tahoe @flogtool`` from the root of a Tahoe-LAFS source distribution
+may avoid this problem (but only on Unix, not Windows).
+
 
 Realtime Logging
 ================
-- 
2.45.2