Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8140760

Create a README file describing how to write os specific property files

    Details

    • Type: Enhancement
    • Status: Open
    • Priority: P2
    • Resolution: Unresolved
    • Affects Version/s: 9
    • Fix Version/s: 10
    • Component/s: hotspot
    • Labels:
      None
    • Subcomponent:

      Description

      Using a mechanism of property files for describing services is good enough:
      - easy to support
      - flexible: allows to describe whatever we need
      - human readable

      One problem with using it I bumped into - some magic is used, like
      native.pattern = %p

      To get things better:
      - a readme file should be provided
      - in all property files that readme file should be mentioned
      - the readme file should:
        * general description of what should be provided os.properties files
        * list all "fields" supported by mechanism: args, app, pattern, etc
        * a few examples given



        Activity

        Hide
        iignatyev Igor Ignatyev added a comment -
        readme file[1] was integrated together w/ failure handler. [~dfazunen], could you please check if it's enough from your point of view?
        [1] http://hg.openjdk.java.net/jdk9/dev/file/a2a3930ed7c3/test/failure_handler/README
        Show
        iignatyev Igor Ignatyev added a comment - readme file[1] was integrated together w/ failure handler. [~dfazunen], could you please check if it's enough from your point of view? [1] http://hg.openjdk.java.net/jdk9/dev/file/a2a3930ed7c3/test/failure_handler/README

          People

          • Assignee:
            iignatyev Igor Ignatyev
            Reporter:
            dfazunen Dmitry Fazunenko
          • Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated: