[
https://issues.apache.org/jira/browse/XERCESC-2102?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16057535#comment-16057535
]
Scott Cantor commented on XERCESC-2102:
---------------------------------------
I would agree that markdown would be preferable to anything involving a
publishing toolchain. The challenge here is the existing site and all the
conversion required and the overlap with Xerces-J.
Whereas at the moment, modulo the Java 6 issue, I do have accurate instructions
for building the site and have gotten the overall set of files needing to be
tweaked to a fair minimum when releases get done.
I don't think we should spend the effort to convert unless the result at the
end doesn't involve having to check the site's files into svn and require any
real work when releases are done. Bump a version and move on should be the only
*required* step. Otherwise security fixes become a mess of unrelated work when
the only real goal is "get fix out".
The Santuario project has a cwiki site set up that auto-publishes to the ASF
web site and while the look and feel may be awful, that is of no concern since
the docs are out of date and useless anyway. It minimizes release effort.
> 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
>
> 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-unsubscr...@xerces.apache.org
For additional commands, e-mail: c-dev-h...@xerces.apache.org
