This tap is no longer necessary. In late May 2019, iwyu was accepted into homebrew-core and may now be installed with a simple brew install iwyu.
If you were a user of this tap, please switch to the homebrew-core version, as this one is quite out of date and no longer maintained.
It's as simple as: brew rm -f jasonmp85/iwyu/iwyu && brew untap jasonmp85/iwyu && brew install iwyu
This formula makes it easy to install include-what-you-use on any modern OS X system.
Just brew tap jasonmp85/iwyu and then brew install iwyu.
The project's page goes into more detail, but there are three basic ways to use iwyu…
Invoke it on a single file, as you would a compiler: iwyu hello_world.c. Messages about what includes to add or remove will be printed to standard output.
Tell make to use it as the C compiler: make -k CC=iwyu. It's necessary to use the -k flag to continue after errors (iwyu always errors to signal that no compilation has actually taken place).
include-what-you-use bundles a Python script capable of parsing its output in order to automatically fix any include problems, in-place if you desire. It's not perfect, but something like fix_include hello_world.c < iwyu hello_world.c should work to update a file named hello_world.c with the suggestions made by iwyu.
Copyright © 2014–2017 Jason Petersen
Code released under the MIT License.