[ http://issues.apache.org/jira/browse/DERBY-279?page=comments#action_65314 ] scott hutinger commented on DERBY-279: --------------------------------------
This patch by Jeff has been validated to fix the doc build stopping due to errors. The patch fixes the problem when having a specific pathname length that will not build the docs. Xerces is a portion of this problem. But in a known non-buildable pathlength, this patch fixes the build problem. Please commit the patch and close the issue :-) I would also say this is a show-stopper bug, not a minor bug. I would escalate this bug to major, or whatever, then close it. Due to it's seemingly randomness. This validation was on a x86 linux platform. Without the patch: [xslt] home/srh/src/derby-d/doc/trunk/temp/ttoolsjarload1003120.dita:15:486: Fatal Error! XML document structures must start and end within the same entity. With the patch: BUILD SUCCESSFUL > Tagging in DITA docs causes Derby builds to fail. > ------------------------------------------------- > > Key: DERBY-279 > URL: http://issues.apache.org/jira/browse/DERBY-279 > Project: Derby > Type: Bug > Components: Documentation > Environment: all > Reporter: Jeff Levitt > Assignee: Jeff Levitt > Priority: Minor > Attachments: pubtags.diff > > There seems to be a tag in the DITA docs at the end of most of the files (I > found it in almost 500 of them). I think the tag was generated by the tool I > had used to create the DITA files originally during the migration to DITA. > In any case, the tag is formatted like this: <?pub *xxxxxxxxx?>, where the > x's are a string of numbers. I know these tags are unnecessary for our docs, > but until now I didn't think they affected anything. However, in researching > why the doc builds sometimes fail for different users and different > platforms, it occured to me that it could be because of this tag. The build > failure usually logs that files need to "start and end with the same entity." > Well, if this pub tag is at the end of a file, then it could be causing the > problem. Indeed, I just had a build failure, then removed the pub tag, and > the build succeeded. So I would like to remove these arbitrary tags from all > of the doc files. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira
