From 8d3835c2b4549f64d9eb9a0b54e8f1abc90b54ea Mon Sep 17 00:00:00 2001 From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com> Date: Mon, 29 Apr 2024 07:33:45 +0000 Subject: [PATCH] docs: updates from Homebrew/brew --- docs/APIHashable.html | 12 +- docs/AbstractCoreTap.html | 17 +- docs/AbstractDownloadStrategy.html | 19 +- docs/AbstractDownloadStrategy/Pourable.html | 5 +- docs/AbstractFileDownloadStrategy.html | 5 +- docs/ArchRequirement.html | 12 +- docs/Array.html | 45 +- docs/Attr.html | 8 +- docs/Attrable.html | 9 +- docs/BazaarDownloadStrategy.html | 8 +- docs/Bottle.html | 23 +- docs/Bottle/Filename.html | 26 +- docs/BottleSpecification.html | 62 +- docs/Build.html | 40 +- docs/BuildEnvironment.html | 24 +- docs/BuildEnvironment/DSL.html | 4 +- docs/BuildError.html | 36 +- docs/BuildOptions.html | 13 +- docs/CVSDownloadStrategy.html | 4 +- docs/Cachable.html | 9 +- docs/CacheStore.html | 13 +- docs/Cask.html | 1 - docs/Cask/AbstractCaskErrorWithToken.html | 8 +- docs/Cask/Artifact/AbstractArtifact.html | 47 +- docs/Cask/Artifact/AbstractFlightBlock.html | 24 +- docs/Cask/Artifact/AbstractUninstall.html | 17 +- docs/Cask/Artifact/Artifact.html | 12 +- docs/Cask/Artifact/Binary.html | 4 +- docs/Cask/Artifact/Installer.html | 21 +- .../Artifact/Installer/ManualInstaller.html | 5 +- .../Artifact/Installer/ScriptInstaller.html | 4 +- docs/Cask/Artifact/KeyboardLayout.html | 8 +- docs/Cask/Artifact/Manpage.html | 12 +- docs/Cask/Artifact/Mdimporter.html | 8 +- docs/Cask/Artifact/Moved.html | 16 +- docs/Cask/Artifact/Pkg.html | 20 +- docs/Cask/Artifact/Prefpane.html | 4 +- docs/Cask/Artifact/Qlplugin.html | 12 +- docs/Cask/Artifact/Relocated.html | 28 +- docs/Cask/Artifact/StageOnly.html | 12 +- docs/Cask/Artifact/Suite.html | 8 +- docs/Cask/Artifact/Symlinked.html | 20 +- docs/Cask/Artifact/Uninstall.html | 8 +- docs/Cask/Artifact/Vst3Plugin.html | 4 +- docs/Cask/Artifact/VstPlugin.html | 4 +- docs/Cask/Artifact/Zap.html | 4 +- docs/Cask/ArtifactSet.html | 8 +- docs/Cask/Audit.html | 56 +- docs/Cask/Auditor.html | 17 +- docs/Cask/Cache.html | 4 +- docs/Cask/Cask.html | 248 ++---- docs/Cask/CaskCannotBeInstalledError.html | 4 +- docs/Cask/CaskConflictError.html | 4 +- docs/Cask/CaskLoader.html | 24 +- .../CaskLoader/AbstractContentLoader.html | 8 +- docs/Cask/CaskLoader/FromAPILoader.html | 40 +- docs/Cask/CaskLoader/FromContentLoader.html | 12 +- .../CaskLoader/FromInstalledPathLoader.html | 4 +- docs/Cask/CaskLoader/FromInstanceLoader.html | 12 +- docs/Cask/CaskLoader/FromNameLoader.html | 4 +- docs/Cask/CaskLoader/FromPathLoader.html | 20 +- docs/Cask/CaskLoader/FromTapLoader.html | 16 +- docs/Cask/CaskLoader/FromURILoader.html | 16 +- docs/Cask/CaskLoader/ILoader.html | 8 +- docs/Cask/CaskLoader/NullLoader.html | 12 +- docs/Cask/CaskQuarantineError.html | 8 +- docs/Cask/Caskroom.html | 12 +- docs/Cask/Config.html | 53 +- docs/Cask/DSL.html | 148 +--- docs/Cask/DSL/Base.html | 8 +- docs/Cask/DSL/Caveats.html | 13 +- docs/Cask/DSL/ConflictsWith.html | 5 +- docs/Cask/DSL/Container.html | 16 +- docs/Cask/DSL/DependsOn.html | 23 +- docs/Cask/DSL/Postflight.html | 4 +- docs/Cask/DSL/Version.html | 68 +- docs/Cask/Denylist.html | 4 +- docs/Cask/Download.html | 36 +- docs/Cask/Info.html | 27 +- docs/Cask/Installer.html | 220 ++---- docs/Cask/List.html | 9 +- docs/Cask/Metadata.html | 18 +- docs/Cask/Migrator.html | 25 +- docs/Cask/Pkg.html | 44 +- docs/Cask/Quarantine.html | 39 +- docs/Cask/Reinstall.html | 5 +- docs/Cask/Staged.html | 9 +- docs/Cask/TapCaskAmbiguityError.html | 12 +- docs/Cask/TapCaskUnavailableError.html | 4 +- docs/Cask/URL.html | 24 +- docs/Cask/URL/BlockDSL.html | 17 +- docs/Cask/URL/BlockDSL/PageWithURL.html | 4 +- docs/Cask/URL/DSL.html | 65 +- docs/Cask/Uninstall.html | 5 +- docs/Cask/Upgrade.html | 9 +- docs/Cask/Utils.html | 32 +- docs/CaskDependent.html | 36 +- docs/Caveats.html | 22 +- docs/Checksum.html | 30 +- docs/ChecksumMismatchError.html | 4 +- docs/ChecksumMissingError.html | 2 +- docs/ChildProcessError.html | 8 +- docs/Cleaner.html | 14 +- docs/CodesignRequirement.html | 4 +- docs/Commands.html | 98 +-- docs/CompilerConstants.html | 5 - docs/CompilerFailure.html | 20 +- docs/CompilerSelectionError.html | 2 +- docs/CompilerSelector.html | 33 +- docs/CompilerSelector/Compiler.html | 1 - docs/Context.html | 24 +- docs/Context/ContextStruct.html | 12 +- docs/CoreCaskTap.html | 36 +- docs/CoreTap.html | 88 +-- docs/CurlApacheMirrorDownloadStrategy.html | 4 +- docs/CurlDownloadStrategy.html | 12 +- docs/CurlGitHubPackagesDownloadStrategy.html | 4 +- docs/CxxStdlib.html | 16 +- docs/DATAPatch.html | 8 +- docs/Debrew.html | 16 +- docs/Debrew/Formula.html | 12 +- docs/Debrew/Menu.html | 20 +- docs/Debrew/Menu/Entry.html | 1 - docs/Dependable.html | 44 +- docs/Dependencies.html | 29 +- docs/DependenciesHelpers.html | 17 +- docs/Dependency.html | 52 +- docs/DependencyCollector.html | 80 +- docs/DeprecateDisable.html | 14 +- docs/DeprecatedOption.html | 20 +- docs/Descriptions.html | 4 +- docs/DevelopmentTools.html | 59 +- docs/DiskUsageExtension.html | 13 +- docs/DownloadError.html | 4 +- docs/DownloadStrategyDetector.html | 12 +- docs/Downloadable.html | 60 +- docs/ELFShim.html | 69 +- docs/EmbeddedPatch.html | 20 +- docs/Enumerable.html | 7 +- docs/EnvActivation.html | 21 +- docs/EnvMethods.html | 37 +- docs/ErrorDuringExecution.html | 16 +- docs/ExternalPatch.html | 20 +- docs/FalseClass.html | 4 +- docs/File.html | 14 +- docs/Formatter.html | 28 +- docs/Formula.html | 707 +++++++----------- docs/FormulaCellarChecks.html | 112 +-- docs/FormulaClassUnavailableErrorModule.html | 12 +- docs/FormulaConflictError.html | 16 +- docs/FormulaInfo.html | 32 +- docs/FormulaInstaller.html | 324 ++------ docs/FormulaOrCaskUnavailableError.html | 8 +- docs/FormulaPin.html | 28 +- docs/FormulaUnavailableError.html | 8 +- docs/FormulaUnreadableErrorModule.html | 5 +- docs/FormulaValidationError.html | 8 +- docs/FormulaVersions.html | 15 +- docs/Formulary.html | 99 +-- docs/Formulary/FormulaContentsLoader.html | 8 +- docs/Formulary/FormulaLoader.html | 20 +- docs/Formulary/FromAPILoader.html | 12 +- docs/Formulary/FromBottleLoader.html | 8 +- docs/Formulary/FromCacheLoader.html | 4 +- docs/Formulary/FromKegLoader.html | 4 +- docs/Formulary/FromNameLoader.html | 4 +- docs/Formulary/FromPathLoader.html | 8 +- docs/Formulary/FromTapLoader.html | 24 +- docs/Formulary/FromURILoader.html | 16 +- docs/Formulary/NullLoader.html | 12 +- docs/Formulary/PathnameWriteMkpath.html | 1 - docs/FossilDownloadStrategy.html | 12 +- docs/GitDownloadStrategy.html | 8 +- docs/GitHub.html | 221 ++---- docs/GitHub/API.html | 32 +- docs/GitHub/API/Error.html | 4 +- docs/GitHub/API/RateLimitExceededError.html | 4 +- docs/GitHub/Actions.html | 8 +- docs/GitHub/Actions/Annotation.html | 9 +- docs/GitHubArtifactDownloadStrategy.html | 4 +- docs/GitHubGitDownloadStrategy.html | 12 +- docs/GitHubPackages.html | 33 +- docs/GitHubReleases.html | 5 +- docs/GitHubRunner.html | 20 +- docs/GitHubRunnerMatrix.html | 12 +- docs/GitRepository.html | 22 +- docs/Hardware.html | 8 +- docs/Hardware/CPU.html | 136 +--- docs/Hash.html | 11 +- docs/HeadSoftwareSpec.html | 3 +- docs/Homebrew.html | 145 +--- docs/Homebrew/API.html | 28 +- docs/Homebrew/API/Analytics.html | 8 +- docs/Homebrew/API/Cask.html | 20 +- docs/Homebrew/API/Download.html | 13 +- docs/Homebrew/API/DownloadStrategy.html | 5 +- docs/Homebrew/API/Formula.html | 32 +- docs/Homebrew/AbstractCommand.html | 44 +- docs/Homebrew/Assertions.html | 5 +- docs/Homebrew/Attestation.html | 9 +- docs/Homebrew/BumpVersionParser.html | 28 +- docs/Homebrew/BundleVersion.html | 32 +- docs/Homebrew/CLI.html | 1 - docs/Homebrew/CLI/Args.html | 101 +-- docs/Homebrew/CLI/InvalidConstraintError.html | 5 +- docs/Homebrew/CLI/MaxNamedArgumentsError.html | 5 +- docs/Homebrew/CLI/MinNamedArgumentsError.html | 5 +- docs/Homebrew/CLI/NamedArgs.html | 60 +- .../CLI/NumberOfNamedArgumentsError.html | 5 +- docs/Homebrew/CLI/OptionConflictError.html | 5 +- docs/Homebrew/CLI/OptionConstraintError.html | 5 +- docs/Homebrew/CLI/Parser.html | 114 +-- docs/Homebrew/Cleanup.html | 153 +--- docs/Homebrew/Cmd.html | 1 - docs/Homebrew/Cmd/Analytics.html | 8 +- docs/Homebrew/Cmd/Analytics/Args.html | 1 - docs/Homebrew/Cmd/Autoremove.html | 8 +- docs/Homebrew/Cmd/Autoremove/Args.html | 9 +- docs/Homebrew/Cmd/Cache.html | 12 +- docs/Homebrew/Cmd/Cache/Args.html | 45 +- docs/Homebrew/Cmd/Caskroom.html | 12 +- docs/Homebrew/Cmd/Caskroom/Args.html | 1 - docs/Homebrew/Cmd/Cellar.html | 12 +- docs/Homebrew/Cmd/Cellar/Args.html | 1 - docs/Homebrew/Cmd/CleanupCmd.html | 8 +- docs/Homebrew/Cmd/CleanupCmd/Args.html | 21 +- docs/Homebrew/Cmd/CommandsCmd.html | 8 +- docs/Homebrew/Cmd/CommandsCmd/Args.html | 5 +- docs/Homebrew/Cmd/CompletionsCmd.html | 8 +- docs/Homebrew/Cmd/CompletionsCmd/Args.html | 1 - docs/Homebrew/Cmd/Config.html | 8 +- docs/Homebrew/Cmd/Config/Args.html | 1 - docs/Homebrew/Cmd/Deps.html | 8 +- docs/Homebrew/Cmd/Deps/Args.html | 105 +-- docs/Homebrew/Cmd/Desc.html | 8 +- docs/Homebrew/Cmd/Desc/Args.html | 41 +- docs/Homebrew/Cmd/Developer.html | 8 +- docs/Homebrew/Cmd/Developer/Args.html | 1 - docs/Homebrew/Cmd/Docs.html | 8 +- docs/Homebrew/Cmd/Docs/Args.html | 1 - docs/Homebrew/Cmd/Doctor.html | 8 +- docs/Homebrew/Cmd/Doctor/Args.html | 13 +- docs/Homebrew/Cmd/Env.html | 12 +- docs/Homebrew/Cmd/Env/Args.html | 9 +- docs/Homebrew/Cmd/FetchCmd.html | 9 +- docs/Homebrew/Cmd/FetchCmd/Args.html | 69 +- docs/Homebrew/Cmd/GistLogs.html | 8 +- docs/Homebrew/Cmd/GistLogs/Args.html | 21 +- docs/Homebrew/Cmd/HelpCmd.html | 8 +- docs/Homebrew/Cmd/HelpCmd/Args.html | 1 - docs/Homebrew/Cmd/Home.html | 8 +- docs/Homebrew/Cmd/Home/Args.html | 17 +- docs/Homebrew/Cmd/Info.html | 15 +- docs/Homebrew/Cmd/Info/Args.html | 53 +- docs/Homebrew/Cmd/InstallCmd.html | 8 +- docs/Homebrew/Cmd/InstallCmd/Args.html | 205 ++--- docs/Homebrew/Cmd/Leaves.html | 8 +- docs/Homebrew/Cmd/Leaves/Args.html | 17 +- docs/Homebrew/Cmd/Link.html | 8 +- docs/Homebrew/Cmd/Link/Args.html | 25 +- docs/Homebrew/Cmd/List.html | 8 +- docs/Homebrew/Cmd/List/Args.html | 53 +- docs/Homebrew/Cmd/Log.html | 8 +- docs/Homebrew/Cmd/Log/Args.html | 45 +- docs/Homebrew/Cmd/Migrate.html | 8 +- docs/Homebrew/Cmd/Migrate/Args.html | 33 +- docs/Homebrew/Cmd/Missing.html | 8 +- docs/Homebrew/Cmd/Missing/Args.html | 5 +- docs/Homebrew/Cmd/NodenvSync.html | 8 +- docs/Homebrew/Cmd/NodenvSync/Args.html | 1 - docs/Homebrew/Cmd/OptionsCmd.html | 8 +- docs/Homebrew/Cmd/OptionsCmd/Args.html | 17 +- docs/Homebrew/Cmd/Outdated.html | 8 +- docs/Homebrew/Cmd/Outdated/Args.html | 41 +- docs/Homebrew/Cmd/Pin.html | 8 +- docs/Homebrew/Cmd/Pin/Args.html | 1 - .../Cmd/PostgresqlUpgradeDatabase.html | 8 +- .../Cmd/PostgresqlUpgradeDatabase/Args.html | 1 - docs/Homebrew/Cmd/Postinstall.html | 8 +- docs/Homebrew/Cmd/Postinstall/Args.html | 1 - docs/Homebrew/Cmd/Prefix.html | 14 +- docs/Homebrew/Cmd/Prefix/Args.html | 9 +- docs/Homebrew/Cmd/PrettyListing.html | 1 - docs/Homebrew/Cmd/PyenvSync.html | 8 +- docs/Homebrew/Cmd/PyenvSync/Args.html | 1 - docs/Homebrew/Cmd/RbenvSync.html | 8 +- docs/Homebrew/Cmd/RbenvSync/Args.html | 1 - docs/Homebrew/Cmd/ReadallCmd.html | 8 +- docs/Homebrew/Cmd/ReadallCmd/Args.html | 25 +- docs/Homebrew/Cmd/Reinstall.html | 8 +- docs/Homebrew/Cmd/Reinstall/Args.html | 153 +--- docs/Homebrew/Cmd/Repository.html | 12 +- docs/Homebrew/Cmd/Repository/Args.html | 1 - docs/Homebrew/Cmd/SearchCmd.html | 9 +- docs/Homebrew/Cmd/SearchCmd/Args.html | 69 +- docs/Homebrew/Cmd/TapCmd.html | 8 +- docs/Homebrew/Cmd/TapCmd/Args.html | 21 +- docs/Homebrew/Cmd/TapInfo.html | 8 +- docs/Homebrew/Cmd/TapInfo/Args.html | 9 +- docs/Homebrew/Cmd/UninstallCmd.html | 8 +- docs/Homebrew/Cmd/UninstallCmd/Args.html | 33 +- docs/Homebrew/Cmd/UnlinkCmd.html | 8 +- docs/Homebrew/Cmd/UnlinkCmd/Args.html | 9 +- docs/Homebrew/Cmd/Unpin.html | 8 +- docs/Homebrew/Cmd/Unpin/Args.html | 1 - docs/Homebrew/Cmd/Untap.html | 8 +- docs/Homebrew/Cmd/Untap/Args.html | 9 +- docs/Homebrew/Cmd/UpdateReport.html | 8 +- docs/Homebrew/Cmd/UpdateReport/Args.html | 17 +- docs/Homebrew/Cmd/UpgradeCmd.html | 8 +- docs/Homebrew/Cmd/UpgradeCmd/Args.html | 173 ++--- docs/Homebrew/Cmd/Uses.html | 8 +- docs/Homebrew/Cmd/Uses/Args.html | 49 +- docs/Homebrew/Completions.html | 71 +- docs/Homebrew/Completions/Variables.html | 1 - docs/Homebrew/DevCmd.html | 1 - docs/Homebrew/DevCmd/Audit.html | 8 +- docs/Homebrew/DevCmd/Audit/Args.html | 109 +-- docs/Homebrew/DevCmd/Bottle.html | 39 +- docs/Homebrew/DevCmd/Bottle/Args.html | 53 +- docs/Homebrew/DevCmd/Bump.html | 8 +- docs/Homebrew/DevCmd/Bump/Args.html | 57 +- .../Homebrew/DevCmd/Bump/VersionBumpInfo.html | 5 +- docs/Homebrew/DevCmd/BumpCaskPr.html | 8 +- docs/Homebrew/DevCmd/BumpCaskPr/Args.html | 73 +- docs/Homebrew/DevCmd/BumpFormulaPr.html | 8 +- docs/Homebrew/DevCmd/BumpFormulaPr/Args.html | 93 +-- docs/Homebrew/DevCmd/BumpRevision.html | 8 +- docs/Homebrew/DevCmd/BumpRevision/Args.html | 21 +- .../Homebrew/DevCmd/BumpUnversionedCasks.html | 8 +- .../DevCmd/BumpUnversionedCasks/Args.html | 17 +- docs/Homebrew/DevCmd/Cat.html | 8 +- docs/Homebrew/DevCmd/Cat/Args.html | 17 +- docs/Homebrew/DevCmd/Command.html | 8 +- docs/Homebrew/DevCmd/Command/Args.html | 1 - docs/Homebrew/DevCmd/Contributions.html | 11 +- docs/Homebrew/DevCmd/Contributions/Args.html | 21 +- docs/Homebrew/DevCmd/Create.html | 4 +- docs/Homebrew/DevCmd/Create/Args.html | 77 +- .../Homebrew/DevCmd/DetermineTestRunners.html | 8 +- .../DevCmd/DetermineTestRunners/Args.html | 13 +- docs/Homebrew/DevCmd/DispatchBuildBottle.html | 8 +- .../DevCmd/DispatchBuildBottle/Args.html | 37 +- docs/Homebrew/DevCmd/Edit.html | 8 +- docs/Homebrew/DevCmd/Edit/Args.html | 21 +- docs/Homebrew/DevCmd/Extract.html | 9 +- docs/Homebrew/DevCmd/Extract/Args.html | 13 +- docs/Homebrew/DevCmd/FormulaCmd.html | 8 +- docs/Homebrew/DevCmd/FormulaCmd/Args.html | 1 - docs/Homebrew/DevCmd/GenerateCaskApi.html | 9 +- .../Homebrew/DevCmd/GenerateCaskApi/Args.html | 9 +- docs/Homebrew/DevCmd/GenerateFormulaApi.html | 9 +- .../DevCmd/GenerateFormulaApi/Args.html | 9 +- .../DevCmd/GenerateManCompletions.html | 8 +- .../DevCmd/GenerateManCompletions/Args.html | 1 - docs/Homebrew/DevCmd/InstallBundlerGems.html | 8 +- .../DevCmd/InstallBundlerGems/Args.html | 9 +- docs/Homebrew/DevCmd/Irb.html | 8 +- docs/Homebrew/DevCmd/Irb/Args.html | 9 +- docs/Homebrew/DevCmd/Linkage.html | 8 +- docs/Homebrew/DevCmd/Linkage/Args.html | 17 +- docs/Homebrew/DevCmd/LivecheckCmd.html | 8 +- docs/Homebrew/DevCmd/LivecheckCmd/Args.html | 53 +- docs/Homebrew/DevCmd/PrAutomerge.html | 8 +- docs/Homebrew/DevCmd/PrAutomerge/Args.html | 33 +- docs/Homebrew/DevCmd/PrPublish.html | 8 +- docs/Homebrew/DevCmd/PrPublish/Args.html | 25 +- docs/Homebrew/DevCmd/PrPull.html | 24 +- docs/Homebrew/DevCmd/PrPull/Args.html | 85 +-- docs/Homebrew/DevCmd/PrUpload.html | 8 +- docs/Homebrew/DevCmd/PrUpload/Args.html | 37 +- docs/Homebrew/DevCmd/Prof.html | 8 +- docs/Homebrew/DevCmd/Prof/Args.html | 5 +- docs/Homebrew/DevCmd/Release.html | 8 +- docs/Homebrew/DevCmd/Release/Args.html | 9 +- docs/Homebrew/DevCmd/Ruby.html | 8 +- docs/Homebrew/DevCmd/Ruby/Args.html | 9 +- docs/Homebrew/DevCmd/Rubydoc.html | 8 +- docs/Homebrew/DevCmd/Rubydoc/Args.html | 9 +- docs/Homebrew/DevCmd/Sh.html | 8 +- docs/Homebrew/DevCmd/Sh/Args.html | 13 +- docs/Homebrew/DevCmd/StyleCmd.html | 8 +- docs/Homebrew/DevCmd/StyleCmd/Args.html | 37 +- docs/Homebrew/DevCmd/TapNew.html | 8 +- docs/Homebrew/DevCmd/TapNew/Args.html | 17 +- docs/Homebrew/DevCmd/Test.html | 8 +- docs/Homebrew/DevCmd/Test/Args.html | 21 +- docs/Homebrew/DevCmd/Tests.html | 8 +- docs/Homebrew/DevCmd/Tests/Args.html | 33 +- docs/Homebrew/DevCmd/Typecheck.html | 8 +- docs/Homebrew/DevCmd/Typecheck/Args.html | 29 +- docs/Homebrew/DevCmd/Unbottled.html | 8 +- docs/Homebrew/DevCmd/Unbottled/Args.html | 21 +- docs/Homebrew/DevCmd/Unpack.html | 8 +- docs/Homebrew/DevCmd/Unpack/Args.html | 25 +- docs/Homebrew/DevCmd/UpdateLicenseData.html | 8 +- .../DevCmd/UpdateLicenseData/Args.html | 1 - docs/Homebrew/DevCmd/UpdateMaintainers.html | 8 +- .../DevCmd/UpdateMaintainers/Args.html | 1 - .../DevCmd/UpdatePythonResources.html | 8 +- .../DevCmd/UpdatePythonResources/Args.html | 41 +- docs/Homebrew/DevCmd/UpdateSponsors.html | 10 +- docs/Homebrew/DevCmd/UpdateSponsors/Args.html | 1 - docs/Homebrew/DevCmd/UpdateTest.html | 12 +- docs/Homebrew/DevCmd/UpdateTest/Args.html | 17 +- docs/Homebrew/DevCmd/VendorGems.html | 8 +- docs/Homebrew/DevCmd/VendorGems/Args.html | 13 +- docs/Homebrew/Diagnostic.html | 8 +- docs/Homebrew/Diagnostic/Checks.html | 366 +++------ docs/Homebrew/Diagnostic/Volumes.html | 9 +- docs/Homebrew/EnvConfig.html | 382 +++------- docs/Homebrew/Fetch.html | 5 +- docs/Homebrew/FormulaAuditor.html | 158 +--- docs/Homebrew/FormulaCreator.html | 28 +- docs/Homebrew/FormulaTextAuditor.html | 24 +- docs/Homebrew/Help.html | 4 +- docs/Homebrew/Install.html | 28 +- docs/Homebrew/Livecheck.html | 26 +- docs/Homebrew/Livecheck/LivecheckVersion.html | 16 +- docs/Homebrew/Livecheck/SkipConditions.html | 44 +- docs/Homebrew/Livecheck/Strategy.html | 6 +- docs/Homebrew/Livecheck/Strategy/Apache.html | 10 +- .../Livecheck/Strategy/Bitbucket.html | 12 +- docs/Homebrew/Livecheck/Strategy/Cpan.html | 9 +- docs/Homebrew/Livecheck/Strategy/Crate.html | 4 +- .../Livecheck/Strategy/ElectronBuilder.html | 3 +- .../Livecheck/Strategy/ExtractPlist.html | 4 +- .../Livecheck/Strategy/ExtractPlist/Item.html | 1 - docs/Homebrew/Livecheck/Strategy/Git.html | 14 +- .../Livecheck/Strategy/GithubLatest.html | 17 +- .../Livecheck/Strategy/GithubReleases.html | 19 +- docs/Homebrew/Livecheck/Strategy/Gnome.html | 15 +- docs/Homebrew/Livecheck/Strategy/Gnu.html | 39 +- docs/Homebrew/Livecheck/Strategy/Hackage.html | 8 +- .../Livecheck/Strategy/HeaderMatch.html | 5 +- docs/Homebrew/Livecheck/Strategy/Json.html | 5 +- .../Livecheck/Strategy/Launchpad.html | 12 +- docs/Homebrew/Livecheck/Strategy/Npm.html | 11 +- .../Livecheck/Strategy/PageMatch.html | 1 - docs/Homebrew/Livecheck/Strategy/Pypi.html | 7 +- .../Livecheck/Strategy/Sourceforge.html | 21 +- docs/Homebrew/Livecheck/Strategy/Sparkle.html | 6 +- .../Livecheck/Strategy/Sparkle/Item.html | 1 - docs/Homebrew/Livecheck/Strategy/Xml.html | 7 +- docs/Homebrew/Livecheck/Strategy/Xorg.html | 23 +- docs/Homebrew/Livecheck/Strategy/Yaml.html | 5 +- docs/Homebrew/Manpages.html | 48 +- docs/Homebrew/Manpages/Converter.html | 1 - .../Homebrew/Manpages/Converter/Kramdown.html | 8 +- docs/Homebrew/Manpages/Converter/Roff.html | 12 +- docs/Homebrew/Manpages/Parser.html | 1 - docs/Homebrew/Manpages/Parser/Ronn.html | 6 +- docs/Homebrew/Manpages/Variables.html | 1 - docs/Homebrew/MissingFormula.html | 24 +- docs/Homebrew/Parlour.html | 5 +- docs/Homebrew/ResourceAuditor.html | 76 +- docs/Homebrew/Search.html | 36 +- docs/Homebrew/Service.html | 167 +---- docs/Homebrew/Settings.html | 12 +- docs/Homebrew/SimulateSystem.html | 32 +- docs/Homebrew/SourceLocation.html | 12 +- docs/Homebrew/Style.html | 33 +- docs/Homebrew/Style/Offense.html | 28 +- docs/Homebrew/Style/Offenses.html | 8 +- docs/Homebrew/TapAuditor.html | 64 +- docs/Homebrew/Uninstall.html | 16 +- .../Homebrew/Uninstall/DependentsMessage.html | 13 +- .../Uninstall/DeveloperDependentsMessage.html | 5 +- .../NondeveloperDependentsMessage.html | 5 +- docs/Homebrew/Unlink.html | 8 +- docs/Homebrew/UnversionedCaskChecker.html | 68 +- docs/Homebrew/Upgrade.html | 29 +- docs/HomebrewCurlDownloadStrategy.html | 2 +- docs/IO.html | 5 +- docs/IRB.html | 3 +- docs/Ignorable.html | 9 +- docs/Ignorable/ExceptionMixin.html | 8 +- docs/InstallRenamed.html | 16 +- docs/InstalledDependents.html | 8 +- docs/Keg.html | 299 ++------ docs/Keg/ConflictError.html | 4 +- docs/Keg/LinkError.html | 12 +- docs/Keg/Relocation.html | 22 +- docs/KegOnlyReason.html | 28 +- docs/Kernel.html | 101 +-- docs/Language.html | 1 - docs/Language/Go.html | 2 +- docs/Language/Java.html | 12 +- docs/Language/Node.html | 20 +- docs/Language/Node/Shebang.html | 4 +- docs/Language/Perl/Shebang.html | 4 +- docs/Language/Python.html | 33 +- docs/Language/Python/Shebang.html | 4 +- docs/Language/Python/Virtualenv.html | 20 +- .../Python/Virtualenv/Virtualenv.html | 10 +- docs/LazyObject.html | 8 +- docs/LinkageCacheStore.html | 8 +- docs/LinkageChecker.html | 34 +- docs/LinuxRequirement.html | 4 +- docs/LinuxRunnerSpec.html | 9 +- docs/Livecheck.html | 24 +- docs/Locale.html | 32 +- docs/LockFile.html | 16 +- docs/MacOSRequirement.html | 34 +- docs/MacOSRunnerSpec.html | 9 +- docs/MacOSVersion.html | 40 +- docs/MacOSVersion/Error.html | 4 +- docs/MacOSVersionErrorCompat.html | 4 +- docs/MacOSVersions.html | 1 - docs/MachOShim.html | 77 +- docs/Mechanize.html | 1 - docs/Mechanize/HTTP.html | 1 - docs/Mechanize/HTTP/ContentDisposition.html | 1 - .../HTTP/ContentDispositionParser.html | 5 +- docs/MercurialDownloadStrategy.html | 8 +- docs/Messages.html | 36 +- docs/Metafiles.html | 10 +- docs/MethodDeprecatedError.html | 4 +- docs/Migrator.html | 76 +- docs/Migrator/MigratorNoOldpathError.html | 2 +- docs/MissingApplyError.html | 2 +- docs/Mktemp.html | 6 +- docs/Module.html | 5 +- docs/NilClass.html | 4 +- docs/NoSuchKegError.html | 6 +- docs/NoUnzipCurlDownloadStrategy.html | 4 +- docs/Numeric.html | 4 +- docs/OS.html | 13 +- docs/OS/Linux.html | 8 +- docs/OS/Linux/Elf.html | 4 +- docs/OS/Linux/Glibc.html | 20 +- docs/OS/Linux/Kernel.html | 8 +- docs/OS/Linux/Ld.html | 16 +- docs/OS/Mac.html | 80 +- docs/OS/Mac/BaseSDKLocator/NoSDKError.html | 1 - docs/OS/Mac/CLT.html | 49 +- docs/OS/Mac/CLTSDKLocator.html | 4 +- docs/OS/Mac/SDK.html | 16 +- docs/OS/Mac/Xcode.html | 72 +- docs/OS/Mac/XcodeSDKLocator.html | 4 +- docs/Object.html | 48 +- docs/ObserverPathnameExtension.html | 48 +- docs/OnSystem.html | 28 +- docs/OnSystem/MacOSAndLinux.html | 4 +- docs/OnSystem/MacOSOnly.html | 9 +- docs/Option.html | 24 +- docs/Options.html | 65 +- docs/PATH.html | 45 +- docs/Patch.html | 4 +- docs/Pathname.html | 99 +-- docs/PkgVersion.html | 53 +- docs/PourBottleCheck.html | 6 +- docs/PyPI.html | 16 +- docs/PyPI/Package.html | 36 +- docs/Readall.html | 20 +- docs/Repology.html | 18 +- docs/Reporter.html | 16 +- docs/ReporterHub.html | 17 +- docs/Requirement.html | 76 +- docs/Requirements.html | 4 +- docs/Resource.html | 84 +-- docs/Resource/Go.html | 4 +- docs/Resource/Partial.html | 1 - docs/Resource/PatchResource.html | 12 +- docs/RuboCop.html | 1 - docs/RuboCop/AST.html | 1 - docs/RuboCop/AST/Node.html | 41 +- docs/RuboCop/Cask.html | 1 - docs/RuboCop/Cask/AST.html | 1 - docs/RuboCop/Cask/AST/CaskBlock.html | 16 +- docs/RuboCop/Cask/AST/CaskHeader.html | 28 +- docs/RuboCop/Cask/AST/Stanza.html | 44 +- docs/RuboCop/Cask/AST/StanzaBlock.html | 17 +- docs/RuboCop/Cask/Constants.html | 6 - docs/RuboCop/Cop.html | 1 - docs/RuboCop/Cop/Cask.html | 1 - .../Cop/Cask/ArrayAlphabetization.html | 13 +- docs/RuboCop/Cop/Cask/CaskHelp.html | 21 +- docs/RuboCop/Cop/Cask/Desc.html | 4 +- docs/RuboCop/Cop/Cask/Discontinued.html | 13 +- .../Cop/Cask/HomepageUrlTrailingSlash.html | 7 +- docs/RuboCop/Cop/Cask/NoOverrides.html | 22 +- docs/RuboCop/Cop/Cask/OnDescStanza.html | 5 +- docs/RuboCop/Cop/Cask/OnHomepageStanza.html | 5 +- .../Cop/Cask/OnSystemConditionals.html | 9 +- docs/RuboCop/Cop/Cask/OnUrlStanza.html | 5 +- docs/RuboCop/Cop/Cask/SharedFilelistGlob.html | 5 +- docs/RuboCop/Cop/Cask/StanzaGrouping.html | 8 +- docs/RuboCop/Cop/Cask/StanzaOrder.html | 11 +- .../Cop/Cask/UninstallMethodsOrder.html | 15 +- docs/RuboCop/Cop/Cask/Url.html | 6 +- .../Cop/Cask/UrlLegacyCommaSeparators.html | 5 +- docs/RuboCop/Cop/Cask/Variables.html | 8 +- docs/RuboCop/Cop/DescHelper.html | 7 +- docs/RuboCop/Cop/FormulaAudit.html | 1 - .../Cop/FormulaAudit/AssertStatements.html | 4 +- .../FormulaAudit/BottleDigestIndentation.html | 4 +- .../Cop/FormulaAudit/BottleFormat.html | 4 +- .../RuboCop/Cop/FormulaAudit/BottleOrder.html | 12 +- .../FormulaAudit/BottleTagIndentation.html | 4 +- docs/RuboCop/Cop/FormulaAudit/Caveats.html | 6 +- docs/RuboCop/Cop/FormulaAudit/Checksum.html | 8 +- .../Cop/FormulaAudit/ChecksumCase.html | 4 +- .../Cop/FormulaAudit/ClassInheritance.html | 4 +- docs/RuboCop/Cop/FormulaAudit/ClassName.html | 5 +- docs/RuboCop/Cop/FormulaAudit/Comments.html | 4 +- .../Cop/FormulaAudit/ComponentsOrder.html | 24 +- .../FormulaAudit/ComponentsRedundancy.html | 20 +- docs/RuboCop/Cop/FormulaAudit/Conflicts.html | 5 +- .../Cop/FormulaAudit/DependencyOrder.html | 68 +- .../FormulaAudit/DeprecateDisableDate.html | 8 +- .../FormulaAudit/DeprecateDisableReason.html | 9 +- docs/RuboCop/Cop/FormulaAudit/Desc.html | 4 +- docs/RuboCop/Cop/FormulaAudit/Files.html | 6 +- .../FormulaAudit/GenerateCompletionsDSL.html | 12 +- docs/RuboCop/Cop/FormulaAudit/GitUrls.html | 8 +- docs/RuboCop/Cop/FormulaAudit/Homepage.html | 4 +- docs/RuboCop/Cop/FormulaAudit/KegOnly.html | 8 +- .../Cop/FormulaAudit/LicenseArrays.html | 4 +- docs/RuboCop/Cop/FormulaAudit/Licenses.html | 8 +- docs/RuboCop/Cop/FormulaAudit/Lines.html | 4 +- .../LivecheckRegexCaseInsensitive.html | 5 +- .../FormulaAudit/LivecheckRegexExtension.html | 7 +- .../LivecheckRegexIfPageMatch.html | 4 +- .../LivecheckRegexParentheses.html | 4 +- .../Cop/FormulaAudit/LivecheckSkip.html | 4 +- .../FormulaAudit/LivecheckUrlProvided.html | 4 +- .../Cop/FormulaAudit/LivecheckUrlSymbol.html | 8 +- .../Cop/FormulaAudit/MacOSOnLinux.html | 5 +- .../Cop/FormulaAudit/Miscellaneous.html | 28 +- docs/RuboCop/Cop/FormulaAudit/MpiCheck.html | 4 +- .../FormulaAudit/OnSystemConditionals.html | 6 +- .../Cop/FormulaAudit/OptionDeclarations.html | 12 +- docs/RuboCop/Cop/FormulaAudit/Options.html | 8 +- docs/RuboCop/Cop/FormulaAudit/Patches.html | 8 +- .../Cop/FormulaAudit/ProvidedByMacos.html | 5 +- docs/RuboCop/Cop/FormulaAudit/PyPiUrls.html | 8 +- .../Cop/FormulaAudit/PyoxidizerCheck.html | 4 +- .../Cop/FormulaAudit/PythonVersions.html | 4 +- .../Cop/FormulaAudit/QuicTLSCheck.html | 4 +- .../ResourceRequiresDependencies.html | 4 +- .../Cop/FormulaAudit/SafePopenCommands.html | 4 +- docs/RuboCop/Cop/FormulaAudit/Service.html | 5 +- .../Cop/FormulaAudit/ShellVariables.html | 4 +- .../SingleGenerateCompletionsDSLCall.html | 4 +- docs/RuboCop/Cop/FormulaAudit/Test.html | 8 +- docs/RuboCop/Cop/FormulaAudit/Text.html | 8 +- docs/RuboCop/Cop/FormulaAudit/Urls.html | 4 +- .../Cop/FormulaAudit/UsesFromMacos.html | 6 +- docs/RuboCop/Cop/FormulaAudit/Version.html | 4 +- docs/RuboCop/Cop/FormulaAuditStrict.html | 1 - .../Cop/FormulaAuditStrict/GitUrls.html | 8 +- .../Cop/FormulaAuditStrict/MakeCheck.html | 4 +- .../Cop/FormulaAuditStrict/Requirements.html | 4 +- .../Cop/FormulaAuditStrict/RustCheck.html | 4 +- .../Cop/FormulaAuditStrict/TestPresent.html | 4 +- docs/RuboCop/Cop/FormulaAuditStrict/Text.html | 16 +- docs/RuboCop/Cop/FormulaCop.html | 33 +- docs/RuboCop/Cop/HelperFunctions.html | 19 +- docs/RuboCop/Cop/Homebrew.html | 5 +- docs/RuboCop/Cop/Homebrew/Blank.html | 9 +- docs/RuboCop/Cop/Homebrew/CompactBlank.html | 14 +- .../Cop/Homebrew/ExecShellMetacharacters.html | 6 +- docs/RuboCop/Cop/Homebrew/IORead.html | 6 +- docs/RuboCop/Cop/Homebrew/MoveToExtendOS.html | 9 +- docs/RuboCop/Cop/Homebrew/NegateInclude.html | 10 +- docs/RuboCop/Cop/Homebrew/Presence.html | 13 +- docs/RuboCop/Cop/Homebrew/Present.html | 17 +- .../Cop/Homebrew/SafeNavigationWithBlank.html | 9 +- docs/RuboCop/Cop/Homebrew/ShellCommands.html | 7 +- .../Cop/OnSystemConditionalsHelper.html | 54 +- docs/SPDX.html | 55 +- docs/Sandbox.html | 80 +- docs/SharedAudits.html | 50 +- docs/SharedEnvExtension.html | 99 +-- docs/Singleton.html | 2 +- docs/SoftwareSpec.html | 93 +-- docs/Stdenv.html | 45 +- docs/String.html | 26 +- docs/StringInreplaceExtension.html | 16 +- docs/StringPatch.html | 4 +- docs/SubversionDownloadStrategy.html | 8 +- docs/Superenv.html | 128 +--- docs/Symbol.html | 4 +- docs/SystemCommand.html | 32 +- docs/SystemCommand/Result.html | 44 +- docs/SystemConfig.html | 94 +-- docs/Tab.html | 173 ++--- docs/Tap.html | 112 +-- docs/Tap/InvalidNameError.html | 1 - docs/TapAlreadyTappedError.html | 4 +- docs/TapConfig.html | 20 +- docs/TapCoreRemoteMismatchError.html | 4 +- docs/TapFormulaAmbiguityError.html | 12 +- docs/TapFormulaClassUnavailableError.html | 4 +- docs/TapFormulaOrCaskUnavailableError.html | 4 +- docs/TapFormulaUnavailableError.html | 12 +- docs/TapNoCustomRemoteError.html | 4 +- docs/TapRemoteMismatchError.html | 18 +- docs/TapUnavailableError.html | 4 +- docs/Tapioca/Compilers/Args.html | 21 +- docs/Tapioca/Compilers/EnvConfig.html | 9 +- docs/Tapioca/Compilers/RuboCop.html | 9 +- docs/Tapioca/Compilers/Tty.html | 9 +- docs/TestRunnerFormula.html | 60 +- docs/Time.html | 4 +- docs/TrueClass.html | 4 +- docs/Tty.html | 108 +-- docs/URL.html | 12 +- docs/UnpackStrategy.html | 41 +- docs/UnpackStrategy/Air.html | 12 +- docs/UnpackStrategy/Bazaar.html | 4 +- docs/UnpackStrategy/Bzip2.html | 8 +- docs/UnpackStrategy/Cab.html | 16 +- docs/UnpackStrategy/Compress.html | 8 +- docs/UnpackStrategy/Cvs.html | 4 +- docs/UnpackStrategy/Directory.html | 8 +- docs/UnpackStrategy/Dmg.html | 8 +- docs/UnpackStrategy/Dmg/Bom.html | 4 +- docs/UnpackStrategy/Dmg/Bom/EmptyError.html | 1 - docs/UnpackStrategy/Dmg/Bom/Error.html | 1 - docs/UnpackStrategy/Executable.html | 8 +- docs/UnpackStrategy/Fossil.html | 8 +- docs/UnpackStrategy/GenericUnar.html | 12 +- docs/UnpackStrategy/Git.html | 4 +- docs/UnpackStrategy/Gzip.html | 8 +- docs/UnpackStrategy/Jar.html | 8 +- docs/UnpackStrategy/Lha.html | 12 +- docs/UnpackStrategy/LuaRock.html | 8 +- docs/UnpackStrategy/Lzip.html | 12 +- docs/UnpackStrategy/Lzma.html | 12 +- docs/UnpackStrategy/Mercurial.html | 4 +- docs/UnpackStrategy/MicrosoftOfficeXml.html | 8 +- docs/UnpackStrategy/Otf.html | 8 +- docs/UnpackStrategy/P7Zip.html | 12 +- docs/UnpackStrategy/Pax.html | 8 +- docs/UnpackStrategy/Pkg.html | 8 +- docs/UnpackStrategy/Rar.html | 12 +- .../SelfExtractingExecutable.html | 8 +- docs/UnpackStrategy/Sit.html | 8 +- docs/UnpackStrategy/Subversion.html | 4 +- docs/UnpackStrategy/Tar.html | 8 +- docs/UnpackStrategy/Ttf.html | 8 +- docs/UnpackStrategy/Uncompressed.html | 4 +- docs/UnpackStrategy/Xar.html | 8 +- docs/UnpackStrategy/Xz.html | 12 +- docs/UnpackStrategy/Zip.html | 8 +- docs/UnpackStrategy/Zstd.html | 12 +- docs/UsageError.html | 4 +- docs/UsesFromMacOSDependency.html | 34 +- docs/Utils.html | 65 +- docs/Utils/AST.html | 25 +- docs/Utils/AST/FormulaAST.html | 36 +- docs/Utils/Analytics.html | 108 +-- docs/Utils/Backtrace.html | 29 +- docs/Utils/Bottles.html | 40 +- docs/Utils/Bottles/Collector.html | 28 +- docs/Utils/Bottles/MacOSOverride.html | 5 +- docs/Utils/Bottles/Tag.html | 60 +- docs/Utils/Bottles/TagSpecification.html | 16 +- docs/Utils/Curl.html | 55 +- docs/Utils/Git.html | 56 +- docs/Utils/Gzip.html | 8 +- docs/Utils/Inreplace.html | 6 +- docs/Utils/Link.html | 20 +- docs/Utils/Path.html | 5 +- docs/Utils/Service.html | 8 +- docs/Utils/Shebang/RewriteInfo.html | 16 +- docs/Utils/Shell.html | 39 +- docs/Utils/Svn.html | 20 +- docs/Utils/Tar.html | 17 +- docs/Utils/Timer.html | 9 +- docs/Utils/TopologicalHash.html | 4 +- docs/VCSDownloadStrategy.html | 18 +- docs/Version.html | 96 +-- docs/Version/AlphaToken.html | 5 +- docs/Version/BetaToken.html | 5 +- docs/Version/CompositeToken.html | 4 +- docs/Version/NumericToken.html | 17 +- docs/Version/Parser.html | 8 +- docs/Version/PatchToken.html | 5 +- docs/Version/PostToken.html | 5 +- docs/Version/PreToken.html | 5 +- docs/Version/RCToken.html | 5 +- docs/Version/RegexParser.html | 16 +- docs/Version/StemParser.html | 7 +- docs/Version/StringToken.html | 13 +- docs/Version/Token.html | 51 +- docs/Version/UrlParser.html | 5 +- docs/Warnings.html | 5 +- docs/XcodeRequirement.html | 16 +- docs/file.README.html | 2 +- docs/index.html | 2 +- docs/top-level-namespace.html | 20 +- 794 files changed, 4671 insertions(+), 13147 deletions(-) diff --git a/docs/APIHashable.html b/docs/APIHashable.html index 88984f8ad..48d9f5d09 100644 --- a/docs/APIHashable.html +++ b/docs/APIHashable.html @@ -134,8 +134,7 @@
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
Disable any output during downloading.
diff --git a/docs/AbstractDownloadStrategy/Pourable.html b/docs/AbstractDownloadStrategy/Pourable.html index ec400615d..9e520b5fa 100644 --- a/docs/AbstractDownloadStrategy/Pourable.html +++ b/docs/AbstractDownloadStrategy/Pourable.html @@ -94,7 +94,6 @@ -Equal to self[4].
-%w( a b c d e ).fifth # => “e”
+%w( a b c d e ).fifth # => "e"
Equal to self[3].
-%w( a b c d e ).fourth # => “d”
+%w( a b c d e ).fourth # => "d"
@@ -493,7 +491,6 @@Equal to self[1].
-%w( a b c d e ).second # => “b”
+%w( a b c d e ).second # => "b"
Equal to self[2].
-%w( a b c d e ).third # => “c”
+%w( a b c d e ).third # => "c"
@@ -663,30 +660,30 @@You can pass the following kwargs to change the default behavior:
==== Examples
-[].to_sentence # => “” - [‘one’].to_sentence # => “one” - [‘one’, ‘two’].to_sentence # => “one and two” - [‘one’, ‘two’, ‘three’].to_sentence # => “one, two, and three” - [‘one’, ‘two’].to_sentence(two_words_connector: ‘-‘) - # => “one-two”
+[].to_sentence # => "" + ['one'].to_sentence # => "one" + ['one', 'two'].to_sentence # => "one and two" + ['one', 'two', 'three'].to_sentence # => "one, two, and three" + ['one', 'two'].to_sentence(two_words_connector: '-') + # => "one-two"
-[‘one’, ‘two’, ‘three’].to_sentence(words_connector: ‘ or ‘, last_word_connector: ‘ or at least ‘) - # => “one or two or at least three” +
['one', 'two', 'three'].to_sentence(words_connector: ' or ', last_word_connector: ' or at least ') + # => "one or two or at least three" Copyright (c) David Heinemeier Hansson
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the -“Software”), to deal in the Software without restriction, including +"Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to @@ -695,7 +692,7 @@
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, +
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE diff --git a/docs/Attr.html b/docs/Attr.html index a9ecd6748..c991401e1 100644 --- a/docs/Attr.html +++ b/docs/Attr.html @@ -147,8 +147,7 @@
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Checksum methods in the DSL’s bottle block take a Hash, which indicates the platform the checksum applies on.
+Checksum methods in the DSL's bottle block take a Hash, which indicates the platform the checksum applies on.
Checksum methods in the DSL’s bottle block take +
Checksum methods in the DSL's bottle block take a Hash, which indicates the platform the checksum applies on. Example bottle block syntax: bottle do - sha256 cellar: :any_skip_relocation, big_sur: “69489ae397e4645…” - sha256 cellar: :any, catalina: “449de5ea35d0e94…” + sha256 cellar: :any_skip_relocation, big_sur: "69489ae397e4645..." + sha256 cellar: :any, catalina: "449de5ea35d0e94..." end
@@ -1331,7 +1306,6 @@This method returns an undefined value.
-This method returns an undefined value.
-True if a Formula is being built with Formula.head instead of Formula.stable.
+args << "--some-new-stuff" if build.head?
+
# If there are multiple conditional arguments use a block instead of lines.
if build.head?
args << "--i-want-pizza"
@@ -587,6 +587,7 @@
True if a Formula is being built with Formula.stable instead of Formula.head.
This is the default.
+
args << "--some-beta" if build.head?
@@ -647,7 +648,6 @@
-
True if a Formula is being built with a specific option.
+args << "--i-want-spam" if build.with? "spam"
args << "--qt-gui" if build.with? "qt" # "--with-qt" ==> build.with? "qt"
@@ -824,6 +824,7 @@
Third parties should avoid using this method if possible, as it may be removed or changed without warning.
True if a Formula is being built without a specific option.
+
args << "--no-spam-plz" if build.without? "spam"
diff --git a/docs/CVSDownloadStrategy.html b/docs/CVSDownloadStrategy.html
index 717224050..aa7e7f36c 100644
--- a/docs/CVSDownloadStrategy.html
+++ b/docs/CVSDownloadStrategy.html
@@ -184,8 +184,7 @@
-
-
+
@@ -321,7 +320,6 @@
-
This method returns an undefined value.
-Deletes data from the cache based on a condition defined in a concrete class.
@@ -378,8 +375,7 @@Fetches cached values in persistent storage according to the type of data stored.
@@ -442,8 +438,7 @@Inserts new values or updates existing cached values to persistent storage.
diff --git a/docs/Cask.html b/docs/Cask.html index 8c797851a..a91e7a543 100644 --- a/docs/Cask.html +++ b/docs/Cask.html @@ -94,7 +94,6 @@ -This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-A formula’s caveats.
+A formula's caveats.
A formula’s checksum.
+A formula's checksum.
Raised by Pathname#verify_checksum when “expected” is nil or empty.
+Raised by Pathname#verify_checksum when "expected" is nil or empty.
.la
files.tbd
filesperllocal.pod
files.packlist
files.la
files.tbd
filesperllocal.pod
files.packlist
filesRaised by CompilerSelector if the formula fails with all of -the compilers available on the user’s system.
+the compilers available on the user's system.This method returns an undefined value.
-This method returns an undefined value.
-Take search results – a hash mapping formula names to descriptions – and print them.
+Take search results -- a hash mapping formula names to descriptions -- and print them.
Take search results – a hash mapping formula names to descriptions – and +
Take search results -- a hash mapping formula names to descriptions -- and print them.
diff --git a/docs/DevelopmentTools.html b/docs/DevelopmentTools.html index 1836e249f..46b77bb9e 100644 --- a/docs/DevelopmentTools.html +++ b/docs/DevelopmentTools.html @@ -144,8 +144,7 @@This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-The runtime search path, such as: “/lib:/usr/lib:/usr/local/lib”.
+The runtime search path, such as: "/lib:/usr/lib:/usr/local/lib".
An array of runtime search path entries, such as: [“/lib”, “/usr/lib”, “/usr/local/lib”].
+An array of runtime search path entries, such as: ["/lib", "/usr/lib", "/usr/local/lib"].
The runtime search path, such as: -“/lib:/usr/lib:/usr/local/lib”
+"/lib:/usr/lib:/usr/local/lib"An array of runtime search path entries, such as: -[“/lib”, “/usr/lib”, “/usr/local/lib”]
+["/lib", "/usr/lib", "/usr/local/lib"]Returns a new +Array+ without the blank items. Uses Object#blank? for determining if an item is blank.
-[1, “”, nil, 2, “ “, [], {}, false, true].compact_blank +
[1, "", nil, 2, " ", [], {}, false, true].compact_blank # => [1, 2, true]
-Set.new([nil, “”, 1, false]).compact_blank +
Set.new([nil, "", 1, false]).compact_blank # => [1]
When called on a +Hash+, returns a new +Hash+ without the blank values.
-{ a: “”, b: 1, c: nil, d: [], e: false, f: true }.compact_blank +
{ a: "", b: 1, c: nil, d: [], e: false, f: true }.compact_blank # => { b: 1, f: true }
diff --git a/docs/EnvActivation.html b/docs/EnvActivation.html index 3af2c28db..2aab11d6d 100644 --- a/docs/EnvActivation.html +++ b/docs/EnvActivation.html @@ -104,7 +104,6 @@ -This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Write to a file atomically. Useful for situations where you don’t +
Write to a file atomically. Useful for situations where you don't want other processes or threads to see half-written files.
-File.atomic_write(‘important.file’) do |file| - file.write(‘hello’) +
File.atomic_write('important.file') do |file| + file.write('hello') end
This method needs to create a temporary file. By default it will create it -in the same directory as the destination file. If you don’t like this +in the same directory as the destination file. If you don't like this behavior you can provide a different directory but it must be on the -same physical filesystem as the file you’re trying to write.
+same physical filesystem as the file you're trying to write. -File.atomic_write(‘/data/something.important’, ‘/data/tmp’) do |file| - file.write(‘hello’) +
File.atomic_write('/data/something.important', '/data/tmp') do |file| + file.write('hello') end
diff --git a/docs/Formatter.html b/docs/Formatter.html index ec0942287..dfa637096 100644 --- a/docs/Formatter.html +++ b/docs/Formatter.html @@ -117,7 +117,6 @@Wraps text to fit within a given number of columns using regular expressions that:
Note that an option (e.g. --foo
) may not be at the beginning of a line,
@@ -747,7 +740,6 @@
To verify the cached download’s integrity and security we verify the SHA-256 hash matches what we’ve declared in the Formula.
+To verify the cached download's integrity and security we verify the SHA-256 hash matches what we've declared in the Formula.
Get the BUILD_FLAGS
from the formula’s namespace set in Formulary::load_formula
.
Get the BUILD_FLAGS
from the formula's namespace set in Formulary::load_formula
.
Defines whether the Formula’s bottle can be used on the given Homebrew installation.
+Defines whether the Formula's bottle can be used on the given Homebrew installation.
The directory where the formula’s Bash completion files should be installed.
+The directory where the formula's Bash completion files should be installed.
The directory where the formula’s binaries should be installed.
+The directory where the formula's binaries should be installed.
Yields | -self,staging | -with current working directory set to the uncompressed tarball where staging is a Mktemp staging context. | -
Yields |self,staging| with current working directory set to the uncompressed tarball where staging is a Mktemp staging context.
The directory where the formula’s documentation should be installed.
+The directory where the formula's documentation should be installed.
The directory where the formula’s configuration files should be installed.
+The directory where the formula's configuration files should be installed.
The directory where the formula’s fish completion files should be installed.
+The directory where the formula's fish completion files should be installed.
The directory where the formula’s fish function files should be installed.
+The directory where the formula's fish function files should be installed.
The directory where the formula’s Frameworks should be installed.
+The directory where the formula's Frameworks should be installed.
Generate shell completions for a formula for bash, zsh, and fish, using the formula’s executable.
+Generate shell completions for a formula for bash, zsh, and fish, using the formula's executable.
The directory where the formula’s headers should be installed.
+The directory where the formula's headers should be installed.
The directory where the formula’s info files should be installed.
+The directory where the formula's info files should be installed.
Has the target of the alias used to install this formula changed? Returns false if the formula wasn’t installed with an alias.
+Has the target of the alias used to install this formula changed? Returns false if the formula wasn't installed with an alias.
Rarely, you don’t want your library symlinked into the main prefix.
+Rarely, you don't want your library symlinked into the main prefix.
The directory where the formula’s kernel extensions should be installed.
+The directory where the formula's kernel extensions should be installed.
The directory where the formula’s libraries should be installed.
+The directory where the formula's libraries should be installed.
The directory where the formula’s binaries should be installed.
+The directory where the formula's binaries should be installed.
The directory where the formula’s installation or test logs will be written.
+The directory where the formula's installation or test logs will be written.
The root directory where the formula’s manual pages should be installed.
+The root directory where the formula's manual pages should be installed.
The directory where the formula’s man1 pages should be installed.
+The directory where the formula's man1 pages should be installed.
The directory where the formula’s man2 pages should be installed.
+The directory where the formula's man2 pages should be installed.
The directory where the formula’s man3 pages should be installed.
+The directory where the formula's man3 pages should be installed.
The directory where the formula’s man4 pages should be installed.
+The directory where the formula's man4 pages should be installed.
The directory where the formula’s man5 pages should be installed.
+The directory where the formula's man5 pages should be installed.
The directory where the formula’s man6 pages should be installed.
+The directory where the formula's man6 pages should be installed.
The directory where the formula’s man7 pages should be installed.
+The directory where the formula's man7 pages should be installed.
The directory where the formula’s man8 pages should be installed.
+The directory where the formula's man8 pages should be installed.
Returns a list of formulae depended on by this formula that aren’t installed.
+Returns a list of formulae depended on by this formula that aren't installed.
The directory where the formula’s shared files should be installed, with the name of the formula appended to avoid linking conflicts.
+The directory where the formula's shared files should be installed, with the name of the formula appended to avoid linking conflicts.
If a formula’s linked keg points to the prefix.
+If a formula's linked keg points to the prefix.
The full set of Requirements for this formula’s dependency tree.
+The full set of Requirements for this formula's dependency tree.
The directory where the formula’s sbin
binaries should be installed.
The directory where the formula's sbin
binaries should be installed.
The directory where the formula’s shared files should be installed.
+The directory where the formula's shared files should be installed.
The directory where the formula’s variable files should be installed.
+The directory where the formula's variable files should be installed.
Runs xcodebuild
without Homebrew’s compiler environment variables set.
Runs xcodebuild
without Homebrew's compiler environment variables set.
The directory where the formula’s zsh completion files should be installed.
+The directory where the formula's zsh completion files should be installed.
The directory where the formula’s zsh function files should be installed.
+The directory where the formula's zsh function files should be installed.
:build
, :test
,
and :postinstall
. When no argument is passed, network access will be
allowed for all phases.
+
allow_network_access!
+
allow_network_access! :build
+
allow_network_access! [:build, :test]
@@ -7725,11 +7622,11 @@ This method returns an undefined value.
Adds a bottle SoftwareSpec. This provides a pre-built binary package built by the Homebrew maintainers for you. It will be installed automatically if there is a binary package for your platform -and you haven’t passed or previously used any options on this formula.
+and you haven't passed or previously used any options on this formula.If you maintain your own repository, you can add your own bottle links. You can ignore this block entirely if submitting to Homebrew/homebrew-core. -It’ll be handled for you by the Brew Test Bot.
+It'll be handled for you by the Brew Test Bot.bottle do
root_url "https://example.com" # Optional root to calculate bottle URLs.
@@ -7811,7 +7708,6 @@
-
:build
, :test
,
and :postinstall
. When no argument is passed, network access will be
denied for all phases.
+
deny_network_access!
+
deny_network_access! :build
+
deny_network_access! [:build, :test]
@@ -7947,6 +7846,7 @@ Deprecated options are used to rename options and migrate users who used
them to newer ones. They are mostly used for migrating non-with
options
(e.g. enable-debug
) to with
options (e.g. with-debug
).
deprecated_option "enable-debug" => "with-debug"
@@ -8148,7 +8048,6 @@ :using =>
) are the same as for url.
-master
is the default branch and doesn’t need stating with a branch:
parameter.
+master
is the default branch and doesn't need stating with a branch:
parameter.
+
head "https://we.prefer.https.over.git.example.com/.git"
+
head "https://example.com/.git", branch: "name_of_branch"
+
or (if autodetect fails):
+head "https://hg.is.awesome.but.git.has.won.example.com/", using: :hg
@@ -8430,7 +8333,6 @@ :with
should be used to specify a valid SPDX exception.
Add +
to an identifier to indicate that the formulae can be
licensed under later versions of the same license.
+
license "BSD-2-Clause"
+
license "EPL-1.0+"
+
license any_of: ["MIT", "GPL-2.0-only"]
+
license all_of: ["MIT", "GPL-2.0-only"]
+
license "GPL-2.0-only" => { with: "LLVM-exception" }
+
license :public_domain
+
license any_of: [
"MIT",
:public_domain,
@@ -8633,7 +8542,6 @@
-
Additional URLs for the stable version of the formula. -These are only used if the url fails to download. It’s optional and +These are only used if the url fails to download. It's optional and there can be more than one. Generally we add them when the main url is unreliable. If url is really unreliable then we may swap the mirror and url.
@@ -8796,20 +8704,20 @@Options can be used as arguments to brew install
.
-To switch features on/off: "with-something"
or "with-otherthing"
.
-To use other software: "with-other-software"
or "without-foo"
.
+To switch features on/off: "with-something"
or "with-otherthing"
.
+To use other software: "with-other-software"
or "without-foo"
.
Note that for depends_on that are :optional
or :recommended
, options
are generated automatically.
There are also some special options:
:universal
: build a universal binary/library (e.g. on newer Intel Macs
-this means a combined x86_64/x86 binary/library).:universal
: build a universal binary/library (e.g. on newer Intel Macs
+this means a combined x86_64/x86 binary/library).
option "with-spam", "The description goes here without a dot at the end"
option "with-qt", "Text here overwrites what's autogenerated by 'depends_on "qt" => :optional'"
-option :universal
+option :universal
To verify the cached download’s integrity and security we verify the
-SHA-256 hash matches what we’ve declared in the Formula. To quickly fill
-this value you can leave it blank and run brew fetch --force
and it’ll
+
To verify the cached download's integrity and security we verify the
+SHA-256 hash matches what we've declared in the Formula. To quickly fill
+this value you can leave it blank and run brew fetch --force
and it'll
tell you the currently valid value.
sha256 "2a2ba417eebaadcb4418ee7b12fe2998f26d6e6f7fda7983412ff66a741ab6f7"
@@ -9136,7 +9042,6 @@ using: ...
.
:git
, :hg
, :svn
, :bzr
, :fossil
, :cvs
,:curl
(normal file download, will also extract):nounzip
(without extracting):post
(download via an HTTP POST):git
, :hg
, :svn
, :bzr
, :fossil
, :cvs
,:curl
(normal file download, will also extract):nounzip
(without extracting):post
(download via an HTTP POST)url "https://packed.sources.and.we.prefer.https.example.com/archive-1.2.3.tar.bz2"
+
url "https://some.dont.provide.archives.example.com",
using: :git,
tag: "1.2.3",
@@ -9357,7 +9263,6 @@
-
A symbol to indicate currently active SoftwareSpec. -It’s either :stable or :head
+It's either :stable or :headThe BuildOptions or Tab for this Formula. Lists the arguments passed and any options in the Formula. Note that these may differ at different times during the installation of a Formula. This is annoying -but the result of state that we’re trying to eliminate.
+but the result of state that we're trying to eliminate.The fully-qualified alias referring to this Formula.
-For core formulae it’s the same as #alias_name.
+For core formulae it's the same as #alias_name.
e.g. homebrew/tap-name/another-name-for-this-formula
The fully-qualified name of this Formula.
-For core formulae it’s the same as #name.
+For core formulae it's the same as #name.
e.g. homebrew/tap-name/this-formula
The Tap instance associated with this Formula.
-If it’s nil
, then this formula is loaded from a path or URL.
nil
, then this formula is loaded from a path or URL.
Get the BUILD_FLAGS
from the formula’s namespace set in Formulary::load_formula
.
Get the BUILD_FLAGS
from the formula's namespace set in Formulary::load_formula
.
One or more formulae that conflict with this one and why.
+conflicts_with "imagemagick", because: "both install `convert` binaries"
@@ -11287,35 +11190,41 @@ :build
means this dependency is only needed during build.
depends_on "cmake" => :build
:test
means this dependency is only needed during testing.
depends_on "node" => :test
:recommended
dependencies are built by default.
But a --without-...
option is generated to opt-out.
depends_on "readline" => :recommended
:optional
dependencies are NOT built by default unless the
auto-generated --with-...
option is passed.
depends_on "glib" => :optional
If you need to specify that another formula has to be built with/out
certain options (note, no --
needed before the option):
depends_on "zeromq" => "with-pgm"
depends_on "qt" => ["with-qtdbus", "developer"] # Multiple options.
-Optional and enforce that “boost” is built using --with-c++11
.
depends_on "boost" => [:optional, "with-c++11"]
-If a dependency is only needed in certain cases:
+If a dependency is only needed in certain cases:depends_on "sqlite" if MacOS.version >= :catalina
depends_on xcode: :build # If the formula really needs full Xcode to compile.
depends_on macos: :mojave # Needs at least macOS Mojave (10.14) to run.
It is possible to only depend on something if
-build.with?
or build.without? "another_formula"
:
build.with?
or build.without? "another_formula"
:
+
depends_on "postgresql" if build.without? "sqlite"
@@ -11359,7 +11268,9 @@ Deprecates a Formula (on the given date) so a warning is shown on each installation. If the date has not yet passed the formula will not be deprecated.
+deprecate! date: "2020-08-27", because: :unmaintained
+
deprecate! date: "2020-08-27", because: "has been replaced by foo"
@@ -11486,7 +11397,9 @@ Disables a Formula (on the given date) so it cannot be installed. If the date has not yet passed the formula will be deprecated instead of disabled.
+disable! date: "2020-08-27", because: :does_not_build
+
disable! date: "2020-08-27", because: "has been replaced by foo"
@@ -11622,6 +11535,7 @@ Marks the Formula as failing with a particular compiler so it will fall back to others. For Apple compilers, this should be in the format:
+fails_with :clang do
build 600
cause "multiple configure and compile errors"
@@ -11631,7 +11545,7 @@
if so, then the compiler will not be allowed for all versions.
major_version
should be the major release number only, for instance
-‘7’ for the GCC 7 series (7.0, 7.1, etc.).
+'7' for the GCC 7 series (7.0, 7.1, etc.).
If version
or the block is omitted, then the compiler will
not be allowed for all compilers in that series.
@@ -11687,7 +11601,6 @@
-
Initialise instance variables for each subclass. These need to be initialised before the class is frozen, -and some DSL may never be called so it can’t be done lazily.
+and some DSL may never be called so it can't be done lazily.Keg-only formulae are not in your PATH and are not seen by compilers if you build your own software outside of Homebrew. This way, we -don’t shadow software provided by macOS.
+don't shadow software provided by macOS. +keg_only :provided_by_macos
+
keg_only :versioned_formulae
+
keg_only "because I want it so"
@@ -12160,7 +12074,9 @@ Sometimes we accidentally install files outside prefix. Once we fix that, users will get a link conflict error. Overwrite those files with:
+link_overwrite "bin/foo", "lib/bar"
+
link_overwrite "share/man/man1/baz-*"
@@ -12270,7 +12186,6 @@ We generally prefer to depends_on a desired compiler and to
-explicitly use that compiler in a formula’s #install block,
+explicitly use that compiler in a formula's #install block,
rather than implicitly finding a suitable compiler with needs
.
External patches can be declared using resource-style blocks.
+patch do
url "https://example.com/example_patch.diff"
sha256 "c6bc3f48ce8e797854c4b865f6a8ff969867bbcaebd648ae6fd825683e59fef2"
@@ -12610,6 +12525,7 @@
A strip level of -p1
is assumed. It can be overridden using a symbol
argument:
+
patch :p0 do
url "https://example.com/example_patch.diff"
sha256 "c6bc3f48ce8e797854c4b865f6a8ff969867bbcaebd648ae6fd825683e59fef2"
@@ -12617,6 +12533,7 @@
Patches can be declared in stable and head blocks. This form is
preferred over using conditionals.
+
stable do
patch do
url "https://example.com/example_patch.diff"
@@ -12625,12 +12542,14 @@
end
Embedded (__END__
) patches are declared like so:
+
patch :DATA
patch :p0, :DATA
Patches can also be embedded by passing a string. This makes it possible
to provide multiple embedded patches while making only some of them
conditional.
+
patch :p0, "..."
@@ -12678,11 +12597,12 @@
- Defines whether the Formula’s bottle can be used on the given Homebrew
+
Defines whether the Formula's bottle can be used on the given Homebrew
installation.
For example, if the bottle requires the Xcode CLT to be installed a
Formula would declare:
+
pour_bottle? do
reason "The bottle needs the Xcode CLT to be installed."
satisfy { MacOS::CLT.installed? }
@@ -12692,6 +12612,7 @@
the Formula will be built from source and reason
will be printed.
Alternatively, a preset reason can be passed as a symbol:
+
pour_bottle? only_if: :clt_installed
@@ -12868,7 +12789,8 @@
Additional downloads can be defined as resources and accessed in the
install method. Resources can also be defined inside a stable or
-head block. This mechanism replaces ad-hoc “subformula” classes.
+head block. This mechanism replaces ad-hoc "subformula" classes.
+
resource "additional_files" do
url "https://example.com/additional-stuff.tar.gz"
sha256 "c6bc3f48ce8e797854c4b865f6a8ff969867bbcaebd648ae6fd825683e59fef2"
@@ -12980,8 +12902,11 @@
Sometimes the formula cleaner breaks things.
Preserve cleaned paths with:
+
skip_clean "bin/foo", "lib/bar"
+
Keep .la files with:
+
skip_clean :la
@@ -13033,7 +12958,6 @@
-
@@ -13258,7 +13182,7 @@
A test is required for new formulae and makes us happy.
The block will create, run in and delete a temporary directory.
-We want tests that don’t require any user input
+
We want tests that don't require any user input
and test the basic functionality of the application.
For example, foo build-foo input.foo
is a good test
and foo --version
or foo --help
are bad tests.
@@ -13270,6 +13194,7 @@
assert_equal "OK", shell_output("test_command test.file").strip
Need complete control over stdin, stdout?
+
require "open3"
Open3.popen3("#{bin}/example", "argument") do |stdin, stdout, _|
stdin.write("some text")
@@ -13422,7 +13347,6 @@
-
@@ -13475,7 +13399,6 @@
-
This method returns an undefined value.
-The directory where the formula’s Bash completion files should be +
The directory where the formula's Bash completion files should be
installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s binaries should be installed. +
The directory where the formula's binaries should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
Need to install into the #bin but the makefile doesn’t mkdir -p prefix/bin
?
Need to install into the #bin but the makefile doesn't mkdir -p prefix/bin
?
bin.mkpath
No make install
available?
bin.install "binary1"
@@ -14283,7 +14206,6 @@ Warn the user about any Homebrew-specific issues or quirks for this package. These should not contain setup instructions that would apply to installation through a different package manager on a different OS.
+def caveats
<<~EOS
Are optional. Something the user must be warned about?
@@ -15209,7 +15127,6 @@
-
This method returns an undefined value.
Replaces a universal binary with its native slice.
If called with no parameters, does this with all compatible -universal binaries in a Formula’s Keg.
+universal binaries in a Formula's Keg.The directory where the formula’s documentation should be installed. +
The directory where the formula's documentation should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
To install an Emacs mode included with a software package:
+elisp.install "contrib/emacs/example-mode.el"
@@ -17323,7 +17229,6 @@ The directory where the formula’s configuration files should be installed. +
The directory where the formula's configuration files should be installed.
Anything using etc.install
will not overwrite other files on e.g. upgrades
but will write a new file named *.default
.
This directory is not inside the HOMEBREW_CELLAR
so it persists
@@ -17471,7 +17376,6 @@
This method returns an undefined value.
-The directory where the formula’s fish completion files should be +
The directory where the formula's fish completion files should be
installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s fish function files should be +
The directory where the formula's fish function files should be
installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s Frameworks should be installed. +
The directory where the formula's Frameworks should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
This is not symlinked into HOMEBREW_PREFIX
.
This method returns an undefined value.
Generate shell completions for a formula for bash, zsh, and fish, using the formula’s executable.
+This method returns an undefined value.
Generate shell completions for a formula for bash, zsh, and fish, using the formula's executable.
The directory where the formula’s headers should be installed. +
The directory where the formula's headers should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
No make install
available?
include.install "example.h"
@@ -18573,7 +18473,7 @@ The directory where the formula’s info files should be installed. +
The directory where the formula's info files should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
This method returns an undefined value.
Sometimes we have to change a bit before we install. Mostly we
prefer a patch, but if you need the prefix of
this formula in the patch you have to resort to inreplace
,
-because in the patch you don’t have access to any variables
+because in the patch you don't have access to any variables
defined by the formula, as only HOMEBREW_PREFIX
is available
in the embedded patch.
inreplace
supports regular expressions:
inreplace "somefile.cfg", /look[for]what?/, "replace by #{bin}/tool"
inreplace
supports blocks:
inreplace "Makefile" do |s|
s.gsub! "/usr/local", HOMEBREW_PREFIX.to_s
end
@@ -18769,6 +18671,7 @@
installation instructions. The sources (from url) are downloaded,
hash-checked and then Homebrew changes into a temporary directory where the
archive is unpacked or repository cloned.
+
def install
system "./configure", "--prefix=#{prefix}"
system "make", "install"
@@ -18815,7 +18718,6 @@
This method returns an undefined value.
-
Has the target of the alias used to install this formula changed? -Returns false if the formula wasn’t installed with an alias.
+Returns false if the formula wasn't installed with an alias.Rarely, you don’t want your library symlinked into the main prefix. +
Rarely, you don't want your library symlinked into the main prefix.
See gettext.rb
for an example.
The directory where the formula’s kernel extensions should be installed. +
The directory where the formula's kernel extensions should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
This is not symlinked into HOMEBREW_PREFIX
.
The latest prefix for this formula. Checks for #head and then #stable’s #prefix
+The latest prefix for this formula. Checks for #head and then #stable's #prefix
The directory where the formula’s libraries should be installed. +
The directory where the formula's libraries should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
No make install
available?
lib.install "example.dylib"
@@ -19805,11 +19704,12 @@ The directory where the formula’s binaries should be installed. +
The directory where the formula's binaries should be installed.
This is not symlinked into HOMEBREW_PREFIX
.
It is commonly used to install files that we do not wish to be
symlinked into HOMEBREW_PREFIX
from one of the other directories and
instead manually create symlinks or wrapper scripts into e.g. #bin.
libexec.install "foo.jar"
bin.write_jar_script libexec/"foo.jar", "foo"
@@ -19970,7 +19870,6 @@ The directory where the formula’s installation or test logs will be written.
+The directory where the formula's installation or test logs will be written.
The root directory where the formula’s manual pages should be installed. +
The root directory where the formula's manual pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
Often one of the more specific man
functions should be used instead,
@@ -20794,11 +20691,12 @@
The directory where the formula’s man1 pages should be installed. +
The directory where the formula's man1 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
No make install
available?
man1.install "example.1"
@@ -20852,7 +20750,7 @@ The directory where the formula’s man2 pages should be installed. +
The directory where the formula's man2 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s man3 pages should be installed. +
The directory where the formula's man3 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
No make install
available?
man3.install "man.3"
@@ -20965,7 +20864,7 @@ The directory where the formula’s man4 pages should be installed. +
The directory where the formula's man4 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s man5 pages should be installed. +
The directory where the formula's man5 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s man6 pages should be installed. +
The directory where the formula's man6 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s man7 pages should be installed. +
The directory where the formula's man7 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s man8 pages should be installed. +
The directory where the formula's man8 pages should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
Returns a list of formulae depended on by this formula that aren’t +
Returns a list of formulae depended on by this formula that aren't installed.
@@ -21418,7 +21316,7 @@Create a temporary directory then yield. When the block returns,
recursively delete the temporary directory. Passing opts[:retain]
or calling do |staging| ... staging.retain!
in the block will skip
-the deletion and retain the temporary directory’s contents.
This is the preferred way to refer to a formula in plists or from another formula, as the path is stable even when the software is updated.
+args << "--with-readline=#{Formula["readline"].opt_prefix}" if build.with? "readline"
@@ -22554,7 +22448,6 @@ The directory where the formula’s shared files should be installed, +
The directory where the formula's shared files should be installed,
with the name of the formula appended to avoid linking conflicts.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
No make install
available?
pkgshare.install "examples"
@@ -23491,6 +23379,7 @@ Please use Homebrew::Service instead.
This method can be overridden to provide a plist.
+def plist; <<~EOS
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -23504,9 +23393,9 @@
<string>--do-this</string>
</array>
<key>RunAtLoad</key>
- <true />
+ <true/>
<key>KeepAlive</key>
- <true />
+ <true/>
<key>StandardErrorPath</key>
<string>/dev/null</string>
<key>StandardOutPath</key>
@@ -23628,7 +23517,6 @@
-
satisfy
method if it is specified.
+Replaced by pour_bottle?'s satisfy
method if it is specified.
The directory in the cellar that the formula is installed to. This directory points to #opt_prefix if it exists and if #prefix is not -called from within the same formula’s #install or #post_install methods. -Otherwise, return the full path to the formula’s versioned cellar.
+called from within the same formula's #install or #post_install methods. +Otherwise, return the full path to the formula's versioned cellar.If a formula’s linked keg points to the prefix.
+If a formula's linked keg points to the prefix.
The full set of Requirements for this formula’s dependency tree.
+The full set of Requirements for this formula's dependency tree.
A named Resource for the currently active SoftwareSpec. Additional downloads can be defined as #resources. Resource#stage will create a temporary directory and yield to a block.
+resource("additional_files").stage { bin.install "my/extra/tool" }
@@ -24641,7 +24525,6 @@ This method returns an undefined value.
-The directory where the formula’s sbin
binaries should be installed.
+
The directory where the formula's sbin
binaries should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
Generally we try to migrate these to #bin instead.
The directory where the formula’s shared files should be installed. +
The directory where the formula's shared files should be installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
Need a custom directory?
+(share/"concept").mkpath
Installing something into another custom directory?
+(share/"concept2").install "ducks.txt"
Install ./example_code/simple/ones
to share/demos
:
(share/"demos").install "example_code/simple/ones"
Install ./example_code/simple/ones
to share/demos/examples
:
(share/"demos").install "example_code/simple/ones" => "examples"
@@ -25590,9 +25472,9 @@ Shared library names according to platform conventions.
Optionally specify a version
to restrict the shared library to a specific
-version. The special string “*” matches any version.
If name
is specified as “*”, match any shared library of any version.
If name
is specified as "*", match any shared library of any version.
shared_library("foo") #=> foo.dylib
shared_library("foo", 1) #=> foo.1.dylib
@@ -25696,7 +25578,6 @@
-
Standard parameters for CMake builds.
-Setting CMAKE_FIND_FRAMEWORK
to “LAST” tells CMake to search for our
+
Setting CMAKE_FIND_FRAMEWORK
to "LAST" tells CMake to search for our
libraries before trying to utilize Frameworks, many of which will be from
3rd party installs.
This method returns an undefined value.
To call out to the system, we use the system
method and we prefer
you give the args separately as in the line below, otherwise a subshell
has to be opened first.
system "./bootstrap.sh", "--arg1", "--prefix=#{prefix}"
For CMake and other build systems we have some necessary defaults in e.g. #std_cmake_args:
+system "cmake", ".", *std_cmake_args
If the arguments given to configure
(or make
or cmake
) are depending
on options defined above, we usually make a list first and then
use the args << if <condition>
to append each:
args = ["--with-option1", "--with-option2"]
args << "--without-gcc" if ENV.compiler == :clang
@@ -27218,7 +27101,6 @@
-
This method returns an undefined value.
-The directory where the formula’s variable files should be installed. +
The directory where the formula's variable files should be installed.
This directory is not inside the HOMEBREW_CELLAR
so it persists
across upgrades.
This method returns an undefined value.
Runs xcodebuild
without Homebrew’s compiler environment variables set.
This method returns an undefined value.
Runs xcodebuild
without Homebrew's compiler environment variables set.
The directory where the formula’s zsh completion files should be +
The directory where the formula's zsh completion files should be
installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
The directory where the formula’s zsh function files should be +
The directory where the formula's zsh function files should be
installed.
This is symlinked into HOMEBREW_PREFIX
after installation or with
brew link
for formulae that are not keg-only.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Helper class for traversing a formula’s previous versions.
+Helper class for traversing a formula's previous versions.
ref
is a string containing:
when nil, will auto resolve the formula’s spec.
+when nil, will auto resolve the formula's spec.
The formula’s contents.
+The formula's contents.
The formula’s contents.
+The formula's contents.
The formula’s name.
+The formula's name.
The formula’s ruby file’s path or filename.
+The formula's ruby file's path or filename.
The formula’s tap (nil if it should be implicitly determined).
+The formula's tap (nil if it should be implicitly determined).
The formula’s name
+The formula's name
The formula’s ruby file’s path or filename
+The formula's ruby file's path or filename
The formula’s tap (nil if it should be implicitly determined)
+The formula's tap (nil if it should be implicitly determined)
This method returns an undefined value.
-Valid OCI tag characters -https://github.com/opencontainers/distribution-spec/blob/main/spec.md#workflow-categories
+https://github.com/opencontainers/distribution-spec/blob/main/spec.md#workflow-categoriesThis method returns an undefined value.
-This method returns an undefined value.
-Returns true if the repository’s current branch matches the default origin branch.
+Returns true if the repository's current branch matches the default origin branch.
Returns true if the repository’s current branch matches the default origin branch.
+Returns true if the repository's current branch matches the default origin branch.
Gets the relative date of the last commit, e.g. “1 hour ago”
+Gets the relative date of the last commit, e.g. "1 hour ago"
This method returns an undefined value.
-True when running under an Intel-based shell via Rosetta 2 on an
-Apple Silicon Mac. This can be detected via seeing if there’s a
+Apple Silicon Mac. This can be detected via seeing if there's a
conflict between what uname
reports and the underlying sysctl
flags,
-since the sysctl
flags don’t change behaviour under Rosetta 2.
sysctl
flags don't change behaviour under Rosetta 2.
These methods use info spewed out by sysctl. -Look in <mach/machine.h> for decoding info.
+Look inReturns a deep copy of hash.
-hash = { a: { b: ‘b’ } } +
hash = { a: { b: 'b' } } dup = hash.deep_dup - dup[:a][:c] = ‘c’
+ dup[:a][:c] = 'c'hash[:a][:c] # => nil - dup[:a][:c] # => “c”
+ dup[:a][:c] # => "c"Keep in sync with the Gemfile.lock
’s BUNDLED WITH.
+
Keep in sync with the Gemfile.lock
's BUNDLED WITH.
After updating this, run brew vendor-gems --update=--bundler
.
Helper functions for using Homebrew’s formulae.brew.sh API.
+Helper functions for using Homebrew's formulae.brew.sh API.
This method returns an undefined value.
-This method returns an undefined value.
-Subclass this to implement a brew
command. This is preferred to declaring a named function in the Homebrew
-module, because:
-- Each Command lives in an isolated namespace.
-- Each Command implements a defined interface.
-- args
is available as an ivar, and thus does not need to be passed as an argument to helper methods.
-- Subclasses no longer need to reference CLI::Parser
or parse args explicitly.
args
is available as an ivar, and thus does not need to be passed as an argument to helper methods.CLI::Parser
or parse args explicitly.To subclass, implement a run
method and provide a cmd_args
block to document the command and its allowed args.
To generate method signatures for command args, run brew typecheck --update
.
This method returns an undefined value.
-Verifies the given bottle against a cryptographic attestation of build provenance from homebrew-core’s CI, falling back on a “backfill” attestation for older bottles.
+Verifies the given bottle against a cryptographic attestation of build provenance from homebrew-core's CI, falling back on a "backfill" attestation for older bottles.
Verifies the given bottle against a cryptographic attestation of build provenance -from homebrew-core’s CI, falling back on a “backfill” attestation for older bottles.
+from homebrew-core's CI, falling back on a "backfill" attestation for older bottles.This is a specialization of check_attestation
for homebrew-core.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Finds files in HOMEBREW_PREFIX
and /usr/local.
-Specify paths relative to a prefix, e.g. “include/foo.h”.
+Specify paths relative to a prefix, e.g. "include/foo.h".
Sets @found for your convenience.
This method returns an undefined value.
-This method returns an undefined value.
-Identifies the latest version of the formula/cask and returns a Hash containing -the version information. Returns nil if a latest version couldn’t be found.
+the version information. Returns nil if a latest version couldn't be found.Identifies the latest version of a resource and returns a Hash containing the -version information. Returns nil if a latest version couldn’t be found.
+version information. Returns nil if a latest version couldn't be found.Homebrew::Livecheck::Strategy priorities informally range from 1 to 10, where 10 is the -highest priority. 5 is the default priority because it’s roughly in +highest priority. 5 is the default priority because it's roughly in the middle of this range. Strategies with a priority of 0 (or lower) are ignored.
@@ -158,9 +158,9 @@cURL’s default --connect-timeout
value can be up to two minutes, so
+
cURL's default --connect-timeout
value can be up to two minutes, so
we need to use a more reasonable duration (in seconds) to avoid a
-lengthy wait when a connection can’t be established.
example/1.2.3/example-1.2.3.tar.gz
example/example-1.2.3/example-1.2.3.tar.gz
example/example-1.2.3-bin.tar.gz
example/1.2.3/example-1.2.3.tar.gz
example/example-1.2.3/example-1.2.3.tar.gz
example/example-1.2.3-bin.tar.gz
This strategy also handles a few common mirror/backup URLs where the @@ -201,7 +201,7 @@
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Bitbucket.html b/docs/Homebrew/Livecheck/Strategy/Bitbucket.html index 1690f398c..f20ad863a 100644 --- a/docs/Homebrew/Livecheck/Strategy/Bitbucket.html +++ b/docs/Homebrew/Livecheck/Strategy/Bitbucket.html @@ -102,20 +102,20 @@The Bitbucket strategy identifies versions of software at -bitbucket.org by checking a repository’s available downloads.
+bitbucket.org by checking a repository's available downloads.Bitbucket URLs generally take one of the following formats:
https://bitbucket.org/example/example/get/1.2.3.tar.gz
https://bitbucket.org/example/example/downloads/example-1.2.3.tar.gz
https://bitbucket.org/example/example/get/1.2.3.tar.gz
https://bitbucket.org/example/example/downloads/example-1.2.3.tar.gz
The /get/
archive files are simply automated snapshots of the files
for a given tag. The /downloads/
archive files are files that have
been uploaded instead.
It’s also possible for an archive to come from a repository’s wiki, +
It's also possible for an archive to come from a repository's wiki,
like:
https://bitbucket.org/example/example/wiki/downloads/example-1.2.3.zip
.
This scenario is handled by this strategy as well and the path
in
@@ -200,7 +200,7 @@
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Cpan.html b/docs/Homebrew/Livecheck/Strategy/Cpan.html index 51f22c4e2..0f025c683 100644 --- a/docs/Homebrew/Livecheck/Strategy/Cpan.html +++ b/docs/Homebrew/Livecheck/Strategy/Cpan.html @@ -107,8 +107,8 @@CPAN URLs take the following formats:
https://cpan.metacpan.org/authors/id/H/HO/HOMEBREW/Brew-v1.2.3.tar.gz
https://cpan.metacpan.org/authors/id/H/HO/HOMEBREW/brew/brew-v1.2.3.tar.gz
https://cpan.metacpan.org/authors/id/H/HO/HOMEBREW/Brew-v1.2.3.tar.gz
https://cpan.metacpan.org/authors/id/H/HO/HOMEBREW/brew/brew-v1.2.3.tar.gz
In these examples, HOMEBREW
is the author name and the preceding H
@@ -135,7 +135,6 @@
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Crate.html b/docs/Homebrew/Livecheck/Strategy/Crate.html index 4057429a9..4fd7f7dcd 100644 --- a/docs/Homebrew/Livecheck/Strategy/Crate.html +++ b/docs/Homebrew/Livecheck/Strategy/Crate.html @@ -135,7 +135,7 @@The default regex used to identify versions when a regex isn’t +
The default regex used to identify versions when a regex isn't provided.
@@ -157,7 +157,7 @@The default strategy
block used to extract version information when
-a strategy
block isn’t provided.
strategy
block isn't provided.
The ElectronBuilder strategy fetches content at a URL and parses it as an electron-builder appcast in YAML format.
-This strategy is not applied automatically and it’s necessary to use +
This strategy is not applied automatically and it's necessary to use
strategy :electron_builder
in a livecheck
block to apply it.
.plist
files using UnversionedCaskChecker.
In practice, this strategy operates by downloading very large files, -so it’s both slow and data-intensive. As such, the ExtractPlist +so it's both slow and data-intensive. As such, the ExtractPlist strategy should only be used as an absolute last resort.
-This strategy is not applied automatically and it’s necessary to use +
This strategy is not applied automatically and it's necessary to use
strategy :extract_plist
in a livecheck
block to apply it.
This strategy does not have a default regex. Instead, it simply removes
any non-digit text from the start of tags and parses the rest as a
Version. This works for some simple situations but even one unusual
-tag can cause a bad result. It’s better to provide a regex in a
+tag can cause a bad result. It's better to provide a regex in a
livecheck
block, so livecheck
only matches what we really want.
The default regex used to naively identify versions from tags when a -regex isn’t provided.
+regex isn't provided.Fetches a remote Git repository’s tags using git ls-remote --tags
and parses the command’s output.
Fetches a remote Git repository's tags using git ls-remote --tags
and parses the command's output.
Checks the Git tags for new versions. When a regex isn’t provided, +
Checks the Git tags for new versions. When a regex isn't provided, this strategy simply removes non-digits from the start of tag strings and parses the remaining text as a Version.
@@ -547,9 +547,9 @@Fetches a remote Git repository’s tags using git ls-remote --tags
-and parses the command’s output. If a regex is provided, it will be
-used to filter out any tags that don’t match it.
Fetches a remote Git repository's tags using git ls-remote --tags
+and parses the command's output. If a regex is provided, it will be
+used to filter out any tags that don't match it.
The GithubLatest strategy identifies versions of software at -github.com by checking a repository’s “latest” release using the +github.com by checking a repository's "latest" release using the GitHub API.
GitHub URLs take a few different formats:
https://github.com/example/example/releases/download/1.2.3/example-1.2.3.tar.gz
https://github.com/example/example/archive/v1.2.3.tar.gz
https://github.com/downloads/example/example/example-1.2.3.tar.gz
https://github.com/example/example/releases/download/1.2.3/example-1.2.3.tar.gz
https://github.com/example/example/archive/v1.2.3.tar.gz
https://github.com/downloads/example/example/example-1.2.3.tar.gz
GithubLatest should only be used when the upstream repository has a
-“latest” release for a suitable version and the strategy is necessary
+"latest" release for a suitable version and the strategy is necessary
or appropriate (e.g. the formula/cask uses a release asset or the
Git strategy returns an unreleased version). The strategy can only
be applied by using strategy :github_latest
in a livecheck
block.
The default regex identifies versions like 1.2.3
/v1.2.3
in a
-release’s tag or title. This is a common tag format but a modified
+release's tag or title. This is a common tag format but a modified
regex can be provided in a livecheck
block to override the default
if a repository uses a different format (e.g. 1.2.3d
, 1.2.3-4
,
etc.).
Generates the GitHub API URL for the repository’s “latest” release and identifies the version from the JSON response.
+Generates the GitHub API URL for the repository's "latest" release and identifies the version from the JSON response.
Generates the GitHub API URL for the repository’s “latest” release +
Generates the GitHub API URL for the repository's "latest" release and identifies the version from the JSON response.
diff --git a/docs/Homebrew/Livecheck/Strategy/GithubReleases.html b/docs/Homebrew/Livecheck/Strategy/GithubReleases.html index bed1fbb4c..6f4578eb7 100644 --- a/docs/Homebrew/Livecheck/Strategy/GithubReleases.html +++ b/docs/Homebrew/Livecheck/Strategy/GithubReleases.html @@ -102,26 +102,26 @@The GithubReleases strategy identifies versions of software at -github.com by checking a repository’s recent releases using the +github.com by checking a repository's recent releases using the GitHub API.
GitHub URLs take a few different formats:
https://github.com/example/example/releases/download/1.2.3/example-1.2.3.tar.gz
https://github.com/example/example/archive/v1.2.3.tar.gz
https://github.com/downloads/example/example/example-1.2.3.tar.gz
https://github.com/example/example/releases/download/1.2.3/example-1.2.3.tar.gz
https://github.com/example/example/archive/v1.2.3.tar.gz
https://github.com/downloads/example/example/example-1.2.3.tar.gz
GithubReleases should only be used when the upstream repository has
releases for suitable versions and the strategy is necessary or
appropriate (e.g. the formula/cask uses a release asset and the
-GithubLatest strategy isn’t sufficient to identify the newest version.
+GithubLatest strategy isn't sufficient to identify the newest version.
The strategy can only be applied by using strategy :github_releases
in a livecheck
block.
The default regex identifies versions like 1.2.3
/v1.2.3
in each
-release’s tag or title. This is a common tag format but a modified
+release's tag or title. This is a common tag format but a modified
regex can be provided in a livecheck
block to override the default
if a repository uses a different format (e.g. 1.2.3d
, 1.2.3-4
,
etc.).
The default regex used to identify a version from a tag when a regex -isn’t provided.
+isn't provided.Generates the GitHub API URL for the repository’s recent releases and identifies versions from the JSON response.
+Generates the GitHub API URL for the repository's recent releases and identifies versions from the JSON response.
Generates the GitHub API URL for the repository’s recent releases +
Generates the GitHub API URL for the repository's recent releases and identifies versions from the JSON response.
diff --git a/docs/Homebrew/Livecheck/Strategy/Gnome.html b/docs/Homebrew/Livecheck/Strategy/Gnome.html index dcb5191d3..380041ab0 100644 --- a/docs/Homebrew/Livecheck/Strategy/Gnome.html +++ b/docs/Homebrew/Livecheck/Strategy/Gnome.html @@ -102,22 +102,22 @@The Gnome strategy identifies versions of software at gnome.org by
-checking the available downloads found in a project’s cache.json
+checking the available downloads found in a project's cache.json
file.
GNOME URLs generally follow a standard format:
https://download.gnome.org/sources/example/1.2/example-1.2.3.tar.xz
https://download.gnome.org/sources/example/1.2/example-1.2.3.tar.xz
Before version 40, GNOME used a version scheme where unstable releases
-were indicated with a minor that’s 90+ or odd. The newer version scheme
+were indicated with a minor that's 90+ or odd. The newer version scheme
uses trailing alpha/beta/rc text to identify unstable versions
(e.g. 40.alpha
).
When a regex isn’t provided in a livecheck
block, the strategy uses
-a default regex that matches versions which don’t include trailing text
+
When a regex isn't provided in a livecheck
block, the strategy uses
+a default regex that matches versions which don't include trailing text
after the numeric version (e.g. 40.0
instead of 40.alpha
) and it
selectively filters out unstable versions below 40 using the rules for
the older version scheme.
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Gnu.html b/docs/Homebrew/Livecheck/Strategy/Gnu.html index e057a0f32..f4ede34c3 100644 --- a/docs/Homebrew/Livecheck/Strategy/Gnu.html +++ b/docs/Homebrew/Livecheck/Strategy/Gnu.html @@ -107,28 +107,28 @@GNU URLs use a variety of formats:
https://ftp.gnu.org/gnu/example/example-1.2.3.tar.gz
https://ftp.gnu.org/gnu/example/1.2.3/example-1.2.3.tar.gz
https://www.gnu.org/software/example/
https://example.gnu.org
https://ftp.gnu.org/gnu/example/example-1.2.3.tar.gz
https://ftp.gnu.org/gnu/example/1.2.3/example-1.2.3.tar.gz
https://www.gnu.org/software/example/
https://example.gnu.org
There are other URL formats that this strategy currently doesn’t +
There are other URL formats that this strategy currently doesn't support:
https://ftp.gnu.org/non-gnu/example/source/feature/1.2.3/example-1.2.3.tar.gz
https://savannah.nongnu.org/download/example/example-1.2.3.tar.gz
https://download.savannah.gnu.org/releases/example/example-1.2.3.tar.gz
https://download.savannah.nongnu.org/releases/example/example-1.2.3.tar.gz
https://ftp.gnu.org/non-gnu/example/source/feature/1.2.3/example-1.2.3.tar.gz
https://savannah.nongnu.org/download/example/example-1.2.3.tar.gz
https://download.savannah.gnu.org/releases/example/example-1.2.3.tar.gz
https://download.savannah.nongnu.org/releases/example/example-1.2.3.tar.gz
The default regex identifies versions in archive files found in href
@@ -154,7 +154,6 @@
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Hackage.html b/docs/Homebrew/Livecheck/Strategy/Hackage.html index d297f78f6..f43cd827f 100644 --- a/docs/Homebrew/Livecheck/Strategy/Hackage.html +++ b/docs/Homebrew/Livecheck/Strategy/Hackage.html @@ -107,8 +107,8 @@Hackage URLs take one of the following formats:
https://hackage.haskell.org/package/example-1.2.3/example-1.2.3.tar.gz
https://downloads.haskell.org/~ghc/8.10.1/ghc-8.10.1-src.tar.xz
https://hackage.haskell.org/package/example-1.2.3/example-1.2.3.tar.gz
https://downloads.haskell.org/~ghc/8.10.1/ghc-8.10.1-src.tar.xz
The default regex checks for the latest version in an h3
heading element
@@ -227,7 +227,7 @@
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/HeaderMatch.html b/docs/Homebrew/Livecheck/Strategy/HeaderMatch.html index 2138c1baf..99bf1a616 100644 --- a/docs/Homebrew/Livecheck/Strategy/HeaderMatch.html +++ b/docs/Homebrew/Livecheck/Strategy/HeaderMatch.html @@ -109,7 +109,7 @@The HeaderMatch strategy follows all URL redirections and scans the resulting headers for matching text using the provided regex.
-This strategy is not applied automatically and it’s necessary to use +
This strategy is not applied automatically and it's necessary to use
strategy :header_match
in a livecheck
block to apply it.
The header fields to check when a strategy
block isn’t provided.
The header fields to check when a strategy
block isn't provided.
livecheck
block, it should be passed as the second argument to
the strategy
block.
-This is a generic strategy that doesn’t contain any logic for finding +
This is a generic strategy that doesn't contain any logic for finding
versions, as the structure of JSON data varies. Instead, a strategy
block must be used to extract version information from the JSON data.
strategy :json
in a livecheck
block (in conjunction with a
strategy
block) to use it.
-This strategy’s Json.find_versions method can be used in other strategies +
This strategy's Json.find_versions method can be used in other strategies that work with JSON content, so it should only be necessary to write the version-finding logic that works with the parsed JSON data.
@@ -138,7 +138,6 @@https://launchpad.net/example/1.2/1.2.3/+download/example-1.2.3.tar.gz
https://launchpad.net/example/trunk/1.2.3/+download/example-1.2.3.tar.gz
https://code.launchpad.net/example/1.2/1.2.3/+download/example-1.2.3.tar.gz
https://launchpad.net/example/1.2/1.2.3/+download/example-1.2.3.tar.gz
https://launchpad.net/example/trunk/1.2.3/+download/example-1.2.3.tar.gz
https://code.launchpad.net/example/1.2/1.2.3/+download/example-1.2.3.tar.gz
The default regex identifies the latest version within an HTML element @@ -167,7 +167,7 @@
The default regex used to identify the latest version when a regex -isn’t provided.
+isn't provided.Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Npm.html b/docs/Homebrew/Livecheck/Strategy/Npm.html index f0f5397f1..c951a43bf 100644 --- a/docs/Homebrew/Livecheck/Strategy/Npm.html +++ b/docs/Homebrew/Livecheck/Strategy/Npm.html @@ -107,12 +107,12 @@npm URLs take one of the following formats:
https://registry.npmjs.org/example/-/example-1.2.3.tgz
https://registry.npmjs.org/@example/example/-/example-1.2.3.tgz
https://registry.npmjs.org/example/-/example-1.2.3.tgz
https://registry.npmjs.org/@example/example/-/example-1.2.3.tgz
The default regex matches URLs in the href
attributes of version tags
-on the “Versions” tab of the package page.
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/PageMatch.html b/docs/Homebrew/Livecheck/Strategy/PageMatch.html index 710275697..acb7ede99 100644 --- a/docs/Homebrew/Livecheck/Strategy/PageMatch.html +++ b/docs/Homebrew/Livecheck/Strategy/PageMatch.html @@ -131,7 +131,6 @@/packages/
and the filename varies:
https://files.pythonhosted.org/packages/<hex>/<hex>/<long_hex>/example-1.2.3.tar.gz
https://files.pythonhosted.org/packages/<hex>/<hex>/<long_hex>/example-1.2.3.tar.gz
As such, the default regex only targets the filename at the end of the @@ -134,7 +134,6 @@
Generates a URL and regex (if one isn’t provided) and passes them to Homebrew::Livecheck::Strategy::PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to Homebrew::Livecheck::Strategy::PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to Homebrew::Livecheck::Strategy::PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Sourceforge.html b/docs/Homebrew/Livecheck/Strategy/Sourceforge.html index 4ba65bde5..26466dc0a 100644 --- a/docs/Homebrew/Livecheck/Strategy/Sourceforge.html +++ b/docs/Homebrew/Livecheck/Strategy/Sourceforge.html @@ -102,26 +102,26 @@The Sourceforge strategy identifies versions of software at -sourceforge.net by checking a project’s RSS feed.
+sourceforge.net by checking a project's RSS feed.SourceForge URLs take a few different formats:
https://downloads.sourceforge.net/project/example/example-1.2.3.tar.gz
https://svn.code.sf.net/p/example/code/trunk
:pserver:anonymous:@example.cvs.sourceforge.net:/cvsroot/example
https://downloads.sourceforge.net/project/example/example-1.2.3.tar.gz
https://svn.code.sf.net/p/example/code/trunk
:pserver:anonymous:@example.cvs.sourceforge.net:/cvsroot/example
The RSS feed for a project contains the most recent release archives and while this is fine for most projects, this approach has some shortcomings. Some project releases involve so many files that the one -we’re interested in isn’t present in the feed content. Some projects -contain additional software and the archive we’re interested in is -pushed out of the feed (especially if it hasn’t been updated recently).
+we're interested in isn't present in the feed content. Some projects +contain additional software and the archive we're interested in is +pushed out of the feed (especially if it hasn't been updated recently).Usually we address this situation by adding a livecheck
block to
the formula/cask that checks the page for the relevant directory in the
-project instead. In this situation, it’s necessary to use
+project instead. In this situation, it's necessary to use
strategy :page_match
to prevent the Sourceforge stratgy from
being used.
Generates a URL and regex (if one isn’t provided) and passes them to PageMatch.find_versions to identify versions in the content.
+Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
Generates a URL and regex (if one isn’t provided) and passes them +
Generates a URL and regex (if one isn't provided) and passes them to PageMatch.find_versions to identify versions in the content.
diff --git a/docs/Homebrew/Livecheck/Strategy/Sparkle.html b/docs/Homebrew/Livecheck/Strategy/Sparkle.html index 6381f9bb4..f8306ab71 100644 --- a/docs/Homebrew/Livecheck/Strategy/Sparkle.html +++ b/docs/Homebrew/Livecheck/Strategy/Sparkle.html @@ -109,7 +109,7 @@The Sparkle strategy fetches content at a URL and parses it as a Sparkle appcast in XML format.
-This strategy is not applied automatically and it’s necessary to use +
This strategy is not applied automatically and it's necessary to use
strategy :sparkle
in a livecheck
block to apply it.
Filters out items that aren’t suitable for Homebrew.
+Filters out items that aren't suitable for Homebrew.
Filters out items that aren’t suitable for Homebrew.
+Filters out items that aren't suitable for Homebrew.
livecheck
block, it should be passed
as the second argument to the strategy
block.
-This is a generic strategy that doesn’t contain any logic for finding +
This is a generic strategy that doesn't contain any logic for finding
versions, as the structure of XML data varies. Instead, a strategy
block must be used to extract version information from the XML data.
For more information on how to work with an REXML::Document
object,
@@ -118,7 +118,7 @@
strategy :xml
in a livecheck
block (in conjunction with a
strategy
block) to use it.
-This strategy’s Xml.find_versions method can be used in other strategies +
This strategy's Xml.find_versions method can be used in other strategies that work with XML content, so it should only be necessary to write the version-finding logic that works with the parsed XML data.
@@ -142,7 +142,6 @@Retrieves the stripped inner text of an REXML
element. Returns
-nil
if the optional child element doesn’t exist or the text is
+nil
if the optional child element doesn't exist or the text is
blank.
X.Org URLs take one of the following formats, among several others:
https://www.x.org/archive/individual/app/example-1.2.3.tar.bz2
https://www.x.org/archive/individual/font/example-1.2.3.tar.bz2
https://www.x.org/archive/individual/lib/libexample-1.2.3.tar.bz2
https://ftp.x.org/archive/individual/lib/libexample-1.2.3.tar.bz2
https://www.x.org/pub/individual/doc/example-1.2.3.tar.gz
https://www.x.org/archive/individual/app/example-1.2.3.tar.bz2
https://www.x.org/archive/individual/font/example-1.2.3.tar.bz2
https://www.x.org/archive/individual/lib/libexample-1.2.3.tar.bz2
https://ftp.x.org/archive/individual/lib/libexample-1.2.3.tar.bz2
https://www.x.org/pub/individual/doc/example-1.2.3.tar.gz
The notable differences between URLs are as follows:
www.x.org
and ftp.x.org
seem to be interchangeable (we prefer
+www.x.org
and ftp.x.org
seem to be interchangeable (we prefer
www.x.org
)./archive/
is the current top-level directory and /pub/
will
+/archive/
is the current top-level directory and /pub/
will
redirect to the same URL using /archive/
instead. (The strategy
handles this replacement to avoid the redirection.)/individual/
directory contains a number of directories (e.g.
+/individual/
directory contains a number of directories (e.g.
app, data, doc, driver, font, lib, etc.) which contain a number of
different archive files.Since this strategy ends up checking the same directory listing pages -for multiple formulae, we’ve included a simple method of page caching. +for multiple formulae, we've included a simple method of page caching. This prevents livecheck from fetching the same page more than once and also dramatically speeds up these checks. Eventually we hope to implement a more sophisticated page cache that all strategies using @@ -157,7 +157,6 @@
Generates a URL and regex (if one isn’t provided) and checks the content at the URL for new versions (using the regex for matching).
+Generates a URL and regex (if one isn't provided) and checks the content at the URL for new versions (using the regex for matching).
Generates a URL and regex (if one isn’t provided) and checks the +
Generates a URL and regex (if one isn't provided) and checks the content at the URL for new versions (using the regex for matching).
The behavior in this method for matching text in the content using a diff --git a/docs/Homebrew/Livecheck/Strategy/Yaml.html b/docs/Homebrew/Livecheck/Strategy/Yaml.html index acaecd794..b8665af73 100644 --- a/docs/Homebrew/Livecheck/Strategy/Yaml.html +++ b/docs/Homebrew/Livecheck/Strategy/Yaml.html @@ -106,7 +106,7 @@
livecheck
block, it should be passed as the second argument to
the strategy
block.
-This is a generic strategy that doesn’t contain any logic for finding +
This is a generic strategy that doesn't contain any logic for finding
versions, as the structure of YAML data varies. Instead, a strategy
block must be used to extract version information from the YAML data.
strategy :yaml
in a livecheck
block (in conjunction with a
strategy
block) to use it.
-This strategy’s Yaml.find_versions method can be used in other strategies +
This strategy's Yaml.find_versions method can be used in other strategies that work with YAML content, so it should only be necessary to write the version-finding logic that works with the parsed YAML data.
@@ -138,7 +138,6 @@Override that adds Homebrew metadata for the top level header and doesn’t escape the text inside subheaders.
+Override that adds Homebrew metadata for the top level header and doesn't escape the text inside subheaders.
Override that adds Homebrew metadata for the top level header -and doesn’t escape the text inside subheaders.
+and doesn't escape the text inside subheaders.HTML-like tags denote variables instead, except
.
HTML-like tags denote variables instead, except
.
The Service class implements the DSL methods used in a formula’s +
The Service class implements the DSL methods used in a formula's
service
block and stores related instance variables. Most of these methods
also return the related instance variable when no argument is provided.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Strategy for downloading a file using homebrew’s curl.
+Strategy for downloading a file using homebrew's curl.
If it doesn’t, it returns nil.
+If it doesn't, it returns nil.
Note that nil will be returned if the only installed dependents of the passed kegs are other kegs in the array or casks present in the casks parameter.
-For efficiency, we don’t bother trying to get complete data.
+For efficiency, we don't bother trying to get complete data.
These paths relative to the keg’s share directory should always be real +
These paths relative to the keg's share directory should always be real directories in the prefix, never symlinks.
@@ -391,7 +385,6 @@This method returns an undefined value.
-Calls the given block with the passed environment variables added to ENV, then restores ENV afterwards.
+with_env(PATH: "/bin") do
system "echo $PATH"
end
@@ -3312,7 +3264,6 @@ This method returns an undefined value.
Given a set of resources, stages them to a gopath for
building Go software.
The resource names should be the import name of the package,
-e.g. resource "github.com/foo/bar"
.
resource "github.com/foo/bar"
.
This method returns an undefined value.
-This method returns an undefined value.
-Returns true if a formula option for the specified python is currently active or if the specified python is required by the formula. Valid -inputs are “python”, “python2”, and :python3. Note that -“with-python”, “without-python”, “with-python@2”, and “without-python@2” +inputs are "python", "python2", and :python3. Note that +"with-python", "without-python", "with-python@2", and "without-python@2" formula options are handled correctly even if not associated with any corresponding depends_on statement.
@@ -322,7 +321,6 @@the path to the root of the virtualenv
-(often libexec/"venv"
)
libexec/"venv"
)
which interpreter to use (e.g. “python3” -or “python3.x”)
+which interpreter to use (e.g. "python3" +or "python3.x")
Helper method for the common case of installing a Python application.
Creates a virtualenv in libexec
, installs all resource
s defined
on the formula, and then installs the formula. An options hash may be
-passed (e.g. :using => "python"
) to override the default, guessed
-formula preference for python or python@x.y, or to resolve an ambiguous
-case where it’s not clear whether python or python@x.y should be the
+passed (e.g. :using => "python"
) to override the default, guessed
+formula preference for python or python@x.y, or to resolve an ambiguous
+case where it's not clear whether python or python@x.y should be the
default guess.
which interpreter to use, e.g. -“python” or “python2”
+"python" or "python2"Check for broken/missing linkage in a formula’s keg.
+Check for broken/missing linkage in a formula's keg.
The Livecheck class implements the DSL methods used in a formula’s, cask’s
-or resource’s livecheck
block and stores related instance variables. Most
+
The Livecheck class implements the DSL methods used in a formula's, cask's
+or resource's livecheck
block and stores related instance variables. Most
of these methods also return the related instance variable when no argument
is provided.
Sets the @skip
instance variable to true
and sets the @skip_msg
instance variable if a String
is provided. @skip
is used to indicate
that the formula/cask/resource should be skipped and the skip_msg
very
-briefly describes why it is skipped (e.g. “No longer developed or
-maintained”).
Path to newname keg that will be linked if old_linked_keg isn’t nil.
+Path to newname keg that will be linked if old_linked_keg isn't nil.
Path to oldname’s cellar.
+Path to oldname's cellar.
Path to newname keg that will be linked if old_linked_keg isn’t nil.
+Path to newname keg that will be linked if old_linked_keg isn't nil.
Path to oldname’s cellar.
+Path to oldname's cellar.
Error for when the old name’s path does not exist.
+Error for when the old name's path does not exist.
Raised when a single patch file is not found and apply hasn’t been specified.
+Raised when a single patch file is not found and apply hasn't been specified.
Performs Formula#mktemp’s functionality, and tracks the results. +
Performs Formula#mktemp's functionality, and tracks the results. Each instance is only intended to be used once.
@@ -295,8 +295,7 @@Returns a copy of module or class if it’s anonymous.
+Returns a copy of module or class if it's anonymous.
Returns a copy of module or class if it’s anonymous. If it’s +
Returns a copy of module or class if it's anonymous. If it's named, returns +self+.
Object.deep_dup == Object # => true diff --git a/docs/NilClass.html b/docs/NilClass.html index ba32422cc..3104f426a 100644 --- a/docs/NilClass.html +++ b/docs/NilClass.html @@ -152,8 +152,7 @@
Raised when a keg doesn’t exist.
+Raised when a keg doesn't exist.
https://packages.ubuntu.com/jammy/gcc
+This method returns an undefined value.
-See these issues for some history:
If a specific SDK is requested:
If no specific SDK is requested, the SDK matching the OS version is returned, @@ -1684,7 +1654,6 @@
Returns a Pathname object corresponding to Xcode.app’s Developer directory or nil if Xcode.app is not installed.
+Returns a Pathname object corresponding to Xcode.app's Developer directory or nil if Xcode.app is not installed.
Returns a Pathname object corresponding to Xcode.app’s Developer +
Returns a Pathname object corresponding to Xcode.app's Developer directory or nil if Xcode.app is not installed.
@@ -1698,7 +1668,6 @@– -Most objects are cloneable, but not all. For example you can’t dup methods:
+-- +Most objects are cloneable, but not all. For example you can't dup methods:
method(:puts).dup # => TypeError: allocator undefined for Method
@@ -120,7 +120,7 @@That’s why we hardcode the following cases and check duplicable? instead of +
That's why we hardcode the following cases and check duplicable? instead of using that rescue idiom. ++
@@ -161,7 +161,7 @@An object is blank if it’s false, empty, or a whitespace string.
+An object is blank if it's false, empty, or a whitespace string.
Returns a deep copy of object if it’s duplicable.
+Returns a deep copy of object if it's duplicable.
Returns the receiver if it’s present otherwise returns +nil+.
+Returns the receiver if it's present otherwise returns +nil+.
An object is present if it’s not blank.
+An object is present if it's not blank.
An object is blank if it’s false, empty, or a whitespace string. -For example, +nil+, ‘’, ‘ ‘, [], {}, and +false+ are all blank.
+An object is blank if it's false, empty, or a whitespace string. +For example, +nil+, '', ' ', [], {}, and +false+ are all blank.
This simplifies
-!address | -- | address.empty? | -
!address || address.empty?
to
@@ -377,7 +369,7 @@Returns a deep copy of object if it’s duplicable. If it’s +
Returns a deep copy of object if it's duplicable. If it's not duplicable, returns +self+.
object = Object.new @@ -500,7 +492,7 @@
Returns the receiver if it’s present otherwise returns +nil+. +
Returns the receiver if it's present otherwise returns +nil+. object.presence is equivalent to
object.present? ? object : nil
@@ -509,21 +501,11 @@state = params[:state] if params[:state].present? country = params[:country] if params[:country].present? - region = state || country || ‘US’
+ region = state || country || 'US'becomes
-region = params[:state].presence | -- | params[:country].presence | -- | ‘US’ | -
region = params[:state].presence || params[:country].presence || 'US'
An object is present if it’s not blank.
+An object is present if it's not blank.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Moves a file from the original location to the Pathname’s.
+Moves a file from the original location to the Pathname's.
I don’t trust the children.length == 0 check particularly, not to mention it is slow to enumerate the whole directory just to see if it is empty, instead rely on good ol’ libc and the filesystem.
+I don't trust the children.length == 0 check particularly, not to mention it is slow to enumerate the whole directory just to see if it is empty, instead rely on good ol' libc and the filesystem.
This method returns an undefined value.
-I don’t trust the children.length == 0 check particularly, not to mention +
I don't trust the children.length == 0 check particularly, not to mention it is slow to enumerate the whole directory just to see if it is empty, -instead rely on good ol’ libc and the filesystem
+instead rely on good ol' libc and the filesystemThis method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This cop checks that a cask’s homepage ends with a slash +
This cop checks that a cask's homepage ends with a slash if it does not have a path component.
@@ -146,7 +146,6 @@This method returns an undefined value.
-This cop checks that a cask’s stanzas are grouped correctly, including nested within on_*
blocks.
This cop checks that a cask's stanzas are grouped correctly, including nested within on_*
blocks.
This cop checks that a cask’s stanzas are ordered correctly, including nested within on_*
blocks.
This cop checks that a cask's stanzas are ordered correctly, including nested within on_*
blocks.
This cop checks for the correct order of methods within the ‘uninstall’ and ‘zap’ stanzas.
+This cop checks for the correct order of methods within the 'uninstall' and 'zap' stanzas.
This method returns an undefined value.
-This method returns an undefined value.
-This cop checks that a cask’s url
stanza is formatted correctly.
This cop checks that a cask's url
stanza is formatted correctly.
This cop makes sure that caveats don’t recommend unsupported or unsafe operations.
+This cop makes sure that caveats don't recommend unsupported or unsafe operations.
Returns precedence index and component’s index to properly reorder and group during autocorrect.
+Returns precedence index and component's index to properly reorder and group during autocorrect.
Returns precedence index and component’s index to properly reorder and group during autocorrect.
+Returns precedence index and component's index to properly reorder and group during autocorrect.
This cop checks if redundant components are present and for other component errors.
url|checksum|mirror|version
should be inside stable
blockhead
and head do
should not be simultaneously presentbottle :unneeded
/:disable
and bottle do
should not be simultaneously presentstable do
should not be present without a head
specstable do
should not be present with only url|checksum|mirror|version
head do
should not be present with only url
url|checksum|mirror|version
should be inside stable
blockhead
and head do
should not be simultaneously presentbottle :unneeded
/:disable
and bottle do
should not be simultaneously presentstable do
should not be present without a head
specstable do
should not be present with only url|checksum|mirror|version
head do
should not be present with only url
depends_on :apple if build.with? "foo"
should always be defined after depends_on :foo
.
depends_on :apple if build.with? "foo"
should always be defined after depends_on :foo
.
depends_on :apple if build.with? "foo"
should always be defined
+
depends_on :apple if build.with? "foo"
should always be defined
after depends_on :foo
.
This method reorders the dependencies array according to the above rule.
This cop makes sure that a formula’s file permissions are correct.
+This cop makes sure that a formula's file permissions are correct.
This cop ensures that the pattern provided to livecheck’s regex
uses \.t
instead of
+
This cop ensures that the pattern provided to livecheck's regex
uses \.t
instead of
\.tgz
, \.tar.gz
and variants.
This cop ensures that a supported symbol (head
, stable,
homepage)
-is used when the livecheck
url` is identical to one of these formula URLs.
This cop ensures that a supported symbol (head
, stable,
homepage)
+is used when the livecheck
url` is identical to one of these formula URLs.
These formulae aren’t keg_only :provided_by_macos
but are provided by
+
These formulae aren't keg_only :provided_by_macos
but are provided by
macOS (or very similarly, e.g. OpenSSL where system provides LibreSSL).
Check whether value starts with the formula name and then a “/”, “ “ or EOS.
+Check whether value starts with the formula name and then a "/", " " or EOS.
Check whether value starts with the formula name and then a “/”, “ “ or EOS.
+Check whether value starts with the formula name and then a "/", " " or EOS.
Return all the caveats’ string nodes in an array.
+Return all the caveats' string nodes in an array.
This method returns an undefined value.
-Return all the caveats’ string nodes in an array.
+Return all the caveats' string nodes in an array.
dependency’s name
+dependency's name
Returns the class node’s name, or nil if not a class node.
+Returns the class node's name, or nil if not a class node.
Returns the begin position of the node’s line in source code.
+Returns the begin position of the node's line in source code.
Returns the class node’s name, or nil if not a class node.
+Returns the class node's name, or nil if not a class node.
Returns array of function call nodes matching func_name in every descendant of node.
foo(*args, **kwargs)
foo.bar(*args, **kwargs)
foo(*args, **kwargs)
foo.bar(*args, **kwargs)
Returns the begin position of the node’s line in source code.
+Returns the begin position of the node's line in source code.
https://github.com/ruby/ruby/blob/v2_6_3/process.c#L2430-L2460
+https://github.com/ruby/ruby/blob/v2_6_3/process.c#L2430-L2460
https://github.com/ruby/ruby/blob/v2_6_3/process.c#L2495
+https://github.com/ruby/ruby/blob/v2_6_3/process.c#L2495
diff --git a/docs/RuboCop/Cop/Homebrew/Blank.html b/docs/RuboCop/Cop/Homebrew/Blank.html index 1cab8ebd4..8d1842476 100644 --- a/docs/RuboCop/Cop/Homebrew/Blank.html +++ b/docs/RuboCop/Cop/Homebrew/Blank.html @@ -144,7 +144,6 @@This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Outputs the current compiler.
+# Do something only for the system clang
if ENV.compiler == :clang
# modify CFLAGS CXXFLAGS OBJCFLAGS OBJCXXFLAGS in one go:
@@ -1244,7 +1215,6 @@
-
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
Prepends a directory to PATH
.
Is the formula struggling to find the pkgconfig file? Point it to it.
This is done automatically for keg-only formulae.
ENV.prepend_path "PKG_CONFIG_PATH", "#{Formula["glib"].opt_lib}/pkgconfig"
+
Prepending a system path such as /usr/bin is a no-op so that requirements
-don’t accidentally override superenv shims or formulae’s bin
directories.
bin
directories.
+
ENV.prepend_path "PATH", which("emacs").dirname
@@ -2246,7 +2206,6 @@ This method returns an undefined value.
-This method returns an undefined value.
-Singleton instances are not duplicable:
-Class.new.include(Singleton).instance.dup # TypeError (can’t dup instance of singleton
+Class.new.include(Singleton).instance.dup # TypeError (can't dup instance of singleton
This method returns an undefined value.
-Some configure scripts won’t find libxml2 without help.
+Some configure scripts won't find libxml2 without help.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Some configure scripts won’t find libxml2 without help. +
Some configure scripts won't find libxml2 without help. This is a no-op with macOS SDK 10.15.4 and later.
@@ -852,7 +837,6 @@This method returns an undefined value.
-A string is blank if it’s empty or contains whitespaces only:.
+A string is blank if it's empty or contains whitespaces only:.
A string is blank if it’s empty or contains whitespaces only:
+A string is blank if it's empty or contains whitespaces only:
-’‘.blank? # => true - ‘ ‘.blank? # => true - “\t\n\r”.blank? # => true - ‘ blah ‘.blank? # => false
+''.blank? # => true + ' '.blank? # => true + "\t\n\r".blank? # => true + ' blah '.blank? # => false
Unicode whitespace is supported:
-“\u00a0”.blank? # => true
+"\u00a0".blank? # => true
The inverse of String#include?. Returns true if the string does not include the other string.
-“hello”.exclude? “lo” # => false - “hello”.exclude? “ol” # => true - “hello”.exclude? ?h # => false
+"hello".exclude? "lo" # => false + "hello".exclude? "ol" # => true + "hello".exclude? ?h # => false
Looks for Makefile style variable definitions and replaces the value with “new_value”, or removes the definition entirely.
+Looks for Makefile style variable definitions and replaces the value with "new_value", or removes the definition entirely.
This method returns an undefined value.
Looks for Makefile style variable definitions and replaces the -value with “new_value”, or removes the definition entirely.
+value with "new_value", or removes the definition entirely.superenv
?The location of Homebrew’s shims.
+The location of Homebrew's shims.
This method returns an undefined value.
-The location of Homebrew’s shims.
+The location of Homebrew's shims.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Returns a Tab for the named formula’s installation, or a fake one if the formula is not installed.
+Returns a Tab for the named formula's installation, or a fake one if the formula is not installed.
Returns a Tab for the named formula’s installation, +
Returns a Tab for the named formula's installation, or a fake one if the formula is not installed.
@@ -2946,7 +2882,6 @@A Tap is used to extend the formulae provided by Homebrew core.
-Usually, it’s synced with a remote Git repository. And it’s likely
+Usually, it's synced with a remote Git repository. And it's likely
a GitHub repository with the name of user/homebrew-repo
. In such
cases, user/repo
will be used as the #name of this Tap, where
#user represents the GitHub username and #repo represents the repository
@@ -159,7 +159,6 @@
The full name of this Tap, including the homebrew-
prefix.
-It combines #user and ‘homebrew-‘-prefixed #repo with a slash.
+It combines #user and 'homebrew-'-prefixed #repo with a slash.
e.g. user/homebrew-repo
Check whether the given path would present a Cask file in this Tap. -Accepts either an absolute path or a path relative to this Tap’s path.
+Accepts either an absolute path or a path relative to this Tap's path.This method returns an undefined value.
-Check whether the given path would present a Formula file in this Tap. -Accepts either an absolute path or a path relative to this Tap’s path.
+Accepts either an absolute path or a path relative to this Tap's path.If set, change the tap’s remote if already installed.
+If set, change the tap's remote if already installed.
This method returns an undefined value.
-This method returns an undefined value.
-Raised when a tap’s remote does not match the actual remote.
+Raised when a tap's remote does not match the actual remote.
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-A dependency that’s marked as “installed” on macOS
+A dependency that's marked as "installed" on macOS
Removes the rightmost segment from the constant expression in the string.
-deconstantize(‘Net::HTTP’) # => “Net” - deconstantize(‘::Net::HTTP’) # => “::Net” - deconstantize(‘String’) # => “” - deconstantize(‘::String’) # => “” - deconstantize(‘’) # => “”
+deconstantize('Net::HTTP') # => "Net" + deconstantize('::Net::HTTP') # => "::Net" + deconstantize('String') # => "" + deconstantize('::String') # => "" + deconstantize('') # => ""
See also #demodulize.
@@ -638,10 +627,10 @@Removes the module part from the expression in the string.
-demodulize(‘ActiveSupport::Inflector::Inflections’) # => “Inflections” - demodulize(‘Inflections’) # => “Inflections” - demodulize(‘::Inflections’) # => “Inflections” - demodulize(‘’) # => “”
+demodulize('ActiveSupport::Inflector::Inflections') # => "Inflections" + demodulize('Inflections') # => "Inflections" + demodulize('::Inflections') # => "Inflections" + demodulize('') # => ""
See also #deconstantize.
@@ -1128,7 +1117,6 @@Makes an underscored, lowercase form from the expression in the string.
-Changes ‘::’ to ‘/’ to convert namespaces to paths.
+Changes '::' to '/' to convert namespaces to paths.
-underscore(‘ActiveModel’) # => “active_model” - underscore(‘ActiveModel::Errors’) # => “active_model/errors”
+underscore('ActiveModel') # => "active_model" + underscore('ActiveModel::Errors') # => "active_model/errors"
This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-remove os_version starting with “ or number remove macOS patch release.
+remove os_version starting with " or number remove macOS patch release.
remove os_version starting with “ or number +
remove os_version starting with " or number remove macOS patch release
@@ -1043,7 +1013,6 @@This method returns an undefined value.
-This method is undocumented because it is not intended for general use. -It relies on screen scraping some GitHub HTML that’s not available as an API. +It relies on screen scraping some GitHub HTML that's not available as an API. This seems very likely to break in the future. -That said, it’s the only way to get the data we want right now.
+That said, it's the only way to get the data we want right now.This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-Cleans sorbet-runtime
gem paths from the backtrace unless…
Cleans sorbet-runtime
gem paths from the backtrace unless...
Cleans sorbet-runtime
gem paths from the backtrace unless…
-1. verbose
is set
-2. first backtrace line starts with sorbet-runtime
- - This implies that the error is related to Sorbet.
Cleans sorbet-runtime
gem paths from the backtrace unless...
verbose
is setsorbet-runtime
+
+This method returns an undefined value.
-This method returns an undefined value.
-This method returns an undefined value.
-The maximum number of iterations for the
while
loop that parses HTTP response text. This should correspond to
-the maximum number of requests in the output. If curl
’s --max-redirs
+the maximum number of requests in the output. If curl
's --max-redirs
option is used, max_iterations
should be max-redirs + 1
, to
account for any final response after the redirections.
This method returns an undefined value.
Sometimes we have to change a bit before we install. Mostly we
prefer a patch, but if you need the prefix of
this formula in the patch you have to resort to inreplace
,
-because in the patch you don’t have access to any variables
+because in the patch you don't have access to any variables
defined by the formula, as only HOMEBREW_PREFIX
is available
in the embedded patch.
Take a path and heuristically convert it to a shell name, return nil
if there’s no match.
Take a path and heuristically convert it to a shell name, return nil
if there's no match.
Return the shell profile file based on user’s preferred shell.
+Return the shell profile file based on user's preferred shell.
Take a path and heuristically convert it to a shell name,
-return nil
if there’s no match.
nil
if there's no match.
Return the shell profile file based on user’s preferred shell.
+Return the shell profile file based on user's preferred shell.
For alias eql? ==
See discussions: - https://github.com/sorbet/sorbet/pull/1443 - https://github.com/sorbet/sorbet/issues/2378.
For alias eql? ==
See discussions: - https://github.com/sorbet/sorbet/pull/1443 - https://github.com/sorbet/sorbet/issues/2378.
For alias eql? ==
-See discussions:
- - https://github.com/sorbet/sorbet/pull/1443
- - https://github.com/sorbet/sorbet/issues/2378
This is the API for Homebrew.
-The main class you should look at is the Formula class (and classes linked from there). That’s the class that’s used to create Homebrew formulae (i.e. package descriptions). Assume anything else you stumble upon is private.
+The main class you should look at is the Formula class (and classes linked from there). That's the class that's used to create Homebrew formulae (i.e. package descriptions). Assume anything else you stumble upon is private.
You may also find the Formula Cookbook and Ruby Style Guide helpful in creating formulae.
diff --git a/docs/index.html b/docs/index.html index dc055afde..0575781d6 100644 --- a/docs/index.html +++ b/docs/index.html @@ -61,7 +61,7 @@This is the API for Homebrew.
-The main class you should look at is the Formula class (and classes linked from there). That’s the class that’s used to create Homebrew formulae (i.e. package descriptions). Assume anything else you stumble upon is private.
+The main class you should look at is the Formula class (and classes linked from there). That's the class that's used to create Homebrew formulae (i.e. package descriptions). Assume anything else you stumble upon is private.
You may also find the Formula Cookbook and Ruby Style Guide helpful in creating formulae.
diff --git a/docs/top-level-namespace.html b/docs/top-level-namespace.html index 026532a6d..3b855e6d8 100644 --- a/docs/top-level-namespace.html +++ b/docs/top-level-namespace.html @@ -149,7 +149,6 @@Apple’s gzip also uses zlib so use the same buffer size here. -https://github.com/apple-oss-distributions/file_cmds/blob/file_cmds-400/gzip/gzip.c#L147
+Apple's gzip also uses zlib so use the same buffer size here. +https://github.com/apple-oss-distributions/file_cmds/blob/file_cmds-400/gzip/gzip.c#L147
Match taps’ formulae, e.g. someuser/sometap/someformula
.
Match taps' formulae, e.g. someuser/sometap/someformula
.
Match default formula taps’ formulae, e.g. homebrew/core/someformula
or someformula
.
Match default formula taps' formulae, e.g. homebrew/core/someformula
or someformula
.
Match taps’ casks, e.g. someuser/sometap/somecask
.
Match taps' casks, e.g. someuser/sometap/somecask
.
Match default cask taps’ casks, e.g. homebrew/cask/somecask
or somecask
.
Match default cask taps' casks, e.g. homebrew/cask/somecask
or somecask
.
Match taps’ directory paths, e.g. HOMEBREW_LIBRARY/Taps/someuser/sometap
.
Match taps' directory paths, e.g. HOMEBREW_LIBRARY/Taps/someuser/sometap
.
Match taps’ formula paths, e.g. HOMEBREW_LIBRARY/Taps/someuser/sometap/someformula
.
Match taps' formula paths, e.g. HOMEBREW_LIBRARY/Taps/someuser/sometap/someformula
.
Match official taps’ casks, e.g. homebrew/cask/somecask
or homebrew/cask-versions/somecask
.
Match official taps' casks, e.g. homebrew/cask/somecask
or homebrew/cask-versions/somecask
.