[hibernate-issues] [Hibernate-JIRA] Commented: (HHH-5525) Convert Getting Started Guide to use DocBook 5

[Steve Ebersole (JIRA)]

    [ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=38311#action_38311 ] 

Steve Ebersole commented on HHH-5525:
-------------------------------------

The issue from my last comment was specific to {{<info/>}}.  Personally I never liked splitting the older {{<bookinfo/>}} tag into its own file anyway, so I dont really care about that.  Folding Book_Info.xml back into the main doc as {{<info/>}} got around that issue.  And the other tags we use as top-level in file did not have same issue.

However, I am rolling back my local work here as this will require some jDocBook work to properly support.  Here is the basic structure for using version 5:
{code}
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE book [
    <!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Getting_Started_Guide.ent">
    %BOOK_ENTITIES;
]>

<book version="5.0" xmlns="http://docbook.org/ns/docbook"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xmlns:xlink="http://www.w3.org/1999/xlink">
    ...
</book>
{code}

> Convert Getting Started Guide to use DocBook 5
> ----------------------------------------------
>
>                 Key: HHH-5525
>                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5525
>             Project: Hibernate Core
>          Issue Type: Task
>          Components: documentation
>            Reporter: Steve Ebersole
>            Assignee: Steve Ebersole
>             Fix For: 3.6.0.CR1
>
>
> This may require work on jDocBook to support, not sure.  For sure we will need a docbook 5 bundle for maven respoitory

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira