From 1ebaea9eb06223e7c258ce5aed86b8586ba6b29b Mon Sep 17 00:00:00 2001
From: Diomidis Spinellis <dds@aueb.gr>
Date: Mon, 1 Nov 2010 06:55:23 +0000
Subject: [PATCH] Add answer provided by Georgios Gousios.

---
 doc/faq.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/faq.xml b/doc/faq.xml
index 6e0289b..70f04d8 100644
--- a/doc/faq.xml
+++ b/doc/faq.xml
@@ -225,4 +225,13 @@ You can work around it, by increasing the width and height values appearing
 in the SVG XML file that <em>pic2plot</em> generates.
 <h2><a name="private">How can I instruct UMLGraph to include private fields in its output?</a></h2>
 You need to pass the <code>-private</code> flag to <em>javadoc</em>.
+Note that
+when processing code that includes annotations
+defined by libraries outside the core J2SE distribution,
+it is a good idea to include the library jars to the classpath.
+Otherwise, <em>javadoc</em> (and concequently UMLGraph)
+will fail to process the input classes correctly.
+This is <a href="http://forums.sun.com/thread.jspa?threadID=5333060&tstart=0">a known issue</a> with <em>javadoc</em>,
+but only manifests in certain occasions when running UMLGraph,
+for example when processing private class fields.
 </notes>