diff options
| author | Adam Vandenberg | 2010-11-01 10:24:57 -0700 |
|---|---|---|
| committer | Adam Vandenberg | 2010-11-01 10:25:02 -0700 |
| commit | 3658418d3e695cec2971c36f8f09db6f609d4a49 (patch) | |
| tree | 7f9c78dc6ff7a625f0bb0853b9577a0c53f228ce | |
| parent | cb6ea3656269a63d66920159d2978f920619ba85 (diff) | |
| download | homebrew-3658418d3e695cec2971c36f8f09db6f609d4a49.tar.bz2 | |
Add proxy information to man page
| -rw-r--r-- | Library/Contributions/manpages/brew.1.md | 15 | ||||
| -rw-r--r-- | share/man/man1/brew.1 | 31 |
2 files changed, 45 insertions, 1 deletions
diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md index 4f3bfffd9..be7c168c8 100644 --- a/Library/Contributions/manpages/brew.1.md +++ b/Library/Contributions/manpages/brew.1.md @@ -283,6 +283,21 @@ Some external commands are shipped with Homebrew, and enabled by default. If set, instructs Homebrew to always assume `--verbose` when running commands. +## USING HOMEBREW BEHIND A PROXY + +Homebrew uses several commands for downloading files (e.g. curl, git, svn). +Many of these tools can download via a proxy. It's common for these tools +to read proxy parameters from environment variables. + +For the majority of cases setting `http_proxy` is enough. You can set this in +your shell profile, or you can use it before a brew command: + + http_proxy=http://<host>:<port> brew install foo + +If your proxy requires authentication: + + http_proxy=http://<user>:<password>@<host>:<port> brew install foo + ## SEE ALSO Homebrew Wiki: http://wiki.github.com/mxcl/homebrew/ diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1 index c47164742..c2a024724 100644 --- a/share/man/man1/brew.1 +++ b/share/man/man1/brew.1 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "BREW" "1" "October 2010" "Homebrew" "brew" +.TH "BREW" "1" "November 2010" "Homebrew" "brew" . .SH "NAME" \fBbrew\fR \- The missing package manager for OS X @@ -285,6 +285,35 @@ If set, instructs Homebrew to use the LLVM front\-ends to the GCC compilers\. HOMEBREW_VERBOSE If set, instructs Homebrew to always assume \fB\-\-verbose\fR when running commands\. . +.SH "USING HOMEBREW BEHIND A PROXY" +Homebrew uses several commands for downloading files (e\.g\. curl, git, svn)\. Many of these tools can download via a proxy\. It\'s common for these tools to read proxy parameters from environment variables\. +. +.P +For the majority of cases setting \fBhttp_proxy\fR is enough\. You can set this in your shell profile, or you can use it before a brew command: +. +.IP "" 4 +. +.nf + +http_proxy=http://<host>:<port> brew install foo +. +.fi +. +.IP "" 0 +. +.P +If your proxy requires authentication: +. +.IP "" 4 +. +.nf + +http_proxy=http://<user>:<password>@<host>:<port> brew install foo +. +.fi +. +.IP "" 0 +. .SH "SEE ALSO" Homebrew Wiki: http://wiki\.github\.com/mxcl/homebrew/ . |