Commit Graph

68 Commits

Author SHA1 Message Date
Joshua McKinney ff81663f56 Add --require-sha option for Issue #18831 2016-06-26 02:05:25 -04:00
Vítor Galvão 44a3a70aee USAGE.md: fix uses of /opt (#21879) 2016-06-12 12:07:20 +01:00
Vítor Galvão 8275276493 Linked → moved (#21597)
* docs: chrome real staged output

* usage: fixed linked to moved

* all_stanzas doc: fixed linked to moved

* man page: fixed linked to moved
2016-06-01 17:31:35 -04:00
Vítor Galvão 5a20c679ff usage.md: corrected to moving behaviour (#21567) 2016-05-31 20:49:19 +01:00
Matt Wean 47383169de [WIP] Change artifact behavior to moving instead of symlinking (#13966)
* Change app artifact to move instead of link

First step towards change in installation behavior mentioned in [13201]

* Fix handling of binaries linked from inside of app bundles

Also adds `appdir` method for interpolation in stanzas

* Change appdir to root Applications directory

* Update 2-app tests

* Refactor: add options, ivars to `Installer`, `Download`

In preparation for upcoming changes, this commit cleans up some code. The commit includes:

- In order to reduce unnecessary object passing, make both the `force` and `skip_cask_deps` option into instance variables of the `Installer` class

- Introduce options hashes to initializers of both the `Installer` and `Download` class

- When the `install --force` command enters the fetch phase, make it explicit in the code that fetching is never enforced in that case.

- Update tests

* Force overwrite artifacts on `--force` reinstall

This commit changes the behavior of a `Moved` artifact such that if the target already exists, `brew cask install --force` will remove the existing target before moving the staged artifact.

In that case, the warning message will say *overwriting* instead of *not moving*.

The behavior of plain `brew cask install` remains unchanged; the same goes for the warning message for that case.

* Change remaining artifacts to move instead of symlink

* Update casks to use appdir in binary paths

* Forcibly overwrite artifacts, modifying flags and using `sudo` if needed

- This commit implements [the proposed behavior for `install --force`](https://github.com/caskroom/homebrew-cask/pull/13966#issuecomment-220830387) when a target already exists and has either permission problems or is not owned by the user.

- The changes apply only when the `force` option is given.

- Reused the existing safeguard from the `.pkg` artifact to prevent deleting important directories by bug or mistake

- The two existing blacklists `SYSTEM_DIRS` and `UNDELETABLE_DIRS` have been consolidated into the `Hbc::MacOS` module.

- `UNDELETABLE_DIRS` now also contains all the entries from `SYSTEM_DIRS` which was a to-do anyway.

- The two blacklists are now also frozen for good measure.

- The utility method `permissions_rmtree` was moved to `Hbc::Utils`.

- The `tried_permissions` part in `Utils` now falls back correctly when there are also ownership issues at the same time.

- Introduced a separate `current_user` method for mocking.

- Added an optional feature to `FakeSystemCommand` so it can now act as a proxy to `SystemCommand`.

- Added tests for various `permissions_rmtree` cases.
2016-05-31 15:23:21 -04:00
Jared Koontz c57987f87d Update USAGE.md
Make it so a user can simply copy and paste the command. If the ticks are in there the command will not run
2016-03-23 16:58:07 -06:00
Vítor Galvão a5c217bb41 fix ied typo 2016-02-20 15:55:39 +00:00
Vítor Galvão a7c759a477 usage: fix indent in repos 2016-02-20 15:51:49 +00:00
Vítor Galvão afca535298 usage: add caskroom/eid 2016-02-20 15:50:26 +00:00
Tommy Sparber 438de2c7f8 Fix many URLs in the documentation 2016-01-23 16:27:08 +11:00
miccal 9d3cb33b0a Update USAGE.md 2016-01-11 14:21:09 +00:00
Amory Meltzer cc589ca799 Attempt clearer language for fetch and resources 2016-01-05 10:44:53 -08:00
Amory Meltzer e766cba9d6 Update links/paths in manpage, hacking.md, usage.md to reflect structure of brew-cask
- Old github.com links were invalid
- Old Cellar structure was invalid
- Man page regenerated, including content from #15643

Refs #15381
2015-12-20 15:11:00 -05:00
Francis T. O'Donovan bdedf7c51a Update USAGE.md to remove brew-cask install #15381 2015-12-11 13:08:47 -05:00
Josh Hagins c65720470c Remove extra space in update command
I assume this is the more commonly used form. I've never seen anyone space out
their semicolons like `foo ; bar`.
2015-12-10 11:19:38 -05:00
Vítor Galvão 5e79596ef7 long update command now uses ';' instead of '&&' 2015-12-09 17:18:46 -05:00
Vítor Galvão 4caa121d9f usage: add '$' to completion commands 2015-10-23 17:39:01 +01:00
Xie Yanbo b5ccc39b17 tab completion usage 2015-10-23 17:37:38 +01:00
Vítor Galvão cf23b6b1e3 USAGE.md: general structure fixes 2015-09-18 01:48:56 +01:00
Vítor Galvão c7b5b47b88 USAGE.md: removed double spacing 2015-09-18 01:48:55 +01:00
Vítor Galvão fd6b163aa1 usage: typographical fixes 2015-09-08 01:29:32 +01:00
Vítor Galvão bcdb0e6d13 usage.md: warning on --caskroom
Closes #10009.
2015-03-17 17:16:07 +01:00
Vítor Galvão 078f0b0300 removed alfred support 2015-01-13 17:49:32 +00:00
Vítor Galvão 529bd801e4 Removed support for widgets
Closes #2206.
2015-01-08 19:51:15 +00:00
Roland Walker 8f2a2b42d6 doc: update Alfred Integration in USAGE.md
* fix transposed line
* recast first-person phrasing
* better explain what a "scope" is
* better explain what the "Caskroom" is

fixes #7759
fixes #6059
2014-12-04 15:14:27 -05:00
Roland Walker 6736f795f6 uncapitalize several doc files
* `alternate_cask_taps.md`
* `automation.md`
* `hacking.md`
* `releasing.md`
2014-12-02 12:20:13 -05:00
Roland Walker a335d3b06d unify and recast "Cask name" & "title" as "token"
* "Canonical App Name" becomes "Simplified App Name"
* devscript `cask_namer` renamed to `generate_cask_token`
* doc file `CASK_NAMING_REFERENCE.md` renamed to `cask_token_reference.md`
* DSL uses `"#{token}"` for interpolation instead of `"#{title}"`
* documentation text
* backend code (variables, method, class names)
* error message text
* tests
* code comments
* Cask comments
* emphasize `tags :name`
* doc: use "vendor" consistently instead of "developer"
* doc: many man page argument descriptions were incorrect
* incidental clarifications

Many backend variables similar to `cask_name` or `cask` have
been standardized to `cask_token`, `token`, etc, resolving a long-
standing ambiguity in which variables named `cask` might contain
a Cask instance or a string token.

In many places the docs could be shortened from "Cask name" to
simply "token", which is desirable because we use the term "Cask"
in too many contexts.
2014-12-01 11:00:23 -05:00
Roland Walker 839ccb98d4 recast _checklinks verb as _checkurl
remove stray doc item missed in #6966
2014-10-28 12:12:10 -04:00
Roland Walker cd63241558 use "staged" instead of "installed" for Caskroom
refs: #6783
2014-10-21 07:13:04 -04:00
Roland Walker a57ac581a6 doc nits: table order, table format, whitespace
make the order of tables match the order of stanzas in
the examples and `brew cask create` template
2014-09-27 13:35:49 -04:00
Roland Walker d156cbfcb2 add `--force` option for `brew cask uninstall`
also update some related docs for verbs `install` and `uninstall`
2014-09-16 10:59:44 -04:00
Roland Walker 00921dd513 functionality and docs for zap stanza
* `zap` was previously supported as a noop for forward-compatibility
* Also adds restrictions against relative paths in `uninstall :files`
* Also documents safety conventions for `uninstall :files`
2014-09-13 10:21:17 -04:00
Jianwei Han e7ef6d0157 Fix broken link in USAGE.md 2014-07-05 10:18:36 +08:00
Vladimír Kriška 71f3a0d968 Show file contents instead of commits 2014-06-21 01:19:07 +02:00
Roland Walker 2ffee346df standardize the recommended upgrade command
in both docs and error messages.

Recent bug reports indicate that `cleanup` commands are essential
in some situations.
2014-06-18 15:15:50 -04:00
Roland Walker e84c8faabb Merge pull request #4661 from rolandwalker/doc_alt_taps
Document alternative Taps
2014-06-03 19:14:59 -04:00
Roland Walker d3e2c477ee doc: we now have user-maintained alt Cask Taps 2014-06-03 11:58:57 -04:00
Roland Walker db5f82ccab document the caskroom/unofficial Tap 2014-06-03 11:57:11 -04:00
Roland Walker f8c9567a66 Don't prefer Cask files in the cwd
Fixes #4641.  Cask files in the cwd are still permitted, but
at the very lowest priority, below Tapped Cask names.
2014-06-03 10:33:19 -04:00
Vítor Galvão 823e361426 Clarified when to use certain options
Options such as '--caskroom' and '--appdir' should be used in
conjuntcion with 'brew cask install'.

Addresses #3813.
2014-05-13 15:46:32 +01:00
Roland Walker e910467b39 update docs and messages for `brew cask cat` 2014-05-07 10:32:15 -04:00
Paul Hinze f54eaf7082 update all references to new caskroom org home
global replace of:
  'phinze/homebrew-cask' -> 'caskroom/homebrew-cask'
  'phinze/cask' -> 'caskroom/cask'
  'phinze/homebrew-testcasks' -> 'caskroom/homebrew-testcasks'

and various other specific places that needed updates

<3 the homebrew-cask community!
2014-05-03 10:29:17 -05:00
Adam Chainz b3a8895d95 Update USAGE.md re: alfred link 2014-04-07 11:57:29 +01:00
Võ Anh Duy 33a97a1a5f CLI - Fetch
Add `fetch` command to cli like suggestion at the end of #2528
2014-02-26 00:44:22 +07:00
Roland Walker 22e24ea5c5 Merge pull request #3131 from rolandwalker/cmd_aliases
provide command aliases to match Homebrew
2014-02-25 12:29:22 -05:00
Roland Walker 4fcdab0583 provide command aliases to match Homebrew
fixes #2969
2014-02-24 08:15:52 -05:00
Roland Walker 55e9cfc39d make `brew cask update` synonym for `brew update`
for convenience/typo
2014-02-21 10:23:16 -05:00
Roland Walker b67b2c53f2 make clear that only Alfred 2.x is supported
fixes #2891
2014-02-14 19:39:45 -05:00
Roland Walker d6c8a6917d add command `brew cask cleanup`
plus new option --outdated
2014-02-08 14:40:53 -05:00
Roland Walker 28a84baf92 Merge pull request #2545 from rolandwalker/search_followups
search docs/test/fix tapname-search
2014-01-29 09:14:26 -08:00