Apache Derby: Documenting messages

Error and warning messages are documented in the Derby Reference Manual. When you add internationalized messages to the Derby engine, add the messages to the xml descriptors file that is located in ..java/engine/org/apache/derby/loc/messages.xml. Specify friendly names for the message arguments. The friendly names appear in the SQLState tables in the Derby Reference Manual. Valid friendly names are:

• authorizationID
• columnName
• constraintName
• databaseName
• indexName
• objectName
• tableName
• triggerName
• valueName
• viewName

Do not edit the java/engine/org/apache/derby/loc/messages_en.properties file. This file has been removed from code management and is now generated from messages.xml during the Derby build.

A utility takes the content of the ..java/engine/org/apache/derby/loc/messages.xml file, and updates the topic in the Derby Reference Manual that lists all of the messages. That topic is rrefexcept71493.dita.

Please post feedback to the derby-dev mail list.

Last Updated: November 7, 2006