Skip to content

pdfbox-main-gap-analysis.md

Latest commit

 

History

History
67 lines (51 loc) · 2.29 KB

pdfbox-main-gap-analysis.md

File metadata and controls

67 lines (51 loc) · 2.29 KB
Raw

PDFBox Upstream Java Gap Analysis (All Modules)

Datetime (UTC): 2026-08-18T07:32:36.827Z Reference upstream Java repository: Apache PDFBox trunk Tracked parity baseline commit: 1187c45f9dcee38ed5ac12bc15df04913b348875 Latest upstream head scanned: 3c69bdf5a0b7927d99e7d6fa2a25712db0303fa6

Scope and method

  • Scanned all current upstream Java files under **/src/main/java/**/*.java.
  • Counted Java source as mapped using the canonical union of:
    • PDFBOX_SOURCE_PATH matches in src/**/*.cs, and
    • source_path rows in reports/traceability-parity-report.json.

Excluded upstream modules:

  • pdfbox-layout-fop: 4 Java files

Summary

Upstream module Java files Mapped C# ports Missing % Done
benchmark 3 3 0 100.0%
debugger 91 91 0 100.0%
examples 94 94 0 100.0%
fontbox 143 143 0 100.0%
io 18 18 0 100.0%
pdfbox 622 622 0 100.0%
pdfbox-layout-awt 3 3 0 100.0%
tools 26 26 0 100.0%
xmpbox 74 74 0 100.0%
TOTAL 1074 1074 0 100.0%

Library-core subset (pdfbox + fontbox + xmpbox + io) coverage: 857 / 857 = 100.0%.

Traceability status for mapped upstream source rows

Among 817 rows with scoped upstream source_path:

  • in-sync: 817
  • partially-in-sync: 0
  • partial: 0

100% parity gate

  • mapped == total and missing == 0 for the scoped upstream Java inventory.
  • No partial or partially-in-sync rows remain for scoped upstream source_path entries.
  • Build and tests are green on the parity branch.

File-by-file report

The generated reports/upstream-file-comparison.json contains one row for each scoped upstream Java file, including mapping evidence and metadata-gap classification.

Gap category Files
missing-port 0
missing-provenance-marker 1
missing-traceability-row 263
none 810
Gap category Module Files
missing-provenance-marker pdfbox 1
missing-traceability-row benchmark 3
missing-traceability-row fontbox 93
missing-traceability-row io 8
missing-traceability-row pdfbox 133
missing-traceability-row tools 26