Update docs, comment mxcl/homebrew refs.

This commit is contained in:
Mike McQuaid 2013-12-14 18:13:11 +00:00
parent 3656f59508
commit 4c2e7b1659
13 changed files with 31 additions and 31 deletions

View File

@ -6,7 +6,7 @@ Reporting Bugs
Please read: Please read:
* `brew doctor` * `brew doctor`
* [Troubleshooting Checklist](https://github.com/mxcl/homebrew/wiki/troubleshooting) * [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/wiki/troubleshooting)
**If you don't read these it will take us far longer to help you with your problem.** **If you don't read these it will take us far longer to help you with your problem.**
@ -14,7 +14,7 @@ Contributing
------------ ------------
Please read: Please read:
* [Formula Cookbook](https://github.com/mxcl/homebrew/wiki/Formula-Cookbook) * [Formula Cookbook](https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook)
* [Acceptable Formulae](https://github.com/mxcl/homebrew/wiki/Acceptable-Formulae) * [Acceptable Formulae](https://github.com/Homebrew/homebrew/wiki/Acceptable-Formulae)
Thanks! Thanks!

View File

@ -1,4 +1,4 @@
# See: http://github.com/mxcl/homebrew/issues/issue/1359 # See: http://github.com/Homebrew/homebrew/issues/issue/1359
require 'keg' require 'keg'

View File

@ -3,7 +3,7 @@ require 'formula'
# This is a non-functional example formula to showcase all features and # This is a non-functional example formula to showcase all features and
# therefore, its overly complex and dupes stuff just to comment on it. # therefore, its overly complex and dupes stuff just to comment on it.
# You may want to use `brew create` to start your own new formula! # You may want to use `brew create` to start your own new formula!
# Documentation: https://github.com/mxcl/homebrew/wiki/Formula-Cookbook # Documentation: https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook
## Naming -- Every Homebrew formula is a class of the type `Formula`. ## Naming -- Every Homebrew formula is a class of the type `Formula`.
@ -73,7 +73,7 @@ class ExampleFormula < Formula
# Bottles are pre-built and added by the Homebrew maintainers for you. # Bottles are pre-built and added by the Homebrew maintainers for you.
# If you maintain your own repository, you can add your own bottle links. # If you maintain your own repository, you can add your own bottle links.
# Read in the wiki about how to provide bottles: # Read in the wiki about how to provide bottles:
# <https://github.com/mxcl/homebrew/wiki/Bottles> # <https://github.com/Homebrew/homebrew/wiki/Bottles>
bottle do bottle do
root_url 'http://mikemcquaid.com' # Optional root to calculate bottle URLs root_url 'http://mikemcquaid.com' # Optional root to calculate bottle URLs
prefix '/opt/homebrew' # Optional HOMEBREW_PREFIX in which the bottles were built. prefix '/opt/homebrew' # Optional HOMEBREW_PREFIX in which the bottles were built.
@ -396,7 +396,7 @@ end
class AdditionalStuff < Formula class AdditionalStuff < Formula
# Often, a second formula is used to download some resource # Often, a second formula is used to download some resource
# NOTE: This is going to change when https://github.com/mxcl/homebrew/pull/21714 happens. # NOTE: This is going to change when https://github.com/Homebrew/homebrew/pull/21714 happens.
url 'https://example.com/additional-stuff.tar.gz' url 'https://example.com/additional-stuff.tar.gz'
sha1 'deadbeef7890123456789012345678901234567890' sha1 'deadbeef7890123456789012345678901234567890'
end end
@ -404,7 +404,7 @@ end
__END__ __END__
# Room for a patch after the `__END__` # Room for a patch after the `__END__`
# Read in the wiki about how to get a patch in here: # Read in the wiki about how to get a patch in here:
# https://github.com/mxcl/homebrew/wiki/Formula-Cookbook # https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook
# In short, `brew install --interactive --git <formula>` and make your edits. # In short, `brew install --interactive --git <formula>` and make your edits.
# Then `git diff >> path/to/your/formula.rb` # Then `git diff >> path/to/your/formula.rb`
# Note, that HOMEBREW_PREFIX will be replaced in the path before it is # Note, that HOMEBREW_PREFIX will be replaced in the path before it is

View File

@ -415,7 +415,7 @@ by default:
Documentation for the included external commands as well as instructions for Documentation for the included external commands as well as instructions for
creating your own can be found on the wiki: creating your own can be found on the wiki:
<http://wiki.github.com/mxcl/homebrew/External-Commands> <http://wiki.github.com/Homebrew/homebrew/External-Commands>
## SPECIFYING FORMULAE ## SPECIFYING FORMULAE
@ -426,13 +426,13 @@ can take several different forms:
e.g. `git`, `node`, `wget`. e.g. `git`, `node`, `wget`.
* The fully-qualified name of a tapped formula: * The fully-qualified name of a tapped formula:
Sometimes a formula from a tapped repository may conflict with one in mxcl/master. Sometimes a formula from a tapped repository may conflict with one in Homebrew/homebrew.
You can still access these formulae by using a special syntax, e.g. You can still access these formulae by using a special syntax, e.g.
`homebrew/dupes/vim` or `homebrew/versions/node4`. `homebrew/dupes/vim` or `homebrew/versions/node4`.
* An arbitrary URL: * An arbitrary URL:
Homebrew can install formulae via URL, e.g. Homebrew can install formulae via URL, e.g.
`https://raw.github.com/mxcl/homebrew/master/Library/Formula/git.rb`. `https://raw.github.com/Homebrew/homebrew/master/Library/Formula/git.rb`.
The formula file will be cached for later use. The formula file will be cached for later use.
## ENVIRONMENT ## ENVIRONMENT
@ -578,7 +578,7 @@ If your proxy requires authentication:
## SEE ALSO ## SEE ALSO
Homebrew Wiki: <http://wiki.github.com/mxcl/homebrew/> Homebrew Wiki: <http://wiki.github.com/Homebrew/homebrew/>
`git`(1), `git-log`(1) `git`(1), `git-log`(1)
@ -588,5 +588,5 @@ Max Howell, a splendid chap.
## BUGS ## BUGS
See Issues on GitHub: <http://github.com/mxcl/homebrew/issues> See Issues on GitHub: <http://github.com/Homebrew/homebrew/issues>

View File

@ -117,7 +117,7 @@ class FormulaCreator
def template; <<-EOS.undent def template; <<-EOS.undent
require 'formula' require 'formula'
# Documentation: https://github.com/mxcl/homebrew/wiki/Formula-Cookbook # Documentation: https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook
# #{HOMEBREW_CONTRIB}/example-formula.rb # #{HOMEBREW_CONTRIB}/example-formula.rb
# PLEASE REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST! # PLEASE REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST!

View File

@ -56,7 +56,7 @@ class Checks
############# END HELPERS ############# END HELPERS
# Sorry for the lack of an indent here, the diff would have been unreadable. # Sorry for the lack of an indent here, the diff would have been unreadable.
# See https://github.com/mxcl/homebrew/pull/9986 # See https://github.com/Homebrew/homebrew/pull/9986
def check_path_for_trailing_slashes def check_path_for_trailing_slashes
bad_paths = ENV['PATH'].split(File::PATH_SEPARATOR).select { |p| p[-1..-1] == '/' } bad_paths = ENV['PATH'].split(File::PATH_SEPARATOR).select { |p| p[-1..-1] == '/' }
return if bad_paths.empty? return if bad_paths.empty?

View File

@ -343,7 +343,7 @@ class Formula
# Install python bindings inside of a block given to this method and/or # Install python bindings inside of a block given to this method and/or
# call python so: `system python, "setup.py", "install", "--prefix=#{prefix}" # call python so: `system python, "setup.py", "install", "--prefix=#{prefix}"
# Note that there are no quotation marks around python! # Note that there are no quotation marks around python!
# <https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python> # <https://github.com/Homebrew/homebrew/wiki/Homebrew-and-Python>
def python(options={:allowed_major_versions => [2, 3]}, &block) def python(options={:allowed_major_versions => [2, 3]}, &block)
require 'python_helper' require 'python_helper'
python_helper(options, &block) python_helper(options, &block)

View File

@ -180,9 +180,9 @@ module OS
end end
# See these issues for some history: # See these issues for some history:
# http://github.com/mxcl/homebrew/issues/#issue/13 # http://github.com/Homebrew/homebrew/issues/13
# http://github.com/mxcl/homebrew/issues/#issue/41 # http://github.com/Homebrew/homebrew/issues/41
# http://github.com/mxcl/homebrew/issues/#issue/48 # http://github.com/Homebrew/homebrew/issues/48
def macports_or_fink def macports_or_fink
paths = [] paths = []

View File

@ -108,7 +108,7 @@ module OS
rescue rescue
# For people who's xcode-select is unset, or who have installed # For people who's xcode-select is unset, or who have installed
# xcode-gcc-installer or whatever other combinations we can try and # xcode-gcc-installer or whatever other combinations we can try and
# supprt. See https://github.com/mxcl/homebrew/wiki/Xcode # supprt. See https://github.com/Homebrew/homebrew/wiki/Xcode
case MacOS.llvm_build_version.to_i case MacOS.llvm_build_version.to_i
when 1..2063 then "3.1.0" when 1..2063 then "3.1.0"
when 2064..2065 then "3.1.4" when 2064..2065 then "3.1.4"
@ -121,7 +121,7 @@ module OS
when 2327..2333 then "3.2.5" when 2327..2333 then "3.2.5"
when 2335 when 2335
# this build number applies to 3.2.6, 4.0 and 4.1 # this build number applies to 3.2.6, 4.0 and 4.1
# https://github.com/mxcl/homebrew/wiki/Xcode # https://github.com/Homebrew/homebrew/wiki/Xcode
"4.0" "4.0"
else else
case (MacOS.clang_version.to_f * 10).to_i case (MacOS.clang_version.to_f * 10).to_i

View File

@ -295,7 +295,7 @@ class PythonDependency < Requirement
<<-EOF.undent <<-EOF.undent
# This file is created by Homebrew and is executed on each python startup. # This file is created by Homebrew and is executed on each python startup.
# Don't print from here, or else python command line scripts may fail! # Don't print from here, or else python command line scripts may fail!
# <https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python> # <https://github.com/Homebrew/homebrew/wiki/Homebrew-and-Python>
import os import os
import sys import sys

View File

@ -137,7 +137,7 @@ def curl *args
raise "#{curl} is not executable" unless curl.exist? and curl.executable? raise "#{curl} is not executable" unless curl.exist? and curl.executable?
args = [HOMEBREW_CURL_ARGS, HOMEBREW_USER_AGENT, *args] args = [HOMEBREW_CURL_ARGS, HOMEBREW_USER_AGENT, *args]
# See https://github.com/mxcl/homebrew/issues/6103 # See https://github.com/Homebrew/homebrew/issues/6103
args << "--insecure" if MacOS.version < "10.6" args << "--insecure" if MacOS.version < "10.6"
args << "--verbose" if ENV['HOMEBREW_CURL_VERBOSE'] args << "--verbose" if ENV['HOMEBREW_CURL_VERBOSE']
args << "--silent" unless $stdout.tty? args << "--silent" unless $stdout.tty?

View File

@ -22,8 +22,8 @@ License
Code is under the [BSD 2 Clause (NetBSD) license][license]. Code is under the [BSD 2 Clause (NetBSD) license][license].
[home]:http://brew.sh [home]:http://brew.sh
[wiki]:http://wiki.github.com/mxcl/homebrew [wiki]:http://wiki.github.com/Homebrew/homebrew
[mxcl]:http://twitter.com/mxcl [mxcl]:http://twitter.com/mxcl
[formula]:http://github.com/mxcl/homebrew/tree/master/Library/Formula/ [formula]:http://github.com/Homebrew/homebrew/tree/master/Library/Formula/
[braumeister]:http://braumeister.org [braumeister]:http://braumeister.org
[license]:https://github.com/mxcl/homebrew/tree/master/Library/Homebrew/LICENSE [license]:https://github.com/Homebrew/homebrew/tree/master/Library/Homebrew/LICENSE

View File

@ -453,7 +453,7 @@ $ ls $(brew \-\-repository)/Library/Contributions/cmd
.IP "" 0 .IP "" 0
. .
.P .P
Documentation for the included external commands as well as instructions for creating your own can be found on the wiki: \fIhttp://wiki\.github\.com/mxcl/homebrew/External\-Commands\fR Documentation for the included external commands as well as instructions for creating your own can be found on the wiki: \fIhttp://wiki\.github\.com/Homebrew/homebrew/External\-Commands\fR
. .
.SH "SPECIFYING FORMULAE" .SH "SPECIFYING FORMULAE"
Many Homebrew commands accept one or more \fIformula\fR arguments\. These arguments can take several different forms: Many Homebrew commands accept one or more \fIformula\fR arguments\. These arguments can take several different forms:
@ -464,11 +464,11 @@ e\.g\. \fBgit\fR, \fBnode\fR, \fBwget\fR\.
. .
.TP .TP
The fully\-qualified name of a tapped formula The fully\-qualified name of a tapped formula
Sometimes a formula from a tapped repository may conflict with one in mxcl/master\. You can still access these formulae by using a special syntax, e\.g\. \fBhomebrew/dupes/vim\fR or \fBhomebrew/versions/node4\fR\. Sometimes a formula from a tapped repository may conflict with one in Homebrew/homebrew\. You can still access these formulae by using a special syntax, e\.g\. \fBhomebrew/dupes/vim\fR or \fBhomebrew/versions/node4\fR\.
. .
.TP .TP
An arbitrary URL An arbitrary URL
Homebrew can install formulae via URL, e\.g\. \fBhttps://raw\.github\.com/mxcl/homebrew/master/Library/Formula/git\.rb\fR\. The formula file will be cached for later use\. Homebrew can install formulae via URL, e\.g\. \fBhttps://raw\.github\.com/Homebrew/homebrew/master/Library/Formula/git\.rb\fR\. The formula file will be cached for later use\.
. .
.SH "ENVIRONMENT" .SH "ENVIRONMENT"
. .
@ -625,7 +625,7 @@ http_proxy=http://<user>:<password>@<host>:<port> brew install foo
.IP "" 0 .IP "" 0
. .
.SH "SEE ALSO" .SH "SEE ALSO"
Homebrew Wiki: \fIhttp://wiki\.github\.com/mxcl/homebrew/\fR Homebrew Wiki: \fIhttp://wiki\.github\.com/Homebrew/homebrew/\fR
. .
.P .P
\fBgit\fR(1), \fBgit\-log\fR(1) \fBgit\fR(1), \fBgit\-log\fR(1)
@ -634,4 +634,4 @@ Homebrew Wiki: \fIhttp://wiki\.github\.com/mxcl/homebrew/\fR
Max Howell, a splendid chap\. Max Howell, a splendid chap\.
. .
.SH "BUGS" .SH "BUGS"
See Issues on GitHub: \fIhttp://github\.com/mxcl/homebrew/issues\fR See Issues on GitHub: \fIhttp://github\.com/Homebrew/homebrew/issues\fR