Fix CI.

.github/workflows/tests.yml

@@ -61,13 +61,14 @@ 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 ' ')
+          public_apis="$(git grep -l "@api public" -- :^sorbet/ :^vendor/ | sort)"
-          rubocop_docs=$(yq '.Style/Documentation.Include' .rubocop.yml | wc -l | tr -d ' ')
+          rubocop_docs="$(yq '.Style/Documentation.Include[]' .rubocop.yml | sort)"
-          if [[ public_apis -ne rubocop_docs ]]
+
-          then
+          if [[ "${public_apis}" != "${rubocop_docs}" ]]; then
-            echo "All public Homebrew APIs should be included in the Style/Documentation RuboCop."
+            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/remove the following paths from \`Library/Homebrew/.rubocop.yml\` as appropriate:"
-            echo "Add or remove the filepaths 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 @@ module Cask
 
     # The token of this {Cask}.
     #
-    # @api public
+    # @api internal
     attr_reader :token
 
     # The configuration of this {Cask}.
@@ -136,7 +136,7 @@ module Cask
 
     # 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 @@ module Cask
 
     # Alias for {#token}.
     #
-    # @api public
+    # @api internal
     def to_s = token
 
     def inspect