This commit is contained in:
@@ -0,0 +1,78 @@
|
||||
.\" generated with Ronn-NG/v0.10.1
|
||||
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
||||
.TH "BUNDLE\-LOCK" "1" "April 2026" ""
|
||||
.SH "NAME"
|
||||
\fBbundle\-lock\fR \- Creates / Updates a lockfile without installing
|
||||
.SH "SYNOPSIS"
|
||||
\fBbundle lock\fR [\-\-update] [\-\-bundler[=BUNDLER]] [\-\-local] [\-\-print] [\-\-lockfile=PATH] [\-\-full\-index] [\-\-gemfile=GEMFILE] [\-\-add\-checksums] [\-\-add\-platform] [\-\-remove\-platform] [\-\-normalize\-platforms] [\-\-patch] [\-\-minor] [\-\-major] [\-\-pre] [\-\-strict] [\-\-conservative] [\-\-cooldown=NUMBER]
|
||||
.SH "DESCRIPTION"
|
||||
Lock the gems specified in Gemfile\.
|
||||
.SH "OPTIONS"
|
||||
.TP
|
||||
\fB\-\-update[=<list>]\fR
|
||||
Ignores the existing lockfile\. Resolve then updates lockfile\. Taking a list of gems or updating all gems if no list is given\.
|
||||
.TP
|
||||
\fB\-\-bundler[=BUNDLER]\fR
|
||||
Update the locked version of bundler\. BUNDLER can be a version such as \fB4\.0\.20\fR, or a requirement such as \fB"> 0\.a"\fR\. With no argument, update to the latest released version, which never selects a prerelease\.
|
||||
.TP
|
||||
\fB\-\-local\fR
|
||||
Do not attempt to connect to \fBrubygems\.org\fR\. Instead, Bundler will use the gems already present in Rubygems' cache or in \fBvendor/cache\fR\. Note that if a appropriate platform\-specific gem exists on \fBrubygems\.org\fR it will not be found\.
|
||||
.TP
|
||||
\fB\-\-print\fR
|
||||
Prints the lockfile to STDOUT instead of writing to the file system\.
|
||||
.TP
|
||||
\fB\-\-lockfile=LOCKFILE\fR
|
||||
The path where the lockfile should be written to\.
|
||||
.TP
|
||||
\fB\-\-full\-index\fR
|
||||
Fall back to using the single\-file index of all gems\.
|
||||
.TP
|
||||
\fB\-\-gemfile=GEMFILE\fR
|
||||
Use the specified gemfile instead of [\fBGemfile(5)\fR][Gemfile(5)]\.
|
||||
.TP
|
||||
\fB\-\-add\-checksums\fR
|
||||
Add checksums to the lockfile\.
|
||||
.TP
|
||||
\fB\-\-add\-platform=<list>\fR
|
||||
Add a new platform to the lockfile, re\-resolving for the addition of that platform\.
|
||||
.TP
|
||||
\fB\-\-remove\-platform=<list>\fR
|
||||
Remove a platform from the lockfile\.
|
||||
.TP
|
||||
\fB\-\-normalize\-platforms\fR
|
||||
Normalize lockfile platforms\.
|
||||
.TP
|
||||
\fB\-\-patch\fR
|
||||
If updating, prefer updating only to next patch version\.
|
||||
.TP
|
||||
\fB\-\-minor\fR
|
||||
If updating, prefer updating only to next minor version\.
|
||||
.TP
|
||||
\fB\-\-major\fR
|
||||
If updating, prefer updating to next major version (default)\.
|
||||
.TP
|
||||
\fB\-\-pre\fR
|
||||
If updating, always choose the highest allowed version, regardless of prerelease status\.
|
||||
.TP
|
||||
\fB\-\-strict\fR
|
||||
If updating, do not allow any gem to be updated past latest \-\-patch | \-\-minor | \-\-major\.
|
||||
.TP
|
||||
\fB\-\-conservative\fR
|
||||
If updating, use bundle install conservative update behavior and do not allow shared dependencies to be updated\.
|
||||
.TP
|
||||
\fB\-\-cooldown=<number>\fR
|
||||
Only consider gem versions published at least \fInumber\fR days ago when resolving\. Pass \fB0\fR to disable cooldown for this run, overriding any per\-source or global configuration\. See \fBcooldown\fR in bundle\-config(1)\.
|
||||
.SH "UPDATING ALL GEMS"
|
||||
If you run \fBbundle lock\fR with \fB\-\-update\fR 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\.
|
||||
.SH "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 \fBGemfile\.lock\fR\.
|
||||
.P
|
||||
For instance, you only want to update \fBnokogiri\fR, run \fBbundle lock \-\-update nokogiri\fR\.
|
||||
.P
|
||||
Bundler will update \fBnokogiri\fR and any of its dependencies, but leave the rest of the gems that you specified locked to the versions in the \fBGemfile\.lock\fR\.
|
||||
.SH "SUPPORTING OTHER PLATFORMS"
|
||||
If you want your bundle to support platforms other than the one you're running locally, you can run \fBbundle lock \-\-add\-platform PLATFORM\fR 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\.
|
||||
.P
|
||||
For a full explanation of gem platforms, see \fBgem help platform\fR\.
|
||||
.SH "PATCH LEVEL OPTIONS"
|
||||
See bundle update(1) \fIbundle\-update\.1\.html\fR for details\.
|
||||
Reference in New Issue
Block a user