v1.8.1

Major revision of possible input properties, in order to comply with swagger v2

The following tags are acceptable:

• consumes
• produces
• paths
• schemas
• securityDefinitions
• responses
• parameters
• definitions
• tags

Also, their singular forms (consume, produce, etc.) are also respected in this version for backwards compatibility. Singular forms will be deprecated in swagger-jsdoc v2.

Examples have been updated.