diff --git a/lib/rubocop/cop/style/frozen_string_literal_comment.rb b/lib/rubocop/cop/style/frozen_string_literal_comment.rb index e1f30f10c6a..c5cc693e462 100644 --- a/lib/rubocop/cop/style/frozen_string_literal_comment.rb +++ b/lib/rubocop/cop/style/frozen_string_literal_comment.rb @@ -5,11 +5,17 @@ module Cop module Style # This cop is designed to help you transition from mutable string literals # to frozen string literals. - # It will add the comment `# frozen_string_literal: true` to the top of - # files to enable frozen string literals. Frozen string literals may be + # It will add the `# frozen_string_literal: true` magic comment to the top + # of files to enable frozen string literals. Frozen string literals may be # default in future Ruby. The comment will be added below a shebang and # encoding comment. # + # Note that the cop will ignore files where the comment exists but is set + # to `false` instead of `true`. + # + # To require a blank line after this comment, please see + # `Layout/EmptyLineAfterMagicComment` cop. + # # @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