[hibernate-dev] Can't build Hibernate ORM 5.1 documentation
gbadner at redhat.com
Wed Nov 28 17:18:06 EST 2018
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
On Wed, Nov 28, 2018 at 5:19 AM Vlad Mihalcea <mihalcea.vlad at gmail.com>
> Form 5.2, we no longer have the DocBooks tasks.
> The only document using DocBook in 5.1 is the Integration Guide:
> We converted that to AsciiDoc in 5.2
> It's worth investigating whether we could remove them from 5.1 as well.
> On Wed, Nov 28, 2018 at 11:37 AM Gail Badner <gbadner at redhat.com> wrote:
>> Andrea found a solution that works. :)
>> On Tue, Nov 27, 2018 at 10:49 PM Gail Badner <gbadner at redhat.com> wrote:
>>> I'm getting ready to release 5.1.17, but I'm having trouble building the
>>> 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`:
>>> rendering Book(mappingGuide) en-US/html
>>> Extending script classloader with the jdocbookXsl dependencies
>>> redirecting console output to file
>>> 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
>>> > 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
>>> Any ideas???
More information about the hibernate-dev