Since this is the last 5.1.x release, I don't think it's worth doing anything more with the documentation in that branch unless absolutely necessary.
On Wed, Nov 28, 2018 at 5:19 AM Vlad Mihalcea <mihalcea.v...@gmail.com> wrote: > Hi, > > Form 5.2, we no longer have the DocBooks tasks. > > The only document using DocBook in 5.1 is the Integration Guide: > > http://docs.jboss.org/hibernate/orm/5.1/integrationsGuide/ > > We converted that to AsciiDoc in 5.2 > > http://docs.jboss.org/hibernate/orm/5.2/integrationguide/ > > It's worth investigating whether we could remove them from 5.1 as well. > > Vlad > > On Wed, Nov 28, 2018 at 11:37 AM Gail Badner <gbad...@redhat.com> wrote: > >> Andrea found a solution that works. :) >> >> On Tue, Nov 27, 2018 at 10:49 PM Gail Badner <gbad...@redhat.com> wrote: >> >>> I'm getting ready to release 5.1.17, but I'm having trouble building the >>> documentation. >>> >>> I can't even build the documentation using 5.1.16 tag. It worked fine >>> when I released 5.1.16.Final in August. >>> >>> A new property was added for HHH-13011, and I need to get that >>> documented in the user guide for 5.1.17. >>> >>> Here is what I'm seeing when I execute `./gradlew buildDocs`: >>> >>> :documentation:renderDocBook_mappingGuide_en-US_html >>> rendering Book(mappingGuide) en-US/html >>> Extending script classloader with the jdocbookXsl dependencies >>> redirecting console output to file >>> [/home/gbadner/git/hibernate-orm-5.1-copy/documentation/target/docbook/work/mappingGuide/log/console-en-US-html.log] >>> >>> Error on line 1 column 1 of http://docbook.org/xml/5.0/dtd/docbook.dtd: >>> Error reported by XML parser: The markup declarations contained or >>> pointed to by the document type declaration must be well-formed. >>> Resetting console output >>> :documentation:renderDocBook_mappingGuide_en-US_html FAILED >>> >>> FAILURE: Build failed with an exception. >>> >>> * What went wrong: >>> Execution failed for task >>> ':documentation:renderDocBook_mappingGuide_en-US_html'. >>> > error rendering [org.xml.sax.SAXParseException; systemId: >>> http://docbook.org/xml/5.0/dtd/docbook.dtd; lineNumber: 1; >>> columnNumber: 1; The markup decl >>> arations contained or pointed to by the document type declaration must >>> be well-formed.] on Hibernate_Mapping_Guide.xml >>> >>> The log file >>> (/home/gbadner/git/hibernate-orm-5.1-copy/documentation/target/docbook/work/mappingGuide/log/console-en-US-html.log) >>> was empty. >>> >>> I'm attaching the console log from executing `./gradlew buildDocs --debug >>> --info`. >>> >>> Any ideas??? >>> >>> Thanks, >>> Gail >>> >> _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev