(maven-doxia-site) branch drop-retired-pdf-plugin-reference created (now f961de7)

[sl...@apache.org]

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

slachiewicz pushed a change to branch drop-retired-pdf-plugin-reference
in repository https://gitbox.apache.org/repos/asf/maven-doxia-site.git


      at f961de7  Answer the PDF FAQ with what Doxia can actually do now

This branch includes the following new commits:

     new f961de7  Answer the PDF FAQ with what Doxia can actually do now

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

(maven-doxia-site) 01/01: Answer the PDF FAQ with what Doxia can actually do now

[sl...@apache.org]

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

slachiewicz pushed a commit to branch drop-retired-pdf-plugin-reference
in repository https://gitbox.apache.org/repos/asf/maven-doxia-site.git

commit f961de76d4383a72d2e5209a807c88e457d57178
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Sun Aug 9 13:05:04 2026 +0200

    Answer the PDF FAQ with what Doxia can actually do now
    
    Every renderer the answer named is gone. The iText and FO modules were removed in
    2.0.0-M1 by DOXIA-630, and the Maven PDF Plugin that built on them was retired in
    March 2025, so the entry sent readers to two deleted modules and one dead plugin.
    
    It stays a FAQ rather than being deleted — "how do I get a PDF" is still asked,
    and the useful answer is that Doxia 2.x has no PDF output at all, with the last
    pdf-plugin release named so nobody has to go digging for why it stopped working.
    
    Generated-by: Claude Opus 5 (1M context)
---
 content/fml/faq.fml | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/content/fml/faq.fml b/content/fml/faq.fml
index 35714cb..c9c4a7e 100644
--- a/content/fml/faq.fml
+++ b/content/fml/faq.fml
@@ -37,18 +37,14 @@ under the License.
       <question>How to export in PDF?</question>
       <answer>
         <p>
-          There are two modules available that can be used to generate pdf output: an
-          <a href="/doxia/doxia/doxia-modules/doxia-module-itext/">iText module</a>
-          that uses the
-          <a href="http://www.lowagie.com/iText/">iText</a> framework, and a
-          <a href="/doxia/doxia/doxia-modules/doxia-module-fo/">FO</a> module,
-          that can be used e.g. in conjunction with
-          <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> to generate a pdf.
-          Unfortunately, the iText team has discontinued the XML to PDF functionalities, so probably
-          only the fo module is going to be supported in the future.
+          Doxia no longer generates PDF. The two modules that used to do it, the iText module and the
+          FO module, were removed in Doxia 2.0.0-M1, see
+          <a href="https://issues.apache.org/jira/browse/DOXIA-630">DOXIA-630</a>.
         </p>
         <p>
-          For Maven there is a <a href="/plugins/maven-pdf-plugin/">pdf plugin</a> available.
+          The Maven PDF Plugin, which built on those modules, was retired in March 2025. Its final
+          release, 1.6.2, is still resolvable from Maven Central, but it is not maintained and the
+          modules it depends on only exist in the unmaintained Doxia 1.x line.
         </p>
       </answer>
     </faq>