summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSamuel Giddins <segiddins@segiddins.me>2016-12-24 18:11:00 +0100
committerSamuel Giddins <segiddins@segiddins.me>2016-12-26 14:53:47 -0600
commit1692d5bf14607fe4ae80da4dd3058f19e4508533 (patch)
tree8c1e2877bc52df8652569e292f61b35ac17fd090
parent6f6c7addb0398cc10b11bf056414d88baad5f130 (diff)
downloadbundler-1692d5bf14607fe4ae80da4dd3058f19e4508533.tar.gz
[Docs] Document using lock --add-platform
-rw-r--r--man/bundle-lock.ronn11
1 files changed, 10 insertions, 1 deletions
diff --git a/man/bundle-lock.ronn b/man/bundle-lock.ronn
index b18d819c21..74a03616dc 100644
--- a/man/bundle-lock.ronn
+++ b/man/bundle-lock.ronn
@@ -42,7 +42,8 @@ Lock the gems specified in Gemfile.
Fall back to using the single-file index of all gems.
* `--add-platform`:
- Add a new platform to the lockfile.
+ Add a new platform to the lockfile, re-resolving for the addition of that
+ platform.
* `--remove-platform`:
Remove a platform from the lockfile.
@@ -78,6 +79,14 @@ For instance, you only want to update `nokogiri`, run `bundle lock --update noko
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 `Gemfile.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.
+
## PATCH LEVEL OPTIONS
See [bundle update(1)][bundle-update] for details.