[hibernate-issues] [Hibernate-JIRA] Updated: (HHH-5059) callouts and programlistings with highlighting
[
http://opensource.atlassian.com/projects/hibernate/browse/HHH-5059?page=c...
]
Gail Badner updated HHH-5059:
-----------------------------
Attachment: HHH-5059.patch
I'm attaching HHH-5059.patch for the English translations.
I'm getting the following error with "mvn jdocbook:update-pot
jdocbook:update-po":
[INFO] Searching repository for plugin with prefix: 'jdocbook'.
[INFO] ------------------------------------------------------------------------
[INFO] Building Hibernate Core Parent POM
[INFO] task-segment: [clean, jdocbook:update-pot, jdocbook:update-po]
[INFO] ------------------------------------------------------------------------
[INFO] [clean:clean {execution: default-clean}]
[INFO] ------------------------------------------------------------------------
[ERROR] BUILD ERROR
[INFO] ------------------------------------------------------------------------
[INFO] One or more required plugin parameters are invalid/missing for
'jdocbook:update-pot'
[0] Inside the definition for plugin 'maven-jdocbook-plugin' specify the
following:
<configuration>
...
<sourceDocumentName>VALUE</sourceDocumentName>
</configuration>.
callouts and programlistings with highlighting
----------------------------------------------
Key: HHH-5059
URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5059
Project: Hibernate Core
Issue Type: Bug
Components: documentation
Reporter: Steve Ebersole
Assignee: Gail Badner
Priority: Blocker
Fix For: 3.5.1
Attachments: HHH-5059.patch
Attempting to use callouts with programlistings that apply highlighting break
horrifically :( Actually it seems to be ok for pdf; still need to investigate more.
However it for certain goes horribly wrong on html formats.
We need to fix this and push a 3.5.1 asap to have proper 3.5 documentation available.
The problem is that this is an issue with the "JBoss.org jDocBook styles". And
the fix is not yet known nor expected to be trivial. So how long so we wait? Because the
work around is to remove the highlighting when using callouts; in other words, for all
<programlistingco> tags, we need to make sure the nested <programlisting> tags
do not specify the role attribute. Then when (if ever) the "JBoss.org jDocBook
styles" is fixed we will need to go and add back the highlighting.
--
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....
-
For more information on JIRA, see: http://www.atlassian.com/software/jira