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

[Gail Badner]

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.vlad at 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 <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
>>>
>>