[change] more specific js-doc validity checks and enable require-jsdo…

…c for class and methods also.

rules/errors.js

@@ -93,7 +93,26 @@ module.exports = {
 
 		// ensure JSDoc comments are valid
 		// http://eslint.org/docs/rules/valid-jsdoc
-		'valid-jsdoc': 2,
+		'valid-jsdoc': ['error', {
+			prefer: {
+				arg: 'param',
+				argument: 'param',
+				params: 'param',
+				class: 'constructor',
+				return: 'returns',
+				virtual: 'abstract'
+			},
+			preferType: {
+				Boolean: 'boolean',
+				Number: 'number',
+				object: 'Object',
+				String: 'string',
+				array: 'Array',
+				xml: 'XML'
+			},
+			requireReturnDescription: true,
+			requireParamDescription: true
+		}],
 
 		// ensure that the results of typeof are compared against a valid string
 		'valid-typeof': 2

rules/style.js

@@ -212,7 +212,13 @@ module.exports = {
 
 		// do not require jsdoc
 		// http://eslint.org/docs/rules/require-jsdoc
-		'require-jsdoc': 2,
+		'require-jsdoc': ['error', {
+			require: {
+				FunctionDeclaration: true,
+				MethodDefinition: true,
+				ClassDeclaration: true
+			}
+		}],
 
 		// require or disallow use of semicolons instead of ASI
 		semi: [2, 'always'],