Add brew cask upgrade to man page

[commitay]

Refs: Homebrew/brew#3396

https://github.com/Homebrew/brew/blob/master/Library/Homebrew/manpages/brew-cask.1.md

[seanprashad]

Hi @commitay! I'd love to work on this but I'm not sure which documentation file I'm updating since the URL you linked is in an entirely different repo - could you point me in the right direction please?

[commitay]

Hi @seanprashad!

The URL is correct, our core code was merged with Homebrew.

brew-cask.1.md can be updated, then run brew man to regenerate the man page and commit the changed files.

An example of a similar manpage update and the regenerated files is Homebrew/brew#3221

[seanprashad]

@commitay I've done initial changes but when I run the brew man command, it doesn't change anything:

I've also committed the modified source files before and after I ran that command - is there something I missed?

[commitay]

Looks like you're working in a different repo to your Homebrew installation, the changes need to be made in the same repo that brew man will run in.

$ echo test > $(brew --repo)/Library/Homebrew/manpages/brew-cask.1.md

$ brew man
Writing markdown to /usr/local/Homebrew/docs/Manpage.md
Writing man page to /usr/local/Homebrew/manpages/brew.1
Writing man page to /usr/local/Homebrew/manpages/brew-cask.1

$ git -C $(brew --repo) status
On branch master
Your branch is up to date with 'origin/master'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

	modified:   Library/Homebrew/manpages/brew-cask.1.md
	modified:   manpages/brew-cask.1

no changes added to commit (use "git add" and/or "git commit -a")

[seanprashad]

Hi @commitay - my changes were reviewed and merged in Homebrew/brew#3609 - is it safe to close this issue now?

[commitay]

Thanks @seanprashad!