This is an automated email from the ASF dual-hosted git repository.

jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git


The following commit(s) were added to refs/heads/master by this push:
     new 3667510  Javadocs
3667510 is described below

commit 3667510474976ec6998b976d20f84a88242ade61
Author: JamesBognar <james.bog...@salesforce.com>
AuthorDate: Mon Dec 20 20:51:15 2021 -0500

    Javadocs
---
 .../src/main/java/org/apache/juneau/config/Config.java             | 4 ++++
 .../java/org/apache/juneau/config/store/ConfigClasspathStore.java  | 4 ++++
 .../main/java/org/apache/juneau/config/store/ConfigFileStore.java  | 4 ++++
 .../java/org/apache/juneau/config/store/ConfigMemoryStore.java     | 4 ++++
 .../src/main/java/org/apache/juneau/config/store/ConfigStore.java  | 6 +++++-
 .../src/main/java/org/apache/juneau/jena/N3Parser.java             | 4 ++++
 .../src/main/java/org/apache/juneau/jena/N3Serializer.java         | 4 ++++
 .../src/main/java/org/apache/juneau/jena/NTripleParser.java        | 4 ++++
 .../src/main/java/org/apache/juneau/jena/NTripleSerializer.java    | 4 ++++
 .../src/main/java/org/apache/juneau/jena/RdfParser.java            | 4 ++++
 .../src/main/java/org/apache/juneau/jena/RdfSerializer.java        | 4 ++++
 .../main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java   | 4 ++++
 .../src/main/java/org/apache/juneau/jena/RdfXmlParser.java         | 4 ++++
 .../src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java     | 4 ++++
 .../src/main/java/org/apache/juneau/jena/TurtleParser.java         | 4 ++++
 .../src/main/java/org/apache/juneau/jena/TurtleSerializer.java     | 4 ++++
 .../src/main/java/org/apache/juneau/BeanContext.java               | 4 ++++
 .../src/main/java/org/apache/juneau/BeanContextable.java           | 4 ++++
 .../src/main/java/org/apache/juneau/BeanSession.java               | 7 ++++---
 .../src/main/java/org/apache/juneau/BeanTraverseContext.java       | 4 ++++
 .../juneau-marshall/src/main/java/org/apache/juneau/Context.java   | 6 +++++-
 .../src/main/java/org/apache/juneau/ContextSession.java            | 4 ++++
 .../src/main/java/org/apache/juneau/collections/AList.java         | 4 ++++
 .../src/main/java/org/apache/juneau/collections/AMap.java          | 4 ++++
 .../src/main/java/org/apache/juneau/collections/ASet.java          | 4 ++++
 .../src/main/java/org/apache/juneau/collections/ASortedMap.java    | 4 ++++
 .../src/main/java/org/apache/juneau/collections/ASortedSet.java    | 4 ++++
 .../src/main/java/org/apache/juneau/collections/Args.java          | 4 ++++
 .../src/main/java/org/apache/juneau/csv/CsvParser.java             | 4 ++++
 .../src/main/java/org/apache/juneau/csv/CsvSerializer.java         | 4 ++++
 .../src/main/java/org/apache/juneau/encoders/Encoder.java          | 4 ++++
 .../src/main/java/org/apache/juneau/encoders/EncoderSet.java       | 4 ++++
 .../src/main/java/org/apache/juneau/encoders/GzipEncoder.java      | 4 ++++
 .../src/main/java/org/apache/juneau/encoders/IdentityEncoder.java  | 4 ++++
 .../src/main/java/org/apache/juneau/html/HtmlDocSerializer.java    | 4 ++++
 .../src/main/java/org/apache/juneau/html/HtmlParser.java           | 4 ++++
 .../main/java/org/apache/juneau/html/HtmlSchemaDocSerializer.java  | 4 ++++
 .../src/main/java/org/apache/juneau/html/HtmlSchemaSerializer.java | 4 ++++
 .../src/main/java/org/apache/juneau/html/HtmlSerializer.java       | 4 ++++
 .../java/org/apache/juneau/html/HtmlStrippedDocSerializer.java     | 4 ++++
 .../main/java/org/apache/juneau/httppart/BaseHttpPartParser.java   | 4 ++++
 .../java/org/apache/juneau/httppart/BaseHttpPartSerializer.java    | 4 ++++
 .../src/main/java/org/apache/juneau/httppart/SimplePartParser.java | 4 ++++
 .../main/java/org/apache/juneau/httppart/SimplePartSerializer.java | 4 ++++
 .../src/main/java/org/apache/juneau/json/JsonParser.java           | 4 ++++
 .../src/main/java/org/apache/juneau/json/JsonSchemaSerializer.java | 4 ++++
 .../src/main/java/org/apache/juneau/json/JsonSerializer.java       | 4 ++++
 .../src/main/java/org/apache/juneau/json/SimpleJsonParser.java     | 4 ++++
 .../src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java | 4 ++++
 .../java/org/apache/juneau/jsonschema/JsonSchemaGenerator.java     | 4 ++++
 .../src/main/java/org/apache/juneau/msgpack/MsgPackParser.java     | 4 ++++
 .../src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java | 4 ++++
 .../src/main/java/org/apache/juneau/oapi/OpenApiParser.java        | 4 ++++
 .../src/main/java/org/apache/juneau/oapi/OpenApiSerializer.java    | 4 ++++
 .../src/main/java/org/apache/juneau/parser/InputStreamParser.java  | 4 ++++
 .../src/main/java/org/apache/juneau/parser/Parser.java             | 4 ++++
 .../src/main/java/org/apache/juneau/parser/ParserSet.java          | 4 ++++
 .../src/main/java/org/apache/juneau/parser/ReaderParser.java       | 4 ++++
 .../src/main/java/org/apache/juneau/plaintext/PlainTextParser.java | 4 ++++
 .../main/java/org/apache/juneau/plaintext/PlainTextSerializer.java | 4 ++++
 .../java/org/apache/juneau/serializer/OutputStreamSerializer.java  | 4 ++++
 .../apache/juneau/serializer/OutputStreamSerializerSession.java    | 4 ++++
 .../src/main/java/org/apache/juneau/serializer/Serializer.java     | 4 ++++
 .../src/main/java/org/apache/juneau/serializer/SerializerSet.java  | 4 ++++
 .../main/java/org/apache/juneau/serializer/WriterSerializer.java   | 4 ++++
 .../src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java    | 4 ++++
 .../src/main/java/org/apache/juneau/uon/UonParser.java             | 4 ++++
 .../src/main/java/org/apache/juneau/uon/UonSerializer.java         | 4 ++++
 .../main/java/org/apache/juneau/urlencoding/UrlEncodingParser.java | 4 ++++
 .../java/org/apache/juneau/urlencoding/UrlEncodingSerializer.java  | 4 ++++
 .../src/main/java/org/apache/juneau/xml/XmlDocSerializer.java      | 4 ++++
 .../src/main/java/org/apache/juneau/xml/XmlParser.java             | 4 ++++
 .../src/main/java/org/apache/juneau/xml/XmlSerializer.java         | 4 ++++
 .../src/main/java/org/apache/juneau/rest/client/RestClient.java    | 4 ++++
 .../src/main/java/org/apache/juneau/rest/client/RestRequest.java   | 4 ++++
 .../src/main/java/org/apache/juneau/rest/mock/MockRestClient.java  | 4 ++++
 .../src/main/java/org/apache/juneau/rest/mock/MockRestRequest.java | 4 ++++
 .../src/main/java/org/apache/juneau/rest/RestContext.java          | 5 ++++-
 .../src/main/java/org/apache/juneau/rest/RestOpContext.java        | 4 ++++
 .../src/main/java/org/apache/juneau/rest/RestOpSession.java        | 4 ++++
 .../src/main/java/org/apache/juneau/rest/RestSession.java          | 4 ++++
 .../src/main/java/org/apache/juneau/rest/RrpcRestOpContext.java    | 4 ++++
 .../src/main/java/org/apache/juneau/rest/RrpcRestOpSession.java    | 4 ++++
 .../src/test/java/org/apache/juneau/XmlValidatorParser.java        | 4 ++++
 84 files changed, 338 insertions(+), 6 deletions(-)

diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
index a9a9ab4..2f2808b 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
@@ -42,6 +42,10 @@ import org.apache.juneau.svl.*;
  * Main configuration API class.
  * {@review}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc juneau-config}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigClasspathStore.java
 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigClasspathStore.java
index 25918aa..0e13774 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigClasspathStore.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigClasspathStore.java
@@ -32,6 +32,10 @@ import org.apache.juneau.internal.*;
  * <p>
  * Configuration files retrieved from the classpath can be modified but not 
persisted.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigFileStore.java
 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigFileStore.java
index 36c4703..234d552 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigFileStore.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigFileStore.java
@@ -39,6 +39,10 @@ import org.apache.juneau.internal.*;
  * <p>
  * Points to a file system directory containing configuration files.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigMemoryStore.java
 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigMemoryStore.java
index a2eff8d..7219634 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigMemoryStore.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigMemoryStore.java
@@ -29,6 +29,10 @@ import org.apache.juneau.internal.*;
  * <p>
  * Points to a file system directory containing configuration files.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigStore.java
 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigStore.java
index 6217a6c..ae78ab4 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigStore.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/store/ConfigStore.java
@@ -32,7 +32,11 @@ import org.apache.juneau.internal.*;
  *     <li class='jm'>{@link #read(String)} - Retrieve a config file.
  *     <li class='jm'>{@link #write(String,String,String)} - ConfigStore a 
config file.
  * </ul>
-  *
+ *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
index 96eafdd..6ea1f85 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfParser} for parsing RDF in N3 notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
index f3e2f17..70aaf3b 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfSerializer} for serializing RDF in N3 notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
index a76e867..d07619d 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfParser} for parsing RDF in N-Triple notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
index cdc5850..ab8ffb3 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfSerializer} for serializing RDF in N-Triple notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java
index a1c5a95..8ace700 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfParser.java
@@ -51,6 +51,10 @@ import org.apache.juneau.xml.*;
  *             {@link N3Parser} - N3.
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfSerializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfSerializer.java
index fab23a6..d9f8f6d 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfSerializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfSerializer.java
@@ -50,6 +50,10 @@ import org.apache.juneau.xml.annotation.*;
  *     <li>{@link N3Serializer} - N3.
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
index 588178a..0bd5472 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfParser} for parsing RDF in Abbreviated-XML notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
index 31b15fe..916562c 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfParser} for parsing RDF in standard XML notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
index 5994f40..5b58b04 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfSerializer} for serializing RDF in standard XML 
notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
index 302ff21..ff6b648 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfParser} for parsing RDF in Turtle notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
index 602628f..6e5559e 100644
--- 
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
+++ 
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
@@ -15,6 +15,10 @@ package org.apache.juneau.jena;
 /**
  * Subclass of {@link RdfSerializer} for serializing RDF in Turtle notation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jmr.RdfDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContext.java 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContext.java
index e1dee96..9793d15 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContext.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContext.java
@@ -150,6 +150,10 @@ import org.apache.juneau.utils.*;
  *     Person <jv>p</jv> = <jv>m2</jv>.getBean();  <jc>// Get the bean 
instance that was created.</jc>
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.BeanContexts}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContextable.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContextable.java
index 26b73af..fb65895 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContextable.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanContextable.java
@@ -36,6 +36,10 @@ import org.apache.juneau.utils.*;
  * This abstraction exists to allow different kinds of subclasses (e.g. 
JsonSerilalizer, XmlParser...) to share bean context objects since
  * bean context objects are heavyweight objects that cache metadata about 
encountered beans.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanSession.java 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanSession.java
index e977fa8..6d7d2e8 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanSession.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanSession.java
@@ -41,9 +41,10 @@ import org.apache.juneau.swap.*;
 /**
  * Session object that lives for the duration of a single use of {@link 
BeanContext}.
  *
- * <p>
- * Typically session objects are not thread safe nor reusable.  However, bean 
sessions do not maintain any state and
- * thus can be safely cached and reused.
+ * <ul class='spaced-list'>
+ *     <li class='info'>Typically session objects are not thread safe nor 
reusable.  However, bean sessions do not maintain any state and
+ *             thus can be safely cached and reused.
+ * </ul>
  *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanTraverseContext.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanTraverseContext.java
index 2cc3da9..c7160e7 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanTraverseContext.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/BeanTraverseContext.java
@@ -33,6 +33,10 @@ import org.apache.juneau.utils.*;
  *
  * Base class that serves as the parent class for all serializers and other 
classes that traverse POJOs.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Context.java 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Context.java
index 9aa0dfb..3b7b53b 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Context.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/Context.java
@@ -53,7 +53,7 @@ import org.apache.juneau.xml.annotation.*;
  * Base class for all Context beans.
  *
  * <p>
- * Context beans follow the convention of having the following parts:
+ * Context beans follow the convention of havinTg the following parts:
  * <ul>
  *     <li>A {@link Builder} class for configuring the context bean.
  *     <ul>
@@ -68,6 +68,10 @@ import org.apache.juneau.xml.annotation.*;
  *             <li>This bean is non-thread-safe and meant for one-time use.
  *     </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/ContextSession.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/ContextSession.java
index b29d5d1..156484a 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/ContextSession.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/ContextSession.java
@@ -26,6 +26,10 @@ import org.apache.juneau.internal.*;
 /**
  * A one-time-use non-thread-safe object that's meant to be used once and then 
thrown away.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not typically thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AList.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AList.java
index 5ac4e58..99764da 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AList.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AList.java
@@ -49,6 +49,10 @@ import org.apache.juneau.serializer.*;
  *     String json = l.asString(XmlSerializer.<jsf>DEFAULT</jsm>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AMap.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AMap.java
index d789ba5..2eb23c6 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AMap.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/AMap.java
@@ -45,6 +45,10 @@ import org.apache.juneau.serializer.*;
  *     String json = m.asString(XmlSerializer.<jsf>DEFAULT</jsm>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASet.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASet.java
index 5d21362..0f6479a 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASet.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASet.java
@@ -48,6 +48,10 @@ import org.apache.juneau.serializer.*;
  *     String json = s.asString(XmlSerializer.<jsf>DEFAULT</jsm>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedMap.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedMap.java
index a7453e5..2aacb1c 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedMap.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedMap.java
@@ -44,6 +44,10 @@ import org.apache.juneau.serializer.*;
  *     String json = m.asString(XmlSerializer.<jsf>DEFAULT</jsm>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedSet.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedSet.java
index 7d3e25f..6e756de 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedSet.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/ASortedSet.java
@@ -46,6 +46,10 @@ import org.apache.juneau.serializer.*;
  *     String json = s.asString(XmlSerializer.<jsf>DEFAULT</jsm>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/Args.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/Args.java
index 6a55de5..e07d4ca 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/Args.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/collections/Args.java
@@ -102,6 +102,10 @@ import org.apache.juneau.internal.*;
  * <p>
  * Equivalent operations are available on optional arguments through the 
{@link #getArg(Class, String)} method.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='extlink'>{@source}
  * </ul>
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvParser.java
index 5f58ab6..86f5706 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvParser.java
@@ -27,6 +27,10 @@ import org.apache.juneau.utils.*;
 /**
  * TODO - Work in progress.  CSV parser.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.CsvDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvSerializer.java
index 031be69..4a30abc 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/csv/CsvSerializer.java
@@ -27,6 +27,10 @@ import org.apache.juneau.utils.*;
 /**
  * TODO - Work in progress.  CSV serializer.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.CsvDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/Encoder.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/Encoder.java
index 57aa218..43cd0e8 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/Encoder.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/Encoder.java
@@ -24,6 +24,10 @@ import java.io.*;
  * <p>
  * Encoders are registered with <c>RestServlets</c> through the 
<ja>@Rest(encoders)</ja> annotation.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.Encoders}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/EncoderSet.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/EncoderSet.java
index 14ef453..041c0ef 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/EncoderSet.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/EncoderSet.java
@@ -65,6 +65,10 @@ import org.apache.juneau.internal.*;
  *     Encoder <jv>encoder</jv> = 
<jv>encoders</jv>.getEncoder(<jv>matchedCoding</jv>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.Encoders}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/GzipEncoder.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/GzipEncoder.java
index a0c5263..55698cd 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/GzipEncoder.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/GzipEncoder.java
@@ -18,6 +18,10 @@ import java.util.zip.*;
 /**
  * Encoder for handling <js>"gzip"</js> encoding and decoding.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.Encoders}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/IdentityEncoder.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/IdentityEncoder.java
index 688ef32..6c2b1f3 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/IdentityEncoder.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/encoders/IdentityEncoder.java
@@ -20,6 +20,10 @@ import java.io.*;
  * <p>
  * Identity encoding is just another name for no encoding at all.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.Encoders}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlDocSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlDocSerializer.java
index a10f322..8c1c7e4 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlDocSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlDocSerializer.java
@@ -71,6 +71,10 @@ import org.apache.juneau.xml.*;
  * <br>These variables are replaced at runtime based on the HTTP request 
locale.
  * <br>Several built-in runtime variable types are defined, and the API can be 
extended to include user-defined variables.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlParser.java
index f95e7f6..7540832 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlParser.java
@@ -37,6 +37,10 @@ import org.apache.juneau.xml.*;
  * <p>
  * This class is used primarily for automated testing of the {@link 
HtmlSerializer} class.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaDocSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaDocSerializer.java
index 887c138..bb87f49 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaDocSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaDocSerializer.java
@@ -46,6 +46,10 @@ import org.apache.juneau.xml.*;
  * The easiest way to create instances of this class is through the {@link 
HtmlSerializer#getSchemaSerializer()},
  * which will create a schema serializer with the same settings as the 
originating serializer.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaSerializer.java
index 6a56817..31a93cf 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSchemaSerializer.java
@@ -49,6 +49,10 @@ import org.apache.juneau.xml.*;
  * The easiest way to create instances of this class is through the {@link 
HtmlSerializer#getSchemaSerializer()},
  * which will create a schema serializer with the same settings as the 
originating serializer.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSerializer.java
index b1bbbff..6b3a80e 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlSerializer.java
@@ -135,6 +135,10 @@ import org.apache.juneau.xml.*;
  *     String html = HtmlSerializer.<jsf>DEFAULT</jsf>.serialize(m);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlStrippedDocSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlStrippedDocSerializer.java
index c9c1185..354eb3b 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlStrippedDocSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/html/HtmlStrippedDocSerializer.java
@@ -38,6 +38,10 @@ import org.apache.juneau.xml.*;
  * description.
  * Used primarily for JUnit testing the {@link HtmlDocSerializer} class.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.HtmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartParser.java
index 1716b3e..c5678de 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartParser.java
@@ -20,6 +20,10 @@ import org.apache.juneau.parser.*;
 /**
  * Base class for implementations of {@link HttpPartParser}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartSerializer.java
index d1b7f9d..f559dd2 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/BaseHttpPartSerializer.java
@@ -18,6 +18,10 @@ import org.apache.juneau.serializer.*;
 /**
  * Base class for implementations of {@link HttpPartSerializer}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartParser.java
index ad88d39..d05a232 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartParser.java
@@ -36,6 +36,10 @@ package org.apache.juneau.httppart;
  *     </ul>
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartSerializer.java
index 2123934..4ee19e6 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/SimplePartSerializer.java
@@ -20,6 +20,10 @@ import org.apache.juneau.reflect.*;
  * <p>
  * More precisely, uses the {@link Mutaters#toString(Object)} method to 
stringify objects.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonParser.java
index 320b490..30613af 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonParser.java
@@ -111,6 +111,10 @@ import org.apache.juneau.utils.*;
  * OList(CharSequence)} constructors instead of using this class.
  * The end result should be the same.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.JsonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSchemaSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSchemaSerializer.java
index 0e808df..4dcb1ec 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSchemaSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSchemaSerializer.java
@@ -41,6 +41,10 @@ import org.apache.juneau.utils.*;
  *
  * Produces the JSON-schema for the JSON produced by the {@link 
JsonSerializer} class with the same properties.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.JsonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSerializer.java
index aa5ec94..4ab0900 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/JsonSerializer.java
@@ -98,6 +98,10 @@ import org.apache.juneau.utils.*;
  *     String json = serializer.serialize(someObject);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.JsonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonParser.java
index 4446d65..c47378d 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonParser.java
@@ -23,6 +23,10 @@ package org.apache.juneau.json;
  *
  * Identical to {@link JsonParser} but with the media type 
<bc>application/json+simple</bc>.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.JsonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
index 1b912ad..701e021 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
@@ -29,6 +29,10 @@ package org.apache.juneau.json;
  *     <li>Single quotes.
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.JsonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/jsonschema/JsonSchemaGenerator.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/jsonschema/JsonSchemaGenerator.java
index f23ef9e..c5f1fda 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/jsonschema/JsonSchemaGenerator.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/jsonschema/JsonSchemaGenerator.java
@@ -36,6 +36,10 @@ import org.apache.juneau.utils.*;
  * Generates JSON-schema metadata about POJOs.
  * {@review}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackParser.java
index cd9d463..4c3865c 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackParser.java
@@ -30,6 +30,10 @@ import org.apache.juneau.utils.*;
  *
  * Handles <c>Content-Type</c> types:  <bc>octal/msgpack</bc>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.MsgPackDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
index 7b5bd28..92148f5 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
@@ -37,6 +37,10 @@ import org.apache.juneau.utils.*;
  * <p>
  * Produces <c>Content-Type</c> types: <bc>octal/msgpack</bc>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.MsgPackDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiParser.java
index 953cccd..8d3d363 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiParser.java
@@ -29,6 +29,10 @@ import org.apache.juneau.utils.*;
 /**
  * OpenAPI part parser.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.OpenApiParsers}
  *     <li class='link'>{@doc OpenApiDetails}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiSerializer.java
index b301761..b203864 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/oapi/OpenApiSerializer.java
@@ -29,6 +29,10 @@ import org.apache.juneau.utils.*;
 /**
  * Serializes POJOs to values suitable for transmission as HTTP headers, 
query/form-data parameters, and path variables.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.OpenApiSerializers}
  *     <li class='link'>{@doc OpenApiDetails}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/InputStreamParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/InputStreamParser.java
index a7814f5..6b794a1 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/InputStreamParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/InputStreamParser.java
@@ -37,6 +37,10 @@ import org.apache.juneau.utils.*;
  *     <li><c>parse(InputStream, ClassMeta, Parser)</c>
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/Parser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/Parser.java
index 7b4f604..c6ed0c4 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/Parser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/Parser.java
@@ -124,6 +124,10 @@ import org.apache.juneau.xml.*;
  *     <tr><td>string</td><td>{@link String}</td></tr>
  * </table>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ParserSet.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ParserSet.java
index c7a1460..724c311 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ParserSet.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ParserSet.java
@@ -75,6 +75,10 @@ import org.apache.juneau.internal.*;
  *     AddressBook <jv>addressBook</jv> = <jv>parser</jv>.parse(<jv>json</jv>, 
AddressBook.<jk>class</jk>);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ReaderParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ReaderParser.java
index 7b4448f..016c85c 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ReaderParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/parser/ReaderParser.java
@@ -38,6 +38,10 @@ import org.apache.juneau.utils.*;
  *     <li><c>parse(ParserSession, ClassMeta)</c>
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
index 4ad5380..3266476 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
@@ -46,6 +46,10 @@ import org.apache.juneau.utils.*;
  * Also parses objects using a transform if the object class has an {@link 
ObjectSwap ObjectSwap&lt;?,String&gt;} transform
  * defined on it.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.PlainTextDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
index 42fc6a7..683b6b5 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
@@ -42,6 +42,10 @@ import org.apache.juneau.utils.*;
  * Also serializes objects using a transform if the object class has an {@link 
ObjectSwap ObjectSwap&lt;?,String&gt;}
  * transform defined on it.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.PlainTextDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
index db94f6e..b001e4d 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
@@ -29,6 +29,10 @@ import org.apache.juneau.utils.*;
  * Subclass of {@link Serializer} for byte-based serializers.
  * {@review}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializerSession.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializerSession.java
index 91dee23..14251c3 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializerSession.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/OutputStreamSerializerSession.java
@@ -34,6 +34,10 @@ import org.apache.juneau.svl.*;
  *     <li>{@link #doSerialize(SerializerPipe, Object)}
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe and is typically 
discarded after one use.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/Serializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/Serializer.java
index 00160a0..e028ea9 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/Serializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/Serializer.java
@@ -48,6 +48,10 @@ import org.apache.juneau.utils.*;
  * Subclasses should extend directly from {@link OutputStreamSerializer} or 
{@link WriterSerializer} depending on
  * whether it's a stream or character based serializer.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/SerializerSet.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/SerializerSet.java
index 8f1460f..8aa5d88 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/SerializerSet.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/SerializerSet.java
@@ -74,6 +74,10 @@ import org.apache.juneau.internal.*;
  *     String <jv>json</jv> = <jv>serializer</jv>.serialize(addressBook);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
index cc3fffd..f943ddf 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
@@ -33,6 +33,10 @@ import org.apache.juneau.utils.*;
  * Subclass of {@link Serializer} for character-based serializers.
  * {@review}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
index e2375d7..8d0246a 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
@@ -40,6 +40,10 @@ import org.apache.juneau.xml.*;
  *
  * Essentially the same output as {@link XmlDocSerializer}, except wrapped in 
a standard SOAP envelope.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.SoapXmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonParser.java
index af33f62..870f9b8 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonParser.java
@@ -41,6 +41,10 @@ import org.apache.juneau.utils.*;
  *
  * This parser uses a state machine, which makes it very fast and efficient.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.UonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonSerializer.java
index 0c648be..0d23f6d 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/UonSerializer.java
@@ -128,6 +128,10 @@ import org.apache.juneau.utils.*;
  *     String s = UonSerializer.<jsf>DEFAULT</jsf>.serialize(s);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.UonDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingParser.java
index f7afc77..779aab9 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingParser.java
@@ -46,6 +46,10 @@ import org.apache.juneau.utils.*;
  * <p>
  * This parser uses a state machine, which makes it very fast and efficient.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.UrlEncodingDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingSerializer.java
index 1ae6e8b..be932da 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/UrlEncodingSerializer.java
@@ -123,6 +123,10 @@ import org.apache.juneau.utils.*;
  *     String s = UrlEncodingSerializer.<jsf>DEFAULT</jsf>.serialize(s);
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jm.UrlEncodingDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlDocSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlDocSerializer.java
index 3121054..00f38bc 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlDocSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlDocSerializer.java
@@ -26,6 +26,10 @@ package org.apache.juneau.xml;
  * Same as {@link XmlSerializer}, except prepends <code><xt>&lt;?xml</xt> 
<xa>version</xa>=<xs>'1.0'</xs>
  * <xa>encoding</xa>=<xs>'UTF-8'</xs><xt>?&gt;</xt></code> to the response to 
make it a valid XML document.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc XmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlParser.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlParser.java
index a5f12f1..3258a15 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlParser.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlParser.java
@@ -45,6 +45,10 @@ import org.apache.juneau.utils.*;
  *
  * See the {@link XmlSerializer} class for a description of Juneau-generated 
XML.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc XmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlSerializer.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlSerializer.java
index c7bc16c..37810df 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlSerializer.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/XmlSerializer.java
@@ -124,6 +124,10 @@ import org.apache.juneau.utils.*;
  *     <li>{@link SqReadable} - Default serializer, single quotes, whitespace 
added.
  * </ul>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc XmlDetails}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClient.java
 
b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClient.java
index d31d4a7..bae2204 100644
--- 
a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClient.java
+++ 
b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClient.java
@@ -1027,6 +1027,10 @@ import org.apache.juneau.xml.*;
  * The {@link RestRequest} and {@link RestResponse} objects can also be 
extended and integrated by overriding the
  * {@link RestClient#createRequest(URI,String,boolean)} and {@link 
RestClient#createResponse(RestRequest,HttpResponse,Parser)} methods.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc juneau-rest-client}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestRequest.java
 
b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestRequest.java
index 0b5dddd..8842b36 100644
--- 
a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestRequest.java
+++ 
b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestRequest.java
@@ -71,6 +71,10 @@ import org.apache.juneau.xml.*;
  * <p>
  * Instances of this class are created by the various creator methods on the 
{@link RestClient} class.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc juneau-rest-client}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestClient.java
 
b/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestClient.java
index 973ec9f..f797923 100644
--- 
a/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestClient.java
+++ 
b/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestClient.java
@@ -237,6 +237,10 @@ import org.apache.juneau.utils.*;
  *     }
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc juneau-rest-mock}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestRequest.java
 
b/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestRequest.java
index 4805725..f0e0e89 100644
--- 
a/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestRequest.java
+++ 
b/juneau-rest/juneau-rest-mock/src/main/java/org/apache/juneau/rest/mock/MockRestRequest.java
@@ -28,6 +28,10 @@ import org.apache.juneau.rest.client.*;
  * <p>
  * Instances of this class are instantiated through methods on {@link 
MockRestClient} such as {@link MockRestClient#post(Object,Object)}
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc juneau-rest-mock}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
index 7553c76..5aa9e49 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestContext.java
@@ -108,11 +108,14 @@ import org.apache.juneau.svl.vars.*;
  *     }
  * </p>
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc jrs.RestContext}
  *     <li class='extlink'>{@source}
  * </ul>
- * </ul>
  */
 public class RestContext extends Context {
 
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpContext.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpContext.java
index 7c5eff2..8635450 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpContext.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpContext.java
@@ -68,6 +68,10 @@ import org.apache.juneau.svl.*;
  * Represents a single Java servlet/resource method annotated with {@link 
RestOp @RestOp}.
  * {@review}
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpSession.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpSession.java
index 409e1fa..2838724 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpSession.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestOpSession.java
@@ -26,6 +26,10 @@ import org.apache.juneau.rest.logging.*;
  * <p>
  * This session object gets created by {@link RestSession} once the Java 
method to be invoked has been determined.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestSession.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestSession.java
index 859c8d2..781a091 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestSession.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestSession.java
@@ -28,6 +28,10 @@ import org.apache.juneau.rest.util.*;
 /**
  * Represents a single HTTP request.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpContext.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpContext.java
index 9758a5d..7b4aee5 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpContext.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpContext.java
@@ -21,6 +21,10 @@ import org.apache.juneau.http.response.*;
 /**
  * A specialized {@link RestOpContext} for handling <js>"RRPC"</js> HTTP 
methods.
  *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpSession.java
 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpSession.java
index 8d9f4c6..af3fb13 100644
--- 
a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpSession.java
+++ 
b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RrpcRestOpSession.java
@@ -25,6 +25,10 @@ import org.apache.juneau.parser.*;
 /**
  * A session for a single HTTP request against an RRPC Java method.
  *
+ * <ul class='spaced-list'>
+ *     <li class='warn'>This class is not thread safe.
+ * </ul>
+ *
  * <ul class='seealso'>
  *     <li class='link'>{@doc TODO}
  *     <li class='extlink'>{@source}
diff --git 
a/juneau-utest/src/test/java/org/apache/juneau/XmlValidatorParser.java 
b/juneau-utest/src/test/java/org/apache/juneau/XmlValidatorParser.java
index 3e57ffa..219b39c 100755
--- a/juneau-utest/src/test/java/org/apache/juneau/XmlValidatorParser.java
+++ b/juneau-utest/src/test/java/org/apache/juneau/XmlValidatorParser.java
@@ -25,6 +25,10 @@ import org.apache.juneau.xml.*;
 
 /**
  * Used to validate that the syntax of XML documents are valid.
+ *
+ * <ul class='spaced-list'>
+ *     <li class='note'>This class is thread safe and reusable.
+ * </ul>
  */
 @SuppressWarnings({"unchecked"})
 public class XmlValidatorParser extends XmlParser {

Reply via email to