This is an automated email from the ASF dual-hosted git repository.
lehmi pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/pdfbox-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 07b58f4d Site checkin for project Apache PDFBox Website
07b58f4d is described below
commit 07b58f4de08d8f582129a21aeb257d2dda9ed6d5
Author: Andreas Lehmkühler <andr...@lehmi.de>
AuthorDate: Tue Jan 2 11:24:30 2024 +0100
Site checkin for project Apache PDFBox Website
---
content/2.0/commandline.html | 2 +-
content/2.0/cookbook/encryption.html | 2 +-
content/2.0/dependencies.html | 2 +-
content/2.0/examples.html | 2 +-
content/2.0/faq.html | 2 +-
content/2.0/getting-started.html | 2 +-
content/2.0/migration.html | 2 +-
content/3.0/commandline.html | 6 ++++-
content/3.0/dependencies.html | 6 ++++-
content/{2.0 => 3.0}/faq.html | 44 ++++++++++++++++++------------------
content/3.0/getting-started.html | 6 ++++-
content/3.0/migration.html | 9 ++++++--
content/4.0/migration.html | 25 ++++++++++++++------
content/blog/index.html | 3 ++-
content/building.html | 3 ++-
content/codingconventions.html | 3 ++-
content/download.html | 3 ++-
content/errors/403.html | 3 ++-
content/errors/404.html | 3 ++-
content/ideas.html | 3 ++-
content/index.html | 3 ++-
content/mailinglists.html | 3 ++-
content/references.html | 3 ++-
content/security.html | 3 ++-
content/siteupdate.html | 3 ++-
content/support.html | 6 +++--
content/team.html | 3 ++-
27 files changed, 99 insertions(+), 56 deletions(-)
diff --git a/content/2.0/commandline.html b/content/2.0/commandline.html
index 2ee64db8..fc9859bf 100644
--- a/content/2.0/commandline.html
+++ b/content/2.0/commandline.html
@@ -740,7 +740,7 @@ To override the filename use the <code>outputPrefix</code>
option.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/cookbook/encryption.html
b/content/2.0/cookbook/encryption.html
index 4db36da2..c21d10d3 100644
--- a/content/2.0/cookbook/encryption.html
+++ b/content/2.0/cookbook/encryption.html
@@ -157,7 +157,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/dependencies.html b/content/2.0/dependencies.html
index 2298ee31..18dffccb 100644
--- a/content/2.0/dependencies.html
+++ b/content/2.0/dependencies.html
@@ -239,7 +239,7 @@ directory. You can then simply copy all the libraries you
need from this directo
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/examples.html b/content/2.0/examples.html
index 31411ab9..fd94979c 100644
--- a/content/2.0/examples.html
+++ b/content/2.0/examples.html
@@ -148,7 +148,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/faq.html b/content/2.0/faq.html
index 26de4a46..5148bcae 100644
--- a/content/2.0/faq.html
+++ b/content/2.0/faq.html
@@ -343,7 +343,7 @@ but these would cost additional time and memory space. You
can have a higher qua
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/getting-started.html b/content/2.0/getting-started.html
index 1c76aa3c..482c6d4b 100644
--- a/content/2.0/getting-started.html
+++ b/content/2.0/getting-started.html
@@ -165,7 +165,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/migration.html b/content/2.0/migration.html
index 267875be..90eeeb92 100644
--- a/content/2.0/migration.html
+++ b/content/2.0/migration.html
@@ -336,7 +336,7 @@ To understand this yourself, view any file with PDFDebugger
and have a look at t
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/3.0/commandline.html b/content/3.0/commandline.html
index cb47d450..7059f1c9 100644
--- a/content/3.0/commandline.html
+++ b/content/3.0/commandline.html
@@ -100,6 +100,10 @@
<a href="/3.0/commandline.html" >
Command-Line Tools
</a>
+ </li><li>
+ <a href="/3.0/faq.html" >
+ FAQ
+ </a>
</li><li>
<a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0-alpha3/index.html"; >
API Docs <small>via javadoc.io</small>
@@ -922,7 +926,7 @@ To override the filename use the <code>outputPrefix</code>
option.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/3.0/dependencies.html b/content/3.0/dependencies.html
index e9aa5de8..dbcdcf9a 100644
--- a/content/3.0/dependencies.html
+++ b/content/3.0/dependencies.html
@@ -100,6 +100,10 @@
<a href="/3.0/commandline.html" >
Command-Line Tools
</a>
+ </li><li>
+ <a href="/3.0/faq.html" >
+ FAQ
+ </a>
</li><li>
<a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0-alpha3/index.html"; >
API Docs <small>via javadoc.io</small>
@@ -205,7 +209,7 @@ included in the Java platform.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/2.0/faq.html b/content/3.0/faq.html
similarity index 91%
copy from content/2.0/faq.html
copy to content/3.0/faq.html
index 26de4a46..bfc65f1b 100644
--- a/content/2.0/faq.html
+++ b/content/3.0/faq.html
@@ -85,40 +85,27 @@
<nav class="accordion-menu" role="navigation">
<h1>Documentation</h1>
<ul><li>
- <a href="/2.0/migration.html" >
+ <a href="/3.0/migration.html" >
Migration
</a>
</li><li>
- <a href="/2.0/getting-started.html" >
+ <a href="/3.0/getting-started.html" >
Getting Started
</a>
</li><li>
- <a href="/2.0/examples.html" >
- Examples
- </a>
- </li><li>
- <a href="/2.0/dependencies.html" >
+ <a href="/3.0/dependencies.html" >
Dependencies
</a>
- </li><li class="has-children">
- <input type="checkbox" checked>
- <i></i>
- <label>Cookbook</label>
- <ul><li>
- <a href="/2.0/cookbook/encryption.html" >
- Encrypting a File
- </a>
- </li></ul>
</li><li>
- <a href="/2.0/commandline.html" >
+ <a href="/3.0/commandline.html" >
Command-Line Tools
</a>
</li><li>
- <a href="/2.0/faq.html" >
+ <a href="/3.0/faq.html" >
FAQ
</a>
</li><li>
- <a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/2.0.27/index.html"; >
+ <a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0-alpha3/index.html"; >
API Docs <small>via javadoc.io</small>
</a>
</li>
@@ -151,7 +138,7 @@ PDDocument object.</p>
don't then the document will not be closed properly. Also, you must close all
PDDocument objects that get created. The following code creates
<strong>two</strong>
PDDocument objects; one from the "new PDDocument()" and the second
by the load method.</p>
-<pre class="language-java"><code class="language-java"><span class="token
class-name">PDDocument</span> doc <span class="token operator">=</span> <span
class="token keyword">new</span> <span class="token
class-name">PDDocument</span><span class="token punctuation">(</span><span
class="token punctuation">)</span><span class="token
punctuation">;</span><br><span class="token keyword">try</span><br><span
class="token punctuation">{</span><br> doc <span class="token
operator">=</span> <spa [...]
+<pre class="language-java"><code class="language-java"><span class="token
class-name">PDDocument</span> doc <span class="token operator">=</span> <span
class="token keyword">new</span> <span class="token
class-name">PDDocument</span><span class="token punctuation">(</span><span
class="token punctuation">)</span><span class="token
punctuation">;</span><br><span class="token keyword">try</span><br><span
class="token punctuation">{</span><br> doc <span class="token
operator">=</span> <spa [...]
<h2 id="font-handling" tabindex="-1">Font Handling</h2>
<p><a name="fontencoding"></a></p>
<h3
id="i'm-getting-java.lang.illegalargumentexception%3A-...-is-not-available-in-this-font's-encoding%3A-winansiencoding"
tabindex="-1">I'm getting java.lang.IllegalArgumentException: ... is not
available in this font's encoding: WinAnsiEncoding</h3>
@@ -245,11 +232,21 @@ but these would cost additional time and memory space.
You can have a higher qua
<p><a name="badraster"></a></p>
<h3
id="what-to-do-with-the-illegalargumentexception-%22numbers-of-source-raster-bands-and-source-color-space-components-do-not-match%22%3F"
tabindex="-1">What to do with the IllegalArgumentException "Numbers of
source Raster bands and source color space components do not match"?</h3>
<p>Sadly, this is a known bug in Java Imaging. Use the twelvemonkeys library
as described in the <a href="dependencies.html">dependencies</a> page.</p>
+<h3 id="does-pdfbox-support-complex-scripts%3F" tabindex="-1">Does PDFBox
support complex scripts?</h3>
+<p>Thanks to contributions we have supported Bengali and Latin ligatures since
3.0.0.
+Starting with version 3.0.2 we also support Devanagari and Gujarati.
+However there are some caveats: PDFBox will support only one language in a
specific font, thus it is
+best to use a font that is specific enough, e.g. the <a
href="https://pagure.io/lohit";>Lohit fonts</a>.
+For example, the Mangal font is meant to be a Devangari font, but PDFBox will
choose Bengali
+because that one is also claimed to be supported and is checked first.
+It is not possible to deactivate the feature.
+The features may be incomplete because we do not yet support all GSUB tables,
+and we don't support GPOS at all.</p>
</section>
<aside>
- <h1>Table of Contents<a class="edit-link"
href="https://github.com/apache/pdfbox-docs/edit/master/./content/2.0/faq.md";
title="Edit this page">
+ <h1>Table of Contents<a class="edit-link"
href="https://github.com/apache/pdfbox-docs/edit/master/./content/3.0/faq.md";
title="Edit this page">
<svg xmlns="http://www.w3.org/2000/svg"; width="16" height="16"
viewBox="0 0 16 16"><path fill-rule="evenodd" d="M11.013 1.427a1.75 1.75 0
012.474 0l1.086 1.086a1.75 1.75 0 010 2.474l-8.61
8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 01-.927-.928l.929-3.25a1.75
1.75 0 01.445-.758l8.61-8.61zm1.414 1.06a.25.25 0 00-.354 0L10.811 3.75l1.439
1.44 1.263-1.263a.25.25 0 000-.354l-1.086-1.086zM11.189 6.25L9.75 4.81l-6.286
6.287a.25.25 0 00-.064.108l-.558 1.953 1.953-.558a.249.249 0 00 [...]
</a></h1>
@@ -328,6 +325,9 @@ but these would cost additional time and memory space. You
can have a higher qua
<li><a
href="#what-to-do-with-the-illegalargumentexception-%22numbers-of-source-raster-bands-and-source-color-space-components-do-not-match%22%3F">What
to do with the IllegalArgumentException "Numbers of source Raster bands and
source color space components do not match"?</a>
</li>
+
+ <li><a href="#does-pdfbox-support-complex-scripts%3F">Does
PDFBox support complex scripts?</a>
+ </li>
</ol>
</li>
</ol>
@@ -343,7 +343,7 @@ but these would cost additional time and memory space. You
can have a higher qua
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/3.0/getting-started.html b/content/3.0/getting-started.html
index f00b955d..5594e1b3 100644
--- a/content/3.0/getting-started.html
+++ b/content/3.0/getting-started.html
@@ -100,6 +100,10 @@
<a href="/3.0/commandline.html" >
Command-Line Tools
</a>
+ </li><li>
+ <a href="/3.0/faq.html" >
+ FAQ
+ </a>
</li><li>
<a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0-alpha3/index.html"; >
API Docs <small>via javadoc.io</small>
@@ -148,7 +152,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/3.0/migration.html b/content/3.0/migration.html
index ceeb9b41..cf1ccefb 100644
--- a/content/3.0/migration.html
+++ b/content/3.0/migration.html
@@ -100,6 +100,10 @@
<a href="/3.0/commandline.html" >
Command-Line Tools
</a>
+ </li><li>
+ <a href="/3.0/faq.html" >
+ FAQ
+ </a>
</li><li>
<a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0-alpha3/index.html"; >
API Docs <small>via javadoc.io</small>
@@ -221,9 +225,10 @@ as they are treated to be of <strong>internal use
only</strong>.</p>
<p>The input file must not be used as output for saving operations. It will
corrupt the file and throw an exception as parts of the file are read the first
time when saving it.</p>
<h3 id="reduced-memory-usage" tabindex="-1">Reduced memory usage</h3>
<h4 id="incremental-parsing" tabindex="-1">Incremental Parsing</h4>
-<p>PDFBox now loads a PDF Document incrementally reducing the initial memory
footprint. This will also reduce the memory needed to
+<p>PDFBox now loads a PDF Document incrementally reducing the initial memory
footprint (on demand parsing). This will also reduce the memory needed to
consume a PDF if only certain parts of the PDF are accessed. Note that, due to
the nature of PDF, uses such as iterating over all pages,
accessing annotations, signing a PDF etc. might still load all parts of the
PDF overtime which might consume a significant amount of memory.</p>
+<p>Do not try to access parts of the document after the PDDocument object has
been closed, because this may lead to incorrect results, as shown in <a
href="https://issues.apache.org/jira/browse/PDFBOX-5720";>PDFBOX-5720</a>.</p>
<h4 id="improved-io-operations" tabindex="-1">Improved IO operations</h4>
<p>The introduction of the new io classes has a positive impact on the memory
usage. Especially the re-usage of the source for reading parts of it instead of
using intermediate streams reduces the memory footprint significantly.</p>
<h4 id="further-optimizations" tabindex="-1">Further optimizations</h4>
@@ -349,7 +354,7 @@ of Adobe Reader. If you'd like to bypass this use
<code>PDDocumentCatalog.getAcr
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/4.0/migration.html b/content/4.0/migration.html
index 656d3906..965cf557 100644
--- a/content/4.0/migration.html
+++ b/content/4.0/migration.html
@@ -109,18 +109,17 @@ to PDFBox 4.0. It provides information about the new,
deprecated and unsupported
<h2 id="dependency-updates" tabindex="-1">Dependency Updates</h2>
<p>All libraries on which PDFBox depends are updated to their latest stable
versions:</p>
<ul>
-<li>Bouncy Castle 1.75</li>
-<li>Apache Commons Logging 1.2</li>
-<li>picocli 4.7.4</li>
+<li>Bouncy Castle 1.77</li>
+<li>Apache Log4j 2.22.1</li>
+<li>picocli 4.7.5</li>
</ul>
<p>For test support the libraries are updated to</p>
<ul>
-<li>JUnit 5.10.0</li>
+<li>JUnit 5.10.1</li>
<li>JAI Image Core 1.4.0</li>
<li>JAI JPEG2000 1.4.0</li>
<li>Apache JBIG ImageIO Plugin 3.0.4</li>
-<li>Apache Commons IO 2.13</li>
-<li>Apache Log4j 2.20.0</li>
+<li>Apache Commons IO 2.15.0</li>
</ul>
<h2 id="general-changes-for-pdfbox-4.0" tabindex="-1">General Changes for
PDFBox 4.0</h2>
<p>This section explains the fundamental differences between PDFBox 4.0 and
3.x releases.</p>
@@ -129,6 +128,15 @@ to PDFBox 4.0. It provides information about the new,
deprecated and unsupported
was still limited to PDF/A 1B.</p>
<p>People looking for an open source preflight solution might check <a
href="https://verapdf.org/";>VeraPDF</a>. The VeraPDF parser is based on a
PDFBox fork and
was stream lined to fit their needs. But VeraPDF is still using the PDFBox
parser as possible alternative.</p>
+<h3 id="switch-to-apache-log4j" tabindex="-1">Switch to Apache Log4j</h3>
+<p>Apache Commons Logging was replaced by Apache Log4j, some of the obvious
reasons were</p>
+<ul>
+<li>maintainabilty and performance</li>
+<li>flexibility</li>
+<li>JPMS support</li>
+<li>lambda logging support</li>
+</ul>
+<p><a href="https://issues.apache.org/jira/browse/PDFBOX-5695";>PDFBOX-5695</a>
provides more details about the reasons and the transition itself.</p>
</section>
<aside>
@@ -152,6 +160,9 @@ was stream lined to fit their needs. But VeraPDF is still
using the PDFBox parse
<li><a href="#preflight-was-removed">Preflight was
removed</a>
</li>
+
+ <li><a href="#switch-to-apache-log4j">Switch to Apache
Log4j</a>
+ </li>
</ol>
</li>
</ol>
@@ -167,7 +178,7 @@ was stream lined to fit their needs. But VeraPDF is still
using the PDFBox parse
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/blog/index.html b/content/blog/index.html
index d3d19243..b09d94f4 100644
--- a/content/blog/index.html
+++ b/content/blog/index.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -476,7 +477,7 @@ PDFBox 1.8 or earlier an overview about things to look at
when switching over. M
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/building.html b/content/building.html
index fa2b4cea..1727e896 100644
--- a/content/building.html
+++ b/content/building.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -204,7 +205,7 @@ cd pdfbox-jbig2</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/codingconventions.html b/content/codingconventions.html
index c25a51e6..c3b3777f 100644
--- a/content/codingconventions.html
+++ b/content/codingconventions.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -307,7 +308,7 @@ you invoke <em>Source -> Organize Imports</em>
(<code>Ctrl+Shift+O</code>).</
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/download.html b/content/download.html
index f1454831..f47fddcb 100644
--- a/content/download.html
+++ b/content/download.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -441,7 +442,7 @@ Section 740.13) for both object code and source code.
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/errors/403.html b/content/errors/403.html
index edde8dd3..fa53bd1c 100644
--- a/content/errors/403.html
+++ b/content/errors/403.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -173,7 +174,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/errors/404.html b/content/errors/404.html
index c1cdae49..3c461593 100644
--- a/content/errors/404.html
+++ b/content/errors/404.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -173,7 +174,7 @@
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/ideas.html b/content/ideas.html
index 5fd4701e..9afcffc8 100644
--- a/content/ideas.html
+++ b/content/ideas.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -224,7 +225,7 @@ level. This could in addition be a good basis for PDF/A and
other compliance che
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/index.html b/content/index.html
index 236c5c74..eab57e5f 100644
--- a/content/index.html
+++ b/content/index.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -250,7 +251,7 @@ Apache PDFBox version 2.0.28. It is available for download
at:</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/mailinglists.html b/content/mailinglists.html
index 24dc2773..510ce858 100644
--- a/content/mailinglists.html
+++ b/content/mailinglists.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -218,7 +219,7 @@ to the <strong>Commit Mailing List</strong>.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/references.html b/content/references.html
index 273ac0a9..9a30b44f 100644
--- a/content/references.html
+++ b/content/references.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -302,7 +303,7 @@ Please file an <a
href="https://issues.apache.org/jira/browse/PDFBOX";>improvemen
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/security.html b/content/security.html
index 29254ea1..3e828f9f 100644
--- a/content/security.html
+++ b/content/security.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -186,7 +187,7 @@ unexpected amounts of memory.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/siteupdate.html b/content/siteupdate.html
index 99443112..a06fc70a 100644
--- a/content/siteupdate.html
+++ b/content/siteupdate.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -268,7 +269,7 @@ all generated sources in the project first.</p>
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/support.html b/content/support.html
index e186669d..e5adc316 100644
--- a/content/support.html
+++ b/content/support.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -157,7 +158,7 @@
<h2 id="questions-about-how-to-use-pdfbox" tabindex="-1">Questions About How
to Use PDFBox</h2>
<p>If you have questions about how to use PDFBox do ask on the <a
href="/mailinglists.html" title="Subscribe to Mailing List">Users Mailing
List</a>. This will get you help from the entire community.</p>
<p>The PDFBox examples and the test code in the sources will also provide
additional information.</p>
-<p>And there are additonal resources available on sites such as <a
href="http://stackoverflow.com/search?q=pdfbox"; title="Stack Overflow">Stack
Overflow</a>.</p>
+<p>And there are additonal resources available on sites such as <a
href="http://stackoverflow.com/search?q=pdfbox";>Stack Overflow</a>.</p>
<h2 id="filing-a-bug-report-or-enhancement-request" tabindex="-1">Filing a Bug
Report or Enhancement Request</h2>
<p class="alert alert-info">Please refrain from immediately opening a ticket
in the JIRA issue tracker unless
you are really certain it's a problem in the PDFBox software. Try using the
Mailing Lists first.</p>
@@ -178,6 +179,7 @@ you are really certain it's a problem in the PDFBox
software. Try using the Mail
<li>Attach the shortest possible code that reproduces the problem. Insert java
code between {code}...{code}. Or try to reproduce the problem with the
command-line applications.</li>
<li>Mention what you were doing, what was the expected behaviour, and what
happened instead</li>
<li>Provide a stack trace of an exception if there is one</li>
+<li>Make sure logging is active up to INFO level, and include the log
output</li>
<li>Be patient: all the people here are unpaid volunteers who work for you in
their free time</li>
</ul>
<p><strong>And please DON'T</strong></p>
@@ -201,7 +203,7 @@ you are really certain it's a problem in the PDFBox
software. Try using the Mail
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
diff --git a/content/team.html b/content/team.html
index 709f97f2..8a1fdec2 100644
--- a/content/team.html
+++ b/content/team.html
@@ -110,6 +110,7 @@
<li><a href="/3.0/getting-started.html">Getting
Started</a></li>
<li><a
href="/3.0/dependencies.html">Dependencies</a></li>
<li><a href="/3.0/commandline.html">Command-Line
Tools</a></li>
+ <li><a href="/3.0/faq.html">FAQ</a></li>
<li><a
href="https://javadoc.io/doc/org.apache.pdfbox/pdfbox/3.0.0/index.html";>API
Docs <small>via javadoc.io</small></a></li>
</ul>
</li>
@@ -312,7 +313,7 @@ Get involved today. All contributions to the project are
greatly appreciated.</p
<!-- nothing in here on purpose -->
</div>
<div class="span9">
- <p>Copyright © 2009–2023 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
+ <p>Copyright © 2009–2024 <a
href="https://www.apache.org/";>The Apache Software Foundation</a>. Licensed
under the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.
<br>Apache PDFBox, PDFBox, Apache, the Apache feather logo
and the Apache PDFBox project logos are trademarks of The Apache Software
Foundation.</p>
</div>
</div>
