[ http://issues.apache.org/jira/browse/DERBY-1566?page=all ]
Jean T. Anderson updated DERBY-1566:
------------------------------------
Attachment: ErrorMessageGenerator.david.diffs
rrefexcept71493.html
The ErrorMessageGenerator.david.java is almost there -- it does produce a file
without any errors, but it's missing some format and tags so the DITA doc build
fails. More details about the fixes for that are below but, first, I attached
two files:
ErrorMessageGenerator.david.diffs - has the diffs between
ErrorMessageGenerator.david.java and what I got working.
rrefexcept71493.html: sample output for derby 10.2.1.1
Here are more details for the changes to the java application:
(1) The xml processing is sensitive to spacing -- or at least it is for DITA
processing. This format fails (notice the lack of a space before the words
'encoding' and 'xml'):
<?xml version="1.0 "encoding="utf-8"?>
<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<reference id="rrefexcept71493 "xml:lang="en-us">
This format works (and note the switch from IBM to OASIS):
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
"../dtd/reference.dtd">
<reference id="rrefexcept71493" xml:lang="en-us">
(2) Fix malformed close tags for <entry> and <title>:
< sqlState + "/>");
---
> sqlState + "</entry>");
< currentComment + "<title>");
---
> currentComment + "</title>");
(3) Add missing close tags for the end of the file
> ditaWriter.println("</tbody>");
> ditaWriter.println("</tgroup>");
> ditaWriter.println("</table>");
> ditaWriter.println("</section>");
> ditaWriter.println("</refbody>");
> ditaWriter.println("</reference>");
The generated dita file still needs a manual fix for sqlstate 42Y04 to convert
the '<' and '>' to < and > respectively.
> Document SQLStates in 10.2
> --------------------------
>
> Key: DERBY-1566
> URL: http://issues.apache.org/jira/browse/DERBY-1566
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.2.1.0
> Reporter: Rick Hillegas
> Assigned To: David Van Couvering
> Fix For: 10.2.1.0
>
> Attachments: ErrorMessageGenerator.david.diffs,
> ErrorMessageGenerator.david.java, ErrorMessageGenerator.java,
> rrefexcept71493.html
>
>
> We need to update the Reference Guide to document the current list of
> SQLStates. This list goes into
> Reference Guide
> Derby exception messages and SQL states
> SQLState and error message reference
> The tool mentioned in DERBY-296 may be useful.
--
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
