[pdfbox-docs] branch master updated: PDFBOX-5030: details for AcroForm fix up; add info for PDFBox app

[ms...@apache.org]

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

msahyoun pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pdfbox-docs.git


The following commit(s) were added to refs/heads/master by this push:
     new 1ff145b  PDFBOX-5030: details for AcroForm fix up; add info for PDFBox app
1ff145b is described below

commit 1ff145b0862fea1aca774b71fca40cc57b44d881
Author: Maruan Sahyoun <sa...@fileaffairs.de>
AuthorDate: Thu Jan 7 18:00:10 2021 +0100

    PDFBOX-5030: details for AcroForm fix up; add info for PDFBox app
---
 content/3.0/migration.md | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/content/3.0/migration.md b/content/3.0/migration.md
index 341e89f..0fc3555 100644
--- a/content/3.0/migration.md
+++ b/content/3.0/migration.md
@@ -25,7 +25,7 @@ eleventyNavigation:
 
 # PDFBox 3.0 Migration Guide
 
-<p class="alert alert-warning">Work in progress!  This is guide is improved over time. If you believe there is
+<p class="alert alert-warning">Work in progress!  This is guide will be improved over time. If you believe there is
 a missing topic, open an issue or help us with a contribution to improve the guide.
 </p>
 
@@ -74,4 +74,22 @@ accessing annotations, signing a PDF etc. might still load all parts of the PDF
 ### Interactive Forms
 
 When accessing `AcroForms` using `PDDocumentCatalog.getAcroForm()` a number of fix ups are applied aligning PDFBox with most of the default behaviour
-of Adobe Reader. If you'd like to bypass this use `PDDocumentCatalog.getAcroForm(null)`.
\ No newline at end of file
+of Adobe Reader. If you'd like to bypass this use `PDDocumentCatalog.getAcroForm(null)`.
+
+The fix ups include
+
+- setting default font resources if they are not already part of the AcroForm
+- create form fields from orphaned widget annotations under certain conditions
+- create the normal appearance stream under certain conditions
+
+You can lookup the details in the `org.apache.pdfbox.pdmodel.fixup` package of the source distribution and also create your own fix up(s).
+
+## Changes in PDFBox App
+
+The command line interface for the PDFBox App has been rewritten. As a result
+
+- the individual commands have been changed 
+- passing input and output files have been changed from using parameters to using options/flags to reduce the ambiguity
+- all commands now return an exit code
+- all commands now support passing `-h` or `--help` to display usage information
+- all commands now support passing `-V` or `--version` to display the version information
\ No newline at end of file