Red Hat Bugzilla – Bug 723399
Fatal error when building default book using JBoss brand
Last modified: 2013-07-29 19:27:14 EDT
Description of problem:
Creating a new book using the JBoss brand will result in a book that will not build because the common content Feedback section now uses several new entities that are not defined with placeholders in the generated bookname.ent file
It actually produces a FATAL ERROR.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. publican create book --name jtest --brand JBoss
2. publican build --formats=html --lang=en-US
FATAL ERROR: parser:27 in Common_Content/Feedback.xml on line 61: Entity 'BZURL' not defined
at /usr/bin/publican line 672
Book will not build until you add entries for BZURL, BZCOMPONENT and BZPRODUCT in bookname.ent
Book builds with placeholder content for those entities, like it does with the HOLDER entity
Note: have been told that this is "expected behaviour" for this brand because there is no way to specify entities at the brand level.
Suggest the place holders could be added into the default .ent file, with a comment in the entities file saying that these are a workaround the brand and they can be removed if that brand is not used.
Fatal errors should not be the output of using supplied defaults.
The brand has no access to the entities file of a book, so I can't see any way to pre-populate these entities for a new book.
Having new books fail to build until these entities are populated is the cost of including entities like this in the brand.