[rubocop#3246] add list of all cops with documentation

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Change log
 
 ## master (unreleased)
+* [#3246](https://github.com/bbatsov/rubocop/issues/3246): Add list of all cops to Documentation. ([@sihu][])
+
 
 ### New features
 
@@ -2441,3 +2443,4 @@
 [@legendetm]: https://github.com/legendetm
 [@bronson]: https://github.com/bronson
 [@albus522]: https://github.com/albus522
+[@sihu]: https://github.com/sihu

lib/rubocop/cop/lint/shadowed_exception.rb

@@ -7,8 +7,7 @@ module Lint
       # less specific exception being rescued before a more specific
       # exception is rescued.
       #
-      #   @example
-      #
+      # @example
       #   # bad
       #   begin
       #     something

lib/rubocop/cop/style/empty_else.rb

@@ -10,6 +10,7 @@ module Style
       #
       # @example
       #   # good for all styles
+      #
       #   if condition
       #     statement
       #   else
@@ -21,8 +22,9 @@ module Style
       #     statement
       #   end
       #
-      # empty - warn only on empty else
-      #   @example
+      # @example
+      #   # empty - warn only on empty else
+      #
       #   # bad
       #   if condition
       #     statement
@@ -36,8 +38,9 @@ module Style
       #     nil
       #   end
       #
-      # nil - warn on else with nil in it
-      #   @example
+      # @example
+      #   # nil - warn on else with nil in it
+      #
       #   # bad
       #   if condition
       #     statement
@@ -51,8 +54,9 @@ module Style
       #   else
       #   end
       #
-      # both - warn on empty else and else with nil in it
-      #   @example
+      # @example
+      #   # both - warn on empty else and else with nil in it
+      #
       #   # bad
       #   if condition
       #     statement

lib/rubocop/cop/style/space_inside_array_percent_literal.rb

@@ -6,11 +6,12 @@ module Style
       # Checks for unnecessary additional spaces inside array percent literals
       # (i.e. %i/%w).
       #
-      # @good
-      # %i(foo bar baz)
+      # @example
+      #   @good
+      #   %i(foo bar baz)
       #
-      # @bad
-      # %w(foo  bar  baz)
+      #   @bad
+      #   %w(foo  bar  baz)
       class SpaceInsideArrayPercentLiteral < Cop
         include MatchRange
         include PercentLiteral

lib/rubocop/cop/style/space_inside_percent_literal_delimiters.rb

@@ -6,14 +6,15 @@ module Style
       # Checks for unnecessary additional spaces inside the delimiters of
       # %i/%w/%x literals.
       #
-      # @good
-      # %i(foo bar baz)
+      # @example
+      #   @good
+      #   %i(foo bar baz)
       #
-      # @bad
-      # %w( foo bar baz )
+      #   @bad
+      #   %w( foo bar baz )
       #
-      # @bad
-      # %x(  ls -l )
+      #   @bad
+      #   %x(  ls -l )
       class SpaceInsidePercentLiteralDelimiters < Cop
         include MatchRange
         include PercentLiteral