summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorAndre Arko <andre@arko.net>2014-08-04 14:26:38 -0700
committerAndre Arko <andre@arko.net>2014-08-04 14:26:47 -0700
commit66f53f9d70e8b829ec9e3aa68f2bbc6a1a974f64 (patch)
tree1c4ef98e85ae21f4abba094f3c5804ad32f7e7bb /man
parent1d8b6cfc718c736b2dfdb0df55b9c9515b85af08 (diff)
downloadbundler-66f53f9d70e8b829ec9e3aa68f2bbc6a1a974f64.tar.gz
Reword credential docs for consistency and spelling
Diffstat (limited to 'man')
-rw-r--r--man/bundle-config.ronn21
-rw-r--r--man/gemfile.5.ronn14
2 files changed, 21 insertions, 14 deletions
diff --git a/man/bundle-config.ronn b/man/bundle-config.ronn
index 01b0d2e633..240cd2d9b5 100644
--- a/man/bundle-config.ronn
+++ b/man/bundle-config.ronn
@@ -145,23 +145,26 @@ Finally, Bundler also ensures that the current revision in the
`Gemfile.lock` exists in the local git repository. By doing this, Bundler
forces you to fetch the latest changes in the remotes.
-## MIRRORS OF GEM REPOSITORIES
+## MIRRORS OF GEM SOURCES
Bundler supports overriding gem sources with mirrors. This allows you to
configure rubygems.org as the gem source in your Gemfile while still using your
mirror to fetch gems.
- bundle config mirror.http://rubygems.org http://rubygems-mirror.org
+ bundle config mirror.SOURCE_URL MIRROR_URL
+
+For example, to use a mirror of rubygems.org hosted at
-## CREDENTIALS FOR PRIVATE REPOSITORIES
+ bundle config mirror.http://rubygems.org http://rubygems-mirror.org
-Bundler allows you to configure credentials for private repositories on a per
-source basis.
+## CREDENTIALS FOR GEM SOURCES
- bundle config REMOTE_URI USERNAME:PASSWORD
+Bundler allows you to configure credentials for any gem source, which allows
+you to avoid putting secrets into your Gemfile.
-For example to use your company geminabox server you can call:
+ bundle config SOURCE_URL USERNAME:PASSWORD
- bundle config https://gems.example.com/ username:password
+For example, to save the credentials of user `claudette` for the gem source at
+`gems.longerous.com`, you would run:
-This way you can avoid putting secrets into your Gemfile.
+ bundle config https://gems.longerous.com/ claudette:s00pers3krit
diff --git a/man/gemfile.5.ronn b/man/gemfile.5.ronn
index 7b992365ba..720b26f8d1 100644
--- a/man/gemfile.5.ronn
+++ b/man/gemfile.5.ronn
@@ -26,18 +26,22 @@ might contain the gems listed in the `Gemfile`.
Each of these _source_s `MUST` be a valid Rubygems repository. Sources are
checked for gems following the heuristics described in [SOURCE PRIORITY][].
-### PRIVATE REPOSITORIES
+### CREDENTIALS (#credentials)
-To access private repositories you can use `bundle config` to set user and
-password on a per source basis.
+Some gem sources require a username and password. Use `bundle config` to set
+the username and password for any sources that need it. The command must be run
+once on each computer that will install the Gemfile, but this keeps the
+credentials from being stored in plain text in version control.
bundle config https://gems.example.com/ user:password
-As alternative you can provide credentials directly in the source URI.
+For some sources, like a company Gemfury account, it may be easier to simply
+include the credentials in the Gemfile as part of the source URL.
source "https://user:passowrd@gems.example.com"
-Credentials provided in the source URI will take presedence.
+Credentials in the source URL will take precedence over credentials set using
+`config`.
## RUBY (#ruby)