From 4f6bc55f0effe113700c54bf4ca19a257e0ce581 Mon Sep 17 00:00:00 2001
From: Robert Burrell Donkin <rdonkin@apache.org>
Date: Thu, 12 Dec 2002 19:56:44 +0000
Subject: [PATCH] Added a FAQ entry about thread safety based on a paragraph
 suggested by John Yu.

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/logging/trunk@138944 13f79535-47bb-0310-9956-ffa450edef68
---
 usersguide.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/usersguide.html b/usersguide.html
index 53ffbe3..3808323 100644
--- a/usersguide.html
+++ b/usersguide.html
@@ -28,6 +28,8 @@ Table of Contents</h3>
 <br><a href="#Integration">Integration</a>
 <br>&nbsp; <a href="#Mechanism">Mechanism</a>
 <br>&nbsp; <a href="#Configuring the Logger Implementation">Configuring the Logger Implementation</a>
+<br><a href="#FAQ">Frequently Asked Questions</a>
+<br>&nbsp; <a href="#Thread Safety">Is JCL Thread Safe?</a>
 
 <h2>
 <a NAME="Introduction"></a>Introduction</h2>
@@ -439,6 +441,13 @@ For example: one can capture DEBUG (and higher) level information in a logfile,
 while limiting console output to INFO (and higher).
 </ul>
 
+<h2><a NAME="FAQ">Frequently Asked Questions</a></h2>
+
+<h3><a NAME="Thread Safety">Is JCL Thread Safe?</a></h3>
+
+<p> JCL doesn't (and cannot) impose any requirement on thread safety on the underlying implementation and thus its SPI contract doesn't guarantee thread safety. However, JCL can be safely used a multi-threaded environment as long as the underlying implementation is thread-safe.</p>
+
+<p>It would be very unusual for a logging system to be thread unsafe. Certainly, JCL is thread safe when used with the distributed Log implementations.</p>
 
 </body>
 </html>