[DERBY-5878] Add message argument names, as comments, to English message file produced by MessageBuilder.

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.10.1.1
• Fix Version/s: 10.10.1.1
• Component/s: Build tools
• Urgency: Normal
• Assignee: Richard N. Hillegas
• Reporter: Richard N. Hillegas
• Created: 24/Jul/12 18:51
• Updated: 15/Mar/13 13:40
• Resolved: 15/Mar/13 13:40

Description

The MessageBuilder program turns messages.xml into two output files:

1) The DITA source for the Reference Guide section on error messages.

2) The messages_en.properties file of engine messages.

All of the translators I have dealt with want to use (2) as the English input for their translations. I believe this is because translators have written their own tools and those tools expect to work on properties files.

Messages may have arguments. Those arguments appear as sub-elements of the messages in messages.xml. The arguments turn up in (1) but are thrown away when MessageBuilder produces (2). We can help translators do a better job by also writing the arguments as comments in (2).

Issue Links

• relates to: DERBY-5832 Localize messages introduced or changed in 10.9.1
• relates to: DERBY-5879 Fix problems in English messages disclosed by a localization audit.