Fix CI.

.github/workflows/tests.yml

@@ -61,13 +61,13 @@ jobs:
  - name: Check RuboCop filepaths
  working-directory: ${{ steps.set-up-homebrew.outputs.repository-path }}/Library/Homebrew
  run: |
- public_apis=$(git grep -l "@api public" -- :^sorbet/ :^vendor/ | wc -l | tr -d ' ')
- rubocop_docs=$(yq '.Style/Documentation.Include' .rubocop.yml | wc -l | tr -d ' ')
- if [[ public_apis -ne rubocop_docs ]]
- then
- echo "All public Homebrew APIs should be included in the Style/Documentation RuboCop."
- echo "There were ${public_apis} '@api public' lines but ${rubocop_docs} filepaths for the 'Style/Documentation' RuboCop."
- echo "Add or remove the filepaths from Library/Homebrew/.rubocop.yml as appropriate."
+ public_apis="$(git grep -l "@api public" -- :^sorbet/ :^vendor/ | sort)"
+ rubocop_docs="$(yq '.Style/Documentation.Include[]' .rubocop.yml | sort)"
+ if [[ "${public_apis}" != "${rubocop_docs}" ]]; then
+  echo 'All public Homebrew APIs should be included in the `Style/Documentation` RuboCop.'
+ echo 'Add/remove the following paths from `Library/Homebrew/.rubocop.yml` as appropriate:'
+ echo "${public_apis} ${rubocop_docs}" | tr ' ' "\n" | sort | uniq -u
+
  exit 1
  fi
 

Library/Homebrew/.rubocop.yml

@@ -64,6 +64,7 @@ Style/Documentation:
  - utils/shebang.rb
  - utils/string_inreplace_extension.rb
  - version.rb
+ - tap.rb
 
 Style/DocumentationMethod:
  Include:

Library/Homebrew/cask/cask.rb

@@ -22,7 +22,7 @@ class Cask
 
  # The token of this {Cask}.
  #
- # @api public
+ # @api internal
  attr_reader :token
 
  # The configuration of this {Cask}.
@@ -136,7 +136,7 @@ def timestamped_versions(caskroom_path: self.caskroom_path)
 
  # The fully-qualified token of this {Cask}.
  #
- # @api public
+ # @api internal
  def full_token
  return token if tap.nil?
  return token if tap.core_cask_tap?
@@ -327,7 +327,7 @@ def populate_from_api!(json_cask)
 
  # Alias for {#token}.
  #
- # @api public
+ # @api internal
  def to_s = token
 
  def inspect