db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jean T. Anderson (JIRA)" <derby-...@db.apache.org>
Subject [jira] Updated: (DERBY-1566) Document SQLStates in 10.2
Date Tue, 29 Aug 2006 22:50:26 GMT
     [ 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 &lt; and &gt; 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

        

Mime
View raw message