docs: update for Homebrew/cask-fonts deprecation

Signed-off-by: Patrick Linnane <patrick@linnane.io>
This commit is contained in:
Patrick Linnane 2024-05-15 21:39:13 -07:00
parent 1fac68348a
commit 773dbfa92a
No known key found for this signature in database
12 changed files with 15 additions and 39 deletions

View File

@ -110,7 +110,6 @@ jobs:
run: | run: |
brew tap homebrew/aliases brew tap homebrew/aliases
brew tap homebrew/bundle brew tap homebrew/bundle
brew tap homebrew/cask-fonts
brew tap homebrew/command-not-found brew tap homebrew/command-not-found
brew tap homebrew/formula-analytics brew tap homebrew/formula-analytics
brew tap homebrew/portable-ruby brew tap homebrew/portable-ruby
@ -130,10 +129,9 @@ jobs:
homebrew/formula-analytics \ homebrew/formula-analytics \
homebrew/portable-ruby homebrew/portable-ruby
- name: Run brew style on cask taps - name: Run brew style on homebrew/cask
run: | run: |
brew style homebrew/cask \ brew style homebrew/cask
homebrew/cask-fonts
formula-audit: formula-audit:
name: formula audit name: formula audit
@ -172,17 +170,12 @@ jobs:
cask: true cask: true
test-bot: false test-bot: false
- name: Set up Homebrew all cask taps
run: |
brew tap homebrew/cask-fonts
- name: Run brew readall on all casks - name: Run brew readall on all casks
run: brew readall --os=all --arch=all homebrew/cask homebrew/cask-fonts run: brew readall --os=all --arch=all homebrew/cask
- name: Run brew audit --skip-style on casks - name: Run brew audit --skip-style on homebrew/cask
run: | run: |
brew audit --skip-style --except=version --tap=homebrew/cask brew audit --skip-style --except=version --tap=homebrew/cask
brew audit --skip-style --except=version --tap=homebrew/cask-fonts
- name: Generate formula API - name: Generate formula API
run: brew generate-formula-api --dry-run run: brew generate-formula-api --dry-run

View File

@ -197,7 +197,7 @@ module Cask
def audit_description def audit_description
# Fonts seldom benefit from descriptions and requiring them disproportionately # Fonts seldom benefit from descriptions and requiring them disproportionately
# increases the maintenance burden. # increases the maintenance burden.
return if cask.tap == "homebrew/cask-fonts" return if cask.tap == "homebrew/cask" && cask.token.include?("font-")
add_error("Cask should have a description. Please add a `desc` stanza.", strict_only: true) if cask.desc.blank? add_error("Cask should have a description. Please add a `desc` stanza.", strict_only: true) if cask.desc.blank?
end end

View File

@ -3,7 +3,6 @@
OFFICIAL_CASK_TAPS = %w[ OFFICIAL_CASK_TAPS = %w[
cask cask
cask-fonts
].freeze ].freeze
OFFICIAL_CMD_TAPS = { OFFICIAL_CMD_TAPS = {
@ -19,6 +18,7 @@ DEPRECATED_OFFICIAL_TAPS = %w[
binary binary
cask-drivers cask-drivers
cask-eid cask-eid
cask-fonts
cask-versions cask-versions
completions completions
devel-only devel-only

View File

@ -42,7 +42,7 @@ RSpec.describe Cask::CaskLoader::FromAPILoader, :cask do
end end
it "returns nil for full name with invalid tap" do it "returns nil for full name with invalid tap" do
expect(described_class.try_new("homebrew/cask-fonts/#{token}")).to be_nil expect(described_class.try_new("homebrew/foo/#{token}")).to be_nil
end end
end end
end end

View File

@ -532,7 +532,7 @@ __fish_brew_complete_arg 'contributions' -l debug -d 'Display any debugging info
__fish_brew_complete_arg 'contributions' -l from -d 'Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year' __fish_brew_complete_arg 'contributions' -l from -d 'Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year'
__fish_brew_complete_arg 'contributions' -l help -d 'Show this message' __fish_brew_complete_arg 'contributions' -l help -d 'Show this message'
__fish_brew_complete_arg 'contributions' -l quiet -d 'Make some output more quiet' __fish_brew_complete_arg 'contributions' -l quiet -d 'Make some output more quiet'
__fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `bundle`, `command-not-found`, `test-bot`, `services` and `cask-fonts`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. ' __fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `bundle`, `command-not-found`, `test-bot` and `services`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. '
__fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO-8601 format) to stop searching contributions' __fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO-8601 format) to stop searching contributions'
__fish_brew_complete_arg 'contributions' -l user -d 'Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers' __fish_brew_complete_arg 'contributions' -l user -d 'Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers'
__fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose' __fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose'

View File

@ -683,7 +683,7 @@ _brew_contributions() {
'--from[Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year]' \ '--from[Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year]' \
'--help[Show this message]' \ '--help[Show this message]' \
'--quiet[Make some output more quiet]' \ '--quiet[Make some output more quiet]' \
'--repositories[Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `bundle`, `command-not-found`, `test-bot`, `services` and `cask-fonts`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. ]' \ '--repositories[Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `bundle`, `command-not-found`, `test-bot` and `services`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. ]' \
'--to[Date (ISO-8601 format) to stop searching contributions]' \ '--to[Date (ISO-8601 format) to stop searching contributions]' \
'--user[Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers]' \ '--user[Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers]' \
'--verbose[Make some output more verbose]' '--verbose[Make some output more verbose]'

View File

@ -51,10 +51,6 @@ For unrelated apps that share a name, the most popular one (usually the one alre
We do not accept these casks since they involve a higher-than-normal security risk. We do not accept these casks since they involve a higher-than-normal security risk.
### Fonts
Font casks live in the [Homebrew/homebrew-cask-fonts](https://github.com/Homebrew/homebrew-cask-fonts) repository. See the `homebrew/cask-fonts` repository [CONTRIBUTING.md](https://github.com/Homebrew/homebrew-cask-fonts/blob/HEAD/CONTRIBUTING.md) for details.
## Apps that bundle malware ## Apps that bundle malware
Unfortunately, in the world of software there are bad actors that bundle malware with their apps. Even so, Homebrew Cask has long decided it will not be an active gatekeeper ([macOS already has one](https://support.apple.com/en-us/HT202491)) and [users are expected to know about the software they are installing](#homebrew-cask-is-not-a-discoverability-service). This means we will not always remove casks that link to these apps, in part because there is no clear line between useful app, potentially unwanted program, and the different shades of malware—what is useful to one user may be seen as malicious by another. Unfortunately, in the world of software there are bad actors that bundle malware with their apps. Even so, Homebrew Cask has long decided it will not be an active gatekeeper ([macOS already has one](https://support.apple.com/en-us/HT202491)) and [users are expected to know about the software they are installing](#homebrew-cask-is-not-a-discoverability-service). This means we will not always remove casks that link to these apps, in part because there is no clear line between useful app, potentially unwanted program, and the different shades of malware—what is useful to one user may be seen as malicious by another.

View File

@ -1285,7 +1285,6 @@ This section describes the algorithm implemented in the `generate_cask_token` sc
* [Cask Filenames](#cask-filenames) * [Cask Filenames](#cask-filenames)
* [Cask Headers](#cask-headers) * [Cask Headers](#cask-headers)
* [Cask Token Examples](#cask-token-examples) * [Cask Token Examples](#cask-token-examples)
* [Tap-Specific Cask Token Examples](#tap-specific-cask-token-examples)
* [Special Affixes](#special-affixes) * [Special Affixes](#special-affixes)
### Purpose ### Purpose
@ -1411,12 +1410,6 @@ For versioned/development channel casks:
| `vlc` | Nightly Channel | `vlc@nightly` | `vlc@nightly.rb` | | `vlc` | Nightly Channel | `vlc@nightly` | `vlc@nightly.rb` |
| `carbon-copy-cloner` | Pinned to version 5 | `carbon-copy-cloner@5`| `carbon-copy-cloner@5.rb` | | `carbon-copy-cloner` | Pinned to version 5 | `carbon-copy-cloner@5`| `carbon-copy-cloner@5.rb` |
#### Tap-specific cask token examples
Cask taps have naming conventions specific to each tap.
* [Homebrew/cask-fonts](https://github.com/Homebrew/homebrew-cask-fonts/blob/HEAD/CONTRIBUTING.md#naming-font-casks)
### Special affixes ### Special affixes
A few situations require a prefix or suffix to be added to the token. A few situations require a prefix or suffix to be added to the token.

View File

@ -1,11 +1,6 @@
# Homebrew/homebrew-cask Maintainer Guide # Homebrew/homebrew-cask Maintainer Guide
This guide is intended to help maintainers effectively maintain the cask repositories. It is meant to be used in conjunction with the more generic [Maintainer Guidelines](Maintainer-Guidelines.md). This guide is intended to help maintainers effectively maintain the cask repository. It is meant to be used in conjunction with the more generic [Maintainer Guidelines](Maintainer-Guidelines.md).
This guide applies to both of the cask repositories:
- [Homebrew/homebrew-cask](https://github.com/Homebrew/homebrew-cask): The main cask repository
- [Homebrew/homebrew-cask-fonts](https://github.com/Homebrew/homebrew-cask-fonts): Casks of fonts
## Common Situations ## Common Situations

View File

@ -11,7 +11,7 @@ All Homebrew maintainers are encouraged to contribute to all parts of the projec
- `brew` maintainers: this team maintains the [`Homebrew/brew`](https://github.com/Homebrew/brew) repository. See the [Homebrew/brew Maintainer Guide](Homebrew-brew-Maintainer-Guide.md) for more details about being a `brew` maintainer. - `brew` maintainers: this team maintains the [`Homebrew/brew`](https://github.com/Homebrew/brew) repository. See the [Homebrew/brew Maintainer Guide](Homebrew-brew-Maintainer-Guide.md) for more details about being a `brew` maintainer.
- Core maintainers: this team maintains the [`Homebrew/homebrew-core`](https://github.com/Homebrew/homebrew-core) repository. See the [Homebrew/homebrew-core Maintainer Guide](Homebrew-homebrew-core-Maintainer-Guide.md) for more details about being a core maintainer. - Core maintainers: this team maintains the [`Homebrew/homebrew-core`](https://github.com/Homebrew/homebrew-core) repository. See the [Homebrew/homebrew-core Maintainer Guide](Homebrew-homebrew-core-Maintainer-Guide.md) for more details about being a core maintainer.
- Linux maintainers: this team maintains the [`Homebrew/homebrew-core`](https://github.com/Homebrew/homebrew-core) repository on Linux. - Linux maintainers: this team maintains the [`Homebrew/homebrew-core`](https://github.com/Homebrew/homebrew-core) repository on Linux.
- Cask maintainers: this team maintains the [`Homebrew/homebrew-cask`](https://github.com/Homebrew/homebrew-cask) and [`Homebrew/homebrew-cask-fonts`](https://github.com/Homebrew/homebrew-cask-fonts) repositories. See the [Homebrew/homebrew-cask Maintainer Guide](Homebrew-homebrew-cask-Maintainer-Guide.md) for more details about being a cask maintainer. - Cask maintainers: this team maintains the [`Homebrew/homebrew-cask`](https://github.com/Homebrew/homebrew-cask) repository. See the [Homebrew/homebrew-cask Maintainer Guide](Homebrew-homebrew-cask-Maintainer-Guide.md) for more details about being a cask maintainer.
These documents are meant to serve as guiding principles. As a maintainer, you can make a call to either request changes from a contributor or help them out based on their comfort and previous contributions. Remember, as a team we [Prioritise Maintainers Over Users](Maintainers-Avoiding-Burnout.md) to avoid burnout. If you wish to change or discuss any of the guidelines: open a PR to suggest a change. These documents are meant to serve as guiding principles. As a maintainer, you can make a call to either request changes from a contributor or help them out based on their comfort and previous contributions. Remember, as a team we [Prioritise Maintainers Over Users](Maintainers-Avoiding-Burnout.md) to avoid burnout. If you wish to change or discuss any of the guidelines: open a PR to suggest a change.

View File

@ -1998,10 +1998,9 @@ Summarise contributions to Homebrew repositories.
: Specify a comma-separated list of repositories to search. Supported : Specify a comma-separated list of repositories to search. Supported
repositories: `brew`, `core`, `cask`, `aliases`, `bundle`, repositories: `brew`, `core`, `cask`, `aliases`, `bundle`,
`command-not-found`, `test-bot`, `services` and `cask-fonts`. Omitting this `command-not-found`, `test-bot` and `services`. Omitting this flag, or
flag, or specifying `--repositories=primary`, searches only the main specifying `--repositories=primary`, searches only the main repositories:
repositories: brew,core,cask. Specifying `--repositories=all`, searches all brew,core,cask. Specifying `--repositories=all`, searches all repositories.
repositories.
`--from` `--from`

View File

@ -1265,7 +1265,7 @@ Treat all named arguments as casks\.
Summarise contributions to Homebrew repositories\. Summarise contributions to Homebrew repositories\.
.TP .TP
\fB\-\-repositories\fP \fB\-\-repositories\fP
Specify a comma\-separated list of repositories to search\. Supported repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP, \fBaliases\fP, \fBbundle\fP, \fBcommand\-not\-found\fP, \fBtest\-bot\fP, \fBservices\fP and \fBcask\-fonts\fP\&\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: brew,core,cask\. Specifying \fB\-\-repositories=all\fP, searches all repositories\. Specify a comma\-separated list of repositories to search\. Supported repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP, \fBaliases\fP, \fBbundle\fP, \fBcommand\-not\-found\fP, \fBtest\-bot\fP and \fBservices\fP\&\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: brew,core,cask\. Specifying \fB\-\-repositories=all\fP, searches all repositories\.
.TP .TP
\fB\-\-from\fP \fB\-\-from\fP
Date (ISO\-8601 format) to start searching contributions\. Omitting this flag searches the last year\. Date (ISO\-8601 format) to start searching contributions\. Omitting this flag searches the last year\.