You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ms...@apache.org on 2026/08/26 07:41:45 UTC

svn commit: r1937471 - pdfbox/branches/2.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/fdf

Author: msahyoun
Date: Wed Aug 26 07:41:45 2026
New Revision: 1937471

Log:
PDFBOX-6242: enhance javadoc

Modified:
   pdfbox/branches/2.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/fdf/FDFUtils.java

Modified: pdfbox/branches/2.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/fdf/FDFUtils.java
==============================================================================
--- pdfbox/branches/2.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/fdf/FDFUtils.java	Wed Aug 26 07:38:25 2026	(r1937470)
+++ pdfbox/branches/2.0/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/fdf/FDFUtils.java	Wed Aug 26 07:41:45 2026	(r1937471)
@@ -24,11 +24,17 @@ public class FDFUtils {
     private static final Log LOG = LogFactory.getLog(FDFUtils.class);
 
     /**
-     * Escape special characters.
+     * Escapes special characters for use in XML 1.0.
+     * <p>
+     * Characters that are not permitted in XML 1.0 are replaced with the
+     * Unicode replacement character (U+FFFD). If one or more characters are
+     * replaced, the number of replacements is logged at INFO level.
+     * </p>
      *
      * @param input the string to be escaped.
      *
-     * @return the resulting string
+     * @return the resulting string with XML special characters escaped and
+     *         characters invalid in XML 1.0 replaced with U+FFFD.
      */
     static String escapeXML10(String input)
     {