Document support for frozen_string_literal: false

xref #7426

lib/rubocop/cop/style/frozen_string_literal_comment.rb

@@ -11,6 +11,9 @@ module Style
       # encoding comment. The frozen string literal comment is only valid in
       # Ruby 2.3+.
       #
+      # Note that the cop will ignore files where the comment exists but is set
+      # to `false` instead of `true`.
+      #
       # @example EnforcedStyle: always (default)
       #   # The `always` style will always add the frozen string literal comment
       #   # to a file, regardless of the Ruby version or if `freeze` or `<<` are
@@ -27,6 +30,13 @@ module Style
       #     # ...
       #   end
       #
+      #   # good
+      #   # frozen_string_literal: false
+      #
+      #   module Bar
+      #     # ...
+      #   end
+      #
       # @example EnforcedStyle: never
       #   # The `never` will enforce that the frozen string literal comment does
       #   # not exist in a file.

manual/cops_style.md

@@ -2281,6 +2281,9 @@ default in future Ruby. The comment will be added below a shebang and
 encoding comment. The frozen string literal comment is only valid in
 Ruby 2.3+.
 
+Note that the cop will ignore files where the comment exists but is set
+to `false` instead of `true`.
+
 ### Examples
 
 #### EnforcedStyle: always (default)
@@ -2297,6 +2300,13 @@ end
 # good
 # frozen_string_literal: true
 
+module Bar
+  # ...
+end
+
+# good
+# frozen_string_literal: false
+
 module Bar
   # ...
 end