From derby-dev-return-97293-apmail-db-derby-dev-archive=db.apache.org@db.apache.org Fri Aug 3 15:35:03 2012 Return-Path: X-Original-To: apmail-db-derby-dev-archive@www.apache.org Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id ED79BDBB4 for ; Fri, 3 Aug 2012 15:35:02 +0000 (UTC) Received: (qmail 30264 invoked by uid 500); 3 Aug 2012 15:35:02 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 30234 invoked by uid 500); 3 Aug 2012 15:35:02 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 30227 invoked by uid 99); 3 Aug 2012 15:35:02 -0000 Received: from issues-vm.apache.org (HELO issues-vm) (140.211.11.160) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 03 Aug 2012 15:35:02 +0000 Received: from isssues-vm.apache.org (localhost [127.0.0.1]) by issues-vm (Postfix) with ESMTP id 875B414052C for ; Fri, 3 Aug 2012 15:35:02 +0000 (UTC) Date: Fri, 3 Aug 2012 15:35:02 +0000 (UTC) From: "Rick Hillegas (JIRA)" To: derby-dev@db.apache.org Message-ID: <508009595.10841.1344008102557.JavaMail.jiratomcat@issues-vm> In-Reply-To: <2017682253.97462.1343156014398.JavaMail.jiratomcat@issues-vm> Subject: [jira] [Updated] (DERBY-5878) Add message argument names, as comments, to English message file produced by MessageBuilder. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/DERBY-5878?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Rick Hillegas updated DERBY-5878: --------------------------------- Attachment: derby-5878-03-aa-addBracketedArgNumbersToComments.diff Attaching derby-5878-03-aa-addBracketedArgNumbersToComments.diff. Committed at subversion revision 1369040. The translators asked me to add bracketed argument numbers to the comments in the generated English properties file. So, instead of generating # Arguments: # # connectionName # ...we now generate # Arguments: # # {0} = connectionName # Touches the following file: M java/build/org/apache/derbyBuild/MessageBuilder.java > Add message argument names, as comments, to English message file produced by MessageBuilder. > -------------------------------------------------------------------------------------------- > > Key: DERBY-5878 > URL: https://issues.apache.org/jira/browse/DERBY-5878 > Project: Derby > Issue Type: Improvement > Components: Build tools > Affects Versions: 10.10.0.0 > Reporter: Rick Hillegas > Assignee: Rick Hillegas > Attachments: derby-5878-01-aa-argsAsComments.diff, derby-5878-02-aa-commentElements.diff, derby-5878-03-aa-addBracketedArgNumbersToComments.diff > > > 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). -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa For more information on JIRA, see: http://www.atlassian.com/software/jira