Merge pull request #6735 from bquorning/allow-yields-rdoc-comment

[Fix #6708] Style/CommentedKeyword knows :yields:

CHANGELOG.md

@@ -22,6 +22,7 @@
 
 * [#6597](https://github.com/rubocop-hq/rubocop/issues/6597): `Style/LineEndConcatenation` is now known to be unsafe for auto-correct. ([@jaredbeck][])
 * [#6725](https://github.com/rubocop-hq/rubocop/issues/6725): Mark `Style/SymbolProc` as unsafe for auto-correct. ([@drenmi][])
+* [#6708](https://github.com/rubocop-hq/rubocop/issues/6708): Make `Style/CommentedKeyword` allow the `:yields:` RDoc comment. ([@bquorning][])
 
 ## 0.63.1 (2019-01-22)
 

lib/rubocop/cop/style/commented_keyword.rb

@@ -6,8 +6,8 @@ module Style
       # This cop checks for comments put on the same line as some keywords.
       # These keywords are: `begin`, `class`, `def`, `end`, `module`.
       #
-      # Note that some comments (such as `:nodoc:` and `rubocop:disable`) are
-      # allowed.
+      # Note that some comments (`:nodoc:`, `:yields:, and `rubocop:disable`)
+      # are allowed.
       #
       # @example
       #   # bad
@@ -59,7 +59,7 @@ def investigate(processed_source)
         private
 
         KEYWORDS = %w[begin class def end module].freeze
-        ALLOWED_COMMENTS = %w[:nodoc: rubocop:disable].freeze
+        ALLOWED_COMMENTS = %w[:nodoc: :yields: rubocop:disable].freeze
 
         def offensive?(line)
           line = line.lstrip

manual/cops_style.md

@@ -978,8 +978,8 @@ Enabled | Yes | No | 0.51 | -
 This cop checks for comments put on the same line as some keywords.
 These keywords are: `begin`, `class`, `def`, `end`, `module`.
 
-Note that some comments (such as `:nodoc:` and `rubocop:disable`) are
-allowed.
+Note that some comments (`:nodoc:`, `:yields:, and `rubocop:disable`)
+are allowed.
 
 ### Examples
 

spec/rubocop/cop/style/commented_keyword_spec.rb

@@ -122,6 +122,13 @@ class X # :nodoc:
         y
       end
     RUBY
+    expect_no_offenses(<<-RUBY.strip_indent)
+      class X
+        def y # :yields:
+          yield
+        end
+      end
+    RUBY
     expect_no_offenses(<<-RUBY.strip_indent)
       def x # rubocop:disable Metrics/MethodLength
         y