Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-5878

Add message argument names, as comments, to English message file produced by MessageBuilder.

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 10.10.1.1
    • 10.10.1.1
    • Build tools
    • None
    • Normal

    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).

      Attachments

        1. derby-5878-04-aa-updateMessageDTD.diff
          0.5 kB
          Richard N. Hillegas
        2. derby-5878-03-aa-addBracketedArgNumbersToComments.diff
          0.6 kB
          Richard N. Hillegas
        3. derby-5878-02-aa-commentElements.diff
          3 kB
          Richard N. Hillegas
        4. derby-5878-01-aa-argsAsComments.diff
          1 kB
          Richard N. Hillegas

        Issue Links

          Activity

            People

              rhillegas Richard N. Hillegas
              rhillegas Richard N. Hillegas
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: