Support for enum descriptions (x-enum-descriptions)

[jmini]

With #893 (comment) we have introduced support for the x-enum-varnames extension.

In a similar way x-enum-descriptions should be supported:

  weather:
    type: object
    properties:
      type:
        type: integer
        format: int32
        enum:
          - 1
          - 2
          - 3
        x-enum-descriptions:
          - 'Blue sky'
          - 'Slightly overcast'
          - 'Take an umbrella with you'
        x-enum-varnames:
          - Sunny
          - Cloudy
          - Rainy

The java generator could add some Javadoc on top of the enum value.

[tomghyselinck]

This is also useful for Python docstrings.

[jmini]

@tomghyselinck: absolutely. The idea is to contribute this feature into the core. Then templates needs to be updated to use this feature if it makes sense.

Example:
20697ec#diff-c7ad5f298a44b19ad127f9a5fbcbd356

Can you open a PR to add the support in Python docstrings?

[jmini]

PR to generate the javadoc (using the JaxRS generator): #1951

[tomghyselinck]

@jmini: I will try to do so in the next weeks

[shartte]

This seems to work for Java Enum Descriptions.