diff options
author | David RodrÃguez <deivid.rodriguez@riseup.net> | 2019-07-10 17:26:55 +0200 |
---|---|---|
committer | David RodrÃguez <deivid.rodriguez@riseup.net> | 2019-08-10 12:05:10 +0200 |
commit | 23de1d0177646ab73bd9ed193e29335c3a64dd5c (patch) | |
tree | cc4303301dc728d71e48183f42dac9be1cc67b41 /man/bundle-lock.1.txt | |
parent | 27b95a172c9200e77034bb113fe1633d2150552f (diff) | |
download | bundler-23de1d0177646ab73bd9ed193e29335c3a64dd5c.tar.gz |
Commit man pages to source control
This has the benefit that:
* Allows the installation of bundler as a default gem from rubygems to
include man pages.
* Removes the need to build man pages during our tests.
* Makes working with the manifest easier, because we only have source
controlled files, and not a mix of source control and generated files.
To make sure they never fall out of sync, we replace the previous
`man:build` CI task with a `man:check` task that makes sure the
generated man pages are up to date.
Diffstat (limited to 'man/bundle-lock.1.txt')
-rw-r--r-- | man/bundle-lock.1.txt | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/man/bundle-lock.1.txt b/man/bundle-lock.1.txt new file mode 100644 index 0000000000..7dada55753 --- /dev/null +++ b/man/bundle-lock.1.txt @@ -0,0 +1,93 @@ +BUNDLE-LOCK(1) BUNDLE-LOCK(1) + + + +NAME + bundle-lock - Creates / Updates a lockfile without installing + +SYNOPSIS + bundle lock [--update] [--local] [--print] [--lockfile=PATH] + [--full-index] [--add-platform] [--remove-platform] [--patch] [--minor] + [--major] [--strict] [--conservative] + +DESCRIPTION + Lock the gems specified in Gemfile. + +OPTIONS + --update=<*gems> + Ignores the existing lockfile. Resolve then updates lockfile. + Taking a list of gems or updating all gems if no list is given. + + --local + Do not attempt to connect to rubygems.org. Instead, Bundler will + use the gems already present in Rubygems' cache or in ven- + dor/cache. Note that if a appropriate platform-specific gem + exists on rubygems.org it will not be found. + + --print + Prints the lockfile to STDOUT instead of writing to the file + system. + + --lockfile=<path> + The path where the lockfile should be written to. + + --full-index + Fall back to using the single-file index of all gems. + + --add-platform + Add a new platform to the lockfile, re-resolving for the addi- + tion of that platform. + + --remove-platform + Remove a platform from the lockfile. + + --patch + If updating, prefer updating only to next patch version. + + --minor + If updating, prefer updating only to next minor version. + + --major + If updating, prefer updating to next major version (default). + + --strict + If updating, do not allow any gem to be updated past latest + --patch | --minor | --major. + + --conservative + If updating, use bundle install conservative update behavior and + do not allow shared dependencies to be updated. + +UPDATING ALL GEMS + If you run bundle lock with --update option without list of gems, + bundler will ignore any previously installed gems and resolve all + dependencies again based on the latest versions of all gems available + in the sources. + +UPDATING A LIST OF GEMS + Sometimes, you want to update a single gem in the Gemfile(5), and leave + the rest of the gems that you specified locked to the versions in the + Gemfile.lock. + + For instance, you only want to update nokogiri, run bundle lock + --update nokogiri. + + Bundler will update nokogiri and any of its dependencies, but leave the + rest of the gems that you specified locked to the versions in the Gem- + file.lock. + +SUPPORTING OTHER PLATFORMS + If you want your bundle to support platforms other than the one you're + running locally, you can run bundle lock --add-platform PLATFORM to add + PLATFORM to the lockfile, force bundler to re-resolve and consider the + new platform when picking gems, all without needing to have a machine + that matches PLATFORM handy to install those platform-specific gems on. + + For a full explanation of gem platforms, see gem help platform. + +PATCH LEVEL OPTIONS + See bundle update(1) bundle-update.1.html for details. + + + + August 2019 BUNDLE-LOCK(1) |