You are viewing a plain text version of this content. The canonical link for it is here.
Posted to c-dev@xerces.apache.org by "Roger Leigh (JIRA)" <xe...@xml.apache.org> on 2017/06/14 23:05:00 UTC

[jira] [Created] (XERCESC-2102) Documentation is not generatable on moderns systems

Roger Leigh created XERCESC-2102:
------------------------------------

             Summary: Documentation is not generatable on moderns systems
                 Key: XERCESC-2102
                 URL: https://issues.apache.org/jira/browse/XERCESC-2102
             Project: Xerces-C++
          Issue Type: Bug
          Components: Documentation
            Reporter: Roger Leigh


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

{noformat}
% 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
{noformat}



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@xerces.apache.org
For additional commands, e-mail: c-dev-help@xerces.apache.org