From c978f0349e666f136e36489853beab17c645365f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?V=C3=ADtor=20Galv=C3=A3o?= Date: Tue, 18 Oct 2016 16:04:14 +0100 Subject: [PATCH] token_reference: conflicts with formulae (#25603) * token_reference: conflicts with formulae * Update token_reference.md --- doc/cask_language_reference/token_reference.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/cask_language_reference/token_reference.md b/doc/cask_language_reference/token_reference.md index 4f28c9a6b34..17c0cf1ac51 100644 --- a/doc/cask_language_reference/token_reference.md +++ b/doc/cask_language_reference/token_reference.md @@ -122,6 +122,12 @@ App Name on Disk | Simplified App Name | Cask Token | Filename # Token Overlap +## With another Cask + When the token for a new Cask would otherwise conflict with the token of an already existing Cask, the nature of that overlap dictates the token (for possibly both Casks). See [Finding a Home For Your Cask](../development/adding_a_cask.md#finding-a-home-for-your-cask) for information on how to proceed. +## With a formula + +If a Homebrew formula and a Homebrew-Cask cask both exist with the same token and they both refer to the same app — respectively a CLI a GUI — and the GUI app is simply a wrapper of the CLI tool but has been decided to provide enough value to warrant the inclusion of both the formula and the cask, the cask will have the `-app` suffix. This is the only instance where an `-app` suffix is allowed, precisely so the “why” is clear if you know the rule. + # <3 THANK YOU TO ALL CONTRIBUTORS! <3