db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Rick Hillegas (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-5885) The order of argument names in messages.xml is sometimes wrong when the arguments occur in the message out of sequence.
Date Wed, 28 Nov 2012 14:12:58 GMT

    [ https://issues.apache.org/jira/browse/DERBY-5885?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13505459#comment-13505459
] 

Rick Hillegas commented on DERBY-5885:
--------------------------------------

It turns out that the messages mentioned by DERBY-2705 were corrected by the work on this
issue. We just needed to check in the generated error documentation in order to see that.
I have resolved DERBY-2705 as fixed.
                
> The order of argument names in messages.xml is sometimes wrong when the arguments occur
in the message out of sequence.
> -----------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-5885
>                 URL: https://issues.apache.org/jira/browse/DERBY-5885
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation, Localization
>    Affects Versions: 10.10.0.0
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>         Attachments: derby-5885-01-aa-reorderMessageArgs.diff, derby-5885-01-ab-reorderMessageArgs.diff
>
>
> In most Derby messages, arguments appear in ascending order. That is, {0} occurs in the
message first, then {1}, then {2}, and so on. Sometimes, however, arguments occur out of sequence.
When this happens, the names in the <arg> sub-elements may not agree with the order
that the arguments actually occur in the message. This causes MessageBuilder to garble the
dita source for the Reference Guide page titled "SQL error messages and exceptions".
> For instance, here is the messages.xml element for SQLState 22014:
>             <msg>
>                 <name>22014</name>
>                 <text>The start position for LOCATE is invalid; it must be a positive
integer. The index  to start the search from is '{2}'.  The string to search for is '{0}'.
 The string to search from is '{1}'. </text>
>                 <arg>startIndex</arg>
>                 <arg>searchString</arg>
>                 <arg>fromString</arg>
>             </msg>
> This gives rise to the following garbled text in the generated reference guide page:
> "The start position for LOCATE is invalid; it must be a positive integer. The index to
start the search from is '<fromString>'. The string to search for is '<startIndex>'.
The string to search from is '<searchString>'. "
> We should re-order the <arg> sub-elements so that the first <arg> sub-lement
corresponds to {0}, the second <arg> sub-element corresponds to {1}, and so on.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message