[hibernate-dev] Can't build Hibernate ORM 5.1 documentation

[Vlad Mihalcea]

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 <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
>> 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
>>
>