Uploaded image for project: 'Commons Configuration'
  1. Commons Configuration
  2. CONFIGURATION-610

Improve Configuration Variable Documentation

VotersWatch issueWatchersLinkCloneUpdate Comment AuthorReplace String in CommentUpdate Comment VisibilityDelete Comments
    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 2.0-alpha1
    • Fix Version/s: 2.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      The JavaDoc for Class PropertiesConfiguration lists a very handy feature of Configuration, which is variable substitution. The behavior can be seen in the example file on the JavaDoc (good).

      But it's not in the preceding list of features. It would be nice to have a little writeup describing the intended behavior: What is supposed to happen if you have an undefined ref? What about nested refs? What about circular refs?

      And it was interesting to find that the substitution occurred during get time rather than load (unexpected), and that if one calls the wrong get() method then the substitution will not happen. (Is that intended behavior?) This should be called out in the description as well as the individual method JavaDocs.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              dlamet Dan Lamet

              Dates

              • Created:
                Updated:
                Resolved:

                Issue deployment