Clarified Parser instances are not threadsafe

#1892
jhy · Feb 18, 2023 · 6285062 · 6285062
1 parent e52224f
commit 6285062
Showing 1 changed file with 4 additions and 3 deletions.
diff --git a/src/main/java/org/jsoup/parser/Parser.java b/src/main/java/org/jsoup/parser/Parser.java
@@ -9,9 +9,10 @@
 import java.util.List;
 
 /**
- * Parses HTML into a {@link org.jsoup.nodes.Document}. Generally best to use one of the  more convenient parse methods
- * in {@link org.jsoup.Jsoup}.
- */
+ Parses HTML or XML into a {@link org.jsoup.nodes.Document}. Generally, it is simpler to use one of the parse methods in
+ {@link org.jsoup.Jsoup}.
+ <p>Note that a Parser instance object is not threadsafe. To reuse a Parser configuration in a multi-threaded
+ environment, use {@link #newInstance()} to make copies. */
 public class Parser {
     private TreeBuilder treeBuilder;
     private ParseErrorList errors;