[XERCESC-2102] Documentation is not generatable on modern systems

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: Documentation
• Assignee: Unassigned
• Reporter: Roger Leigh
• Created: 14/Jun/17 23:04
• Updated: 29/May/20 17:35

Description

The "stylebook" documentation format relies upon stylebook-1.0-b2.jar. Unfortunately this tool appears to no longer be developed and it no longer works with contemporary JREs due to relying upon

{com.sun.image.codec.jpeg.JPEGCodec}

which is no longer present. It's achievable by trying to find a Java 1.6 or earlier JRE, but this is becoming increasingly difficult to make work.

Was there ever a migration path from slidebook to any other format which is currently supported?

Would there be any interest in moving to a contemporary documentation format, and if so are there any preferred formats? At work we use Sphinx. I'd be happy to spend a few hours converting it to this or some other format which is currently supported.

Regards,
Roger

% make createdocs           
[StyleBook] Overriding targetDirectory="/home/rleigh/code/xerces-svn-trunk/doc/html" (Old=".")
[StyleBook] Project URL: "sbk:/sources/xerces-c_book.xml"
[BasicEngine] Initializing
[Loader] Parsing Project file
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/book2project.xsl"
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/directory2project.xsl"
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (1)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (2)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (3)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (4)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (5)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (6)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (7)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (8)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (9)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (10)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (11)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (12)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (13)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (14)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (15)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (16)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (17)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (18)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (19)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (20)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (21)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (22)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (23)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (24)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (25)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (26)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (27)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (28)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (29)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (30)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (31)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (32)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[CachingParser] Serving cached document "sbk:/style/stylesheets/any2project.xsl" (33)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2project.xsl"
[Project] Creating "faq-contributing-3.html"
[CachingParser] Serving cached document "sbk:/sources/faq-contributing.xml" (1)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/faqs2document.xsl"
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/document2html.xsl"
[CachingParser] Serving cached document "sbk:/sources/xerces-c_book.xml" (1)
[Project] Creating "enumval-3.html"
[CachingParser] Serving cached document "sbk:/sources/enumval.xml" (1)
[CachingParser] Serving cached document "sbk:/style/stylesheets/document2html.xsl" (1)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/document2html.xsl"
[CachingParser] Serving cached document "sbk:/sources/xerces-c_book.xml" (2)
[Project] Creating "resources/button-xml-lo.gif"
[Project] Creating "graphics/migrate-archive-3-header.jpg"
[CachingParser] Serving cached document "sbk:/sources/migration_archive.xml" (1)
[XalanProcessor] Applying XSL sheet "sbk:/style/stylesheets/any2header.xsl"
Exception in thread "main" java.lang.NoClassDefFoundError: com/sun/image/codec/jpeg/JPEGCodec
        at org.apache.stylebook.printers.ImagePrinter.print(ImagePrinter.java:148)
        at org.apache.stylebook.BasicEntry.create(BasicEntry.java:69)
        at org.apache.stylebook.Project.create(Project.java:68)
        at org.apache.stylebook.StyleBook.main(StyleBook.java:92)
Caused by: java.lang.ClassNotFoundException: com.sun.image.codec.jpeg.JPEGCodec
        at java.net.URLClassLoader.findClass(URLClassLoader.java:381)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:335)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
        ... 4 more
doc/CMakeFiles/createdocs.dir/build.make:57: recipe for target 'doc/CMakeFiles/createdocs' failed
make[3]: *** [doc/CMakeFiles/createdocs] Error 1
CMakeFiles/Makefile2:120: recipe for target 'doc/CMakeFiles/createdocs.dir/all' failed
make[2]: *** [doc/CMakeFiles/createdocs.dir/all] Error 2
CMakeFiles/Makefile2:127: recipe for target 'doc/CMakeFiles/createdocs.dir/rule' failed
make[1]: *** [doc/CMakeFiles/createdocs.dir/rule] Error 2
Makefile:186: recipe for target 'createdocs' failed
make: *** [createdocs] Error 2