...

Author: cowtowncoder

src/main/java/tools/jackson/dataformat/xml/ser/ToXmlGenerator.java

@@ -266,6 +266,7 @@ public void initGenerator() throws JacksonException
                     _xmlWriter.writeStartDocument(encoding, xmlVersion);
                 }
                 // 20-Apr-2026, tatu: for legacy path, only output prolog lf when pretty-printing
+                //    OR _lfBetweenPrologDirectives passed by initializer
                 if (_lfBetweenPrologDirectives || _xmlPrettyPrinter != null) {
                     _prologLinefeed();
                 }

src/main/java/tools/jackson/dataformat/xml/ser/XmlGeneratorInitializer.java

@@ -16,7 +16,9 @@
  * {@link ObjectWriter#with(GeneratorInitializer)}.
  * It allows output of various document-level things such as
  *<ul>
- * <li>Document Type Declarations (DTD); that is "&lt;!DOCTYPE>" directive 
+ * <li>Document Type Declarations (DTD); that is "&lt;!DOCTYPE>" directive
+ *  </li>
+ * <li>XML Comments (in Document prolog, before the root element)
  *  </li>
  * </ul>
  *<p>