admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

Update manpage with info about compilers

Browse Source 
* Update the manpage source file with additional information
    * document the `HOMEBREW_CC` variable with usage information
    * update usage information for `--cc`, specifying how to use llvm's clang
This commit is contained in:
Afnan Enayet 2018-06-30 15:54:17 -04:00
parent fac11c2f16
commit a68f1ff619
No known key found for this signature in database
GPG Key ID: 9C669708328BC5A4
1 changed files with 32 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
docs/Manpage.md
View File

@ -240,7 +240,9 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
If `--cc=``compiler` is passed, attempt to compile using `compiler`.
`compiler` should be the name of the compiler's executable, for instance
`gcc-4.2` for Apple's GCC 4.2, or `gcc-4.9` for a Homebrew-provided GCC
4.9.
4.9. In order to use the Homebrew-provided clang from the LLVM package,
use `llvm_clang`. Note that this will override the `HOMEBREW_CC`
environment variable.
If `--build-from-source` (or `-s`) is passed, compile the specified `formula` from
source even if a bottle is provided. Dependencies will still be installed
@ -1122,6 +1124,15 @@ Note that environment variables must have a value set to be detected. For exampl
*Default:* `~/Library/Caches/Homebrew`.
* `HOMEBREW_CC`:
If set, directs which compiler Homebrew will use to compile packages if it
builds them from source. If an installation command passes in a `--cc`
flag, it will override the value set by `HOMEBREW_CC`. The only valid
compilers are ones provided by Homebrew, or Apple's bundled clang. To use
gcc for compilation, pass in the executable name, i.e. `gcc-4.9`, `gcc-8`.
If you want to use Apple's provided clang, simply use `clang`. For
Homebrew's clang from the LLVM package, use `llvm_clang`.
* `HOMEBREW_CURLRC`:
If set, Homebrew will not pass `-q` when invoking `curl`(1) (which disables
the use of `curlrc`).