Hi, I’ve one point which is not per se related to the 3.0 beta release, but which should be considered:
The 3.0 release changed some APIs in a source and binary incompatible way. E.g instead of using the PDDocument.load() method you now use the Loader class etc. It would be extremely helpful if PDFBox 2.0 could provide a kind of „Shim“ which provides the 3.0 API. E.g. implement a Loader class in PDFBox 2.0 - which internally just uses PDDocument.load(). At the same time you could depreciate the load() method in the PDDocument and document that the Loader should be used. This would allow to „migrate“ projects using PDFBox 2.0 to the 3.0 API while staying on PDFBox 2.0. As PDFBox 3.0 has the same namespace as PDFBox 2.0 I think this is needed to make the migration path as smooth as possible. Rational: More and more projects use PDFBox directly or indirectly (e.g. by using my PDFBox-Graphics2D wrapper - Apache POI for example). When you have a complex application you might have many dependencies which will pull in PDFBox 2.0. If they can work with PDFBox 3.0 because they migrated the API usage to the new API using the shim in PDFBox 2.0 you can upgrade to PDFBox 3.0 in your project. I.e. the lib targets PDFBox 2.0 but would work with 3.0. Otherwise you can only consider a upgrade to PDFBox 3.0 in your application after the last dependency has migrated to PDFBox 3.0. Which might take a long time… I.e. at the moment as PDFBox 3.0 has the same namespace as PDFBox 2.0 just upgrading to PDFBox 3.0 will break many things in dependencies. So you have to stay on 2.0 as long as not all dependencies have migrated... It would be very nice if we could avoid a version mess here. Greetings Emmeran > Am 11.01.2023 um 08:24 schrieb Andreas Lehmkuehler <andr...@lehmi.de>: > > Hi, > > I'm planning to cut our first beta release of 3.0.0. Be aware that the api is > supposed to be stable after the release. > > Are there any objections? Are there any tickets which should be solved before? > > Andreas > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@pdfbox.apache.org > For additional commands, e-mail: dev-h...@pdfbox.apache.org > Mit freundlichen Grüßen aus Augsburg Emmeran Seehuber Dipl. Inf. (FH) Schrannenstraße 8 86150 Augsburg USt-IdNr.: DE266070804