[ https://issues.apache.org/jira/browse/XERCESC-2102?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17115559#comment-17115559 ]
Roger Leigh commented on XERCESC-2102: -------------------------------------- As a point of reference, I've recently done a full conversion of the Xalan-C++ documentation to Markdown, hosted on GitHub Pages: [link|https://apache.github.io/xalan-c/]. The equivalent could be done for Xerces-C++. The sources are here: https://github.com/apache/xalan-c/tree/master/docs For Xalan, the website links are still all intact; they are all redirects to the new pages. See https://xalan.staged.apache.org and any link under /xalan-c (including the API reference) will be correctly redirected. If that type of conversion would be agreeable, I'd be happy to repeat the process for Xerces-C++. > Documentation is not generatable on modern systems > -------------------------------------------------- > > Key: XERCESC-2102 > URL: https://issues.apache.org/jira/browse/XERCESC-2102 > Project: Xerces-C++ > Issue Type: Bug > Components: Documentation > Reporter: Roger Leigh > Priority: Major > > 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 (v8.3.4#803005) --------------------------------------------------------------------- To unsubscribe, e-mail: c-dev-unsubscr...@xerces.apache.org For additional commands, e-mail: c-dev-h...@xerces.apache.org