Derby
  1. Derby
  2. DERBY-5878

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

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.10.1.1
    • Fix Version/s: 10.10.1.1
    • Component/s: Build tools
    • Labels:
      None
    • Urgency:
      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).

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

        Issue Links

          Activity

          Gavin made changes -
          Workflow jira [ 12717862 ] Default workflow, editable Closed status [ 12802447 ]
          Rick Hillegas made changes -
          Status Resolved [ 5 ] Closed [ 6 ]
          Rick Hillegas made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Fix Version/s 10.10.0.0 [ 12321550 ]
          Resolution Fixed [ 1 ]
          Rick Hillegas made changes -
          Attachment derby-5878-04-aa-updateMessageDTD.diff [ 12540035 ]
          Rick Hillegas made changes -
          Rick Hillegas made changes -
          Link This issue relates to DERBY-5879 [ DERBY-5879 ]
          Rick Hillegas made changes -
          Attachment derby-5878-02-aa-commentElements.diff [ 12538395 ]
          Rick Hillegas made changes -
          Link This issue relates to DERBY-5832 [ DERBY-5832 ]
          Rick Hillegas made changes -
          Attachment derby-5878-01-aa-argsAsComments.diff [ 12537735 ]
          Rick Hillegas made changes -
          Field Original Value New Value
          Assignee Rick Hillegas [ rhillegas ]
          Rick Hillegas created issue -

            People

            • Assignee:
              Rick Hillegas
              Reporter:
              Rick Hillegas
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development