Homebrew/homebrew — pull request #34729 by mikemcquaid (2014-12-06 11:33:06+00:00)
Title: Document Formula attributes

The beginnings of some decent API documentation. Mostly here for visibility; will just merge this if there are no comments in the next few days. Trying to give people a sense of the style I'm hoping to go for in the rest of the Formula file.

Also:
- tweak `.yardopts` to better fix our internal style
- add `install` method (mostly for links in API documentation and actual documentation later)
- protect some methods that aren't used publicly to avoid documenting them (and weird access of them)