mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
7585bc3187
Features: - Add caller information to some deprecation messages to make them easier to fix [#7361](https://github.com/bundler/bundler/pull/7361) - Reconcile `bundle cache` vs `bundle package` everywhere. Now in docs, CLI help and everywhere else `bundle cache` is the preferred version and `bundle package` remains as an alias [#7389](https://github.com/bundler/bundler/pull/7389) - Display some basic `bundler` documentation together with ruby's RDoc based documentation [#7394](https://github.com/bundler/bundler/pull/7394) Bugfixes: - Fix typos deprecation message and upgrading docs [#7374](https://github.com/bundler/bundler/pull/7374) - Deprecation warnings about `taint` usage on ruby 2.7 [#7385](https://github.com/bundler/bundler/pull/7385) - Fix `--help` flag not correctly delegating to `man` when used with command aliases [#7388](https://github.com/bundler/bundler/pull/7388) - `bundle add` should cache newly added gems if an application cache exists [#7393](https://github.com/bundler/bundler/pull/7393) - Stop using an insecure folder as a "fallback home" when user home is not defined [#7416](https://github.com/bundler/bundler/pull/7416) - Fix `bundler/inline` warning about `Bundler.root` redefinition [#7417](https://github.com/bundler/bundler/pull/7417)
80 lines
3.2 KiB
Groff
80 lines
3.2 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "BUNDLE\-GEM" "1" "November 2019" "" ""
|
|
.
|
|
.SH "NAME"
|
|
\fBbundle\-gem\fR \- Generate a project skeleton for creating a rubygem
|
|
.
|
|
.SH "SYNOPSIS"
|
|
\fBbundle gem\fR \fIGEM_NAME\fR \fIOPTIONS\fR
|
|
.
|
|
.SH "DESCRIPTION"
|
|
Generates a directory named \fBGEM_NAME\fR with a \fBRakefile\fR, \fBGEM_NAME\.gemspec\fR, and other supporting files and directories that can be used to develop a rubygem with that name\.
|
|
.
|
|
.P
|
|
Run \fBrake \-T\fR in the resulting project for a list of Rake tasks that can be used to test and publish the gem to rubygems\.org\.
|
|
.
|
|
.P
|
|
The generated project skeleton can be customized with OPTIONS, as explained below\. Note that these options can also be specified via Bundler\'s global configuration file using the following names:
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBgem\.coc\fR
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBgem\.mit\fR
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBgem\.test\fR
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "OPTIONS"
|
|
.
|
|
.TP
|
|
\fB\-\-exe\fR or \fB\-b\fR or \fB\-\-bin\fR
|
|
Specify that Bundler should create a binary executable (as \fBexe/GEM_NAME\fR) in the generated rubygem project\. This binary will also be added to the \fBGEM_NAME\.gemspec\fR manifest\. This behavior is disabled by default\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-exe\fR
|
|
Do not create a binary (overrides \fB\-\-exe\fR specified in the global config)\.
|
|
.
|
|
.TP
|
|
\fB\-\-coc\fR
|
|
Add a \fBCODE_OF_CONDUCT\.md\fR file to the root of the generated project\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-coc\fR
|
|
Do not create a \fBCODE_OF_CONDUCT\.md\fR (overrides \fB\-\-coc\fR specified in the global config)\.
|
|
.
|
|
.TP
|
|
\fB\-\-ext\fR
|
|
Add boilerplate for C extension code to the generated project\. This behavior is disabled by default\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-ext\fR
|
|
Do not add C extension code (overrides \fB\-\-ext\fR specified in the global config)\.
|
|
.
|
|
.TP
|
|
\fB\-\-mit\fR
|
|
Add an MIT license to a \fBLICENSE\.txt\fR file in the root of the generated project\. Your name from the global git config is used for the copyright statement\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\.
|
|
.
|
|
.TP
|
|
\fB\-\-no\-mit\fR
|
|
Do not create a \fBLICENSE\.txt\fR (overrides \fB\-\-mit\fR specified in the global config)\.
|
|
.
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-test=minitest\fR, \fB\-\-test=rspec\fR
|
|
Specify the test framework that Bundler should use when generating the project\. Acceptable values are \fBminitest\fR and \fBrspec\fR\. The \fBGEM_NAME\.gemspec\fR will be configured and a skeleton test/spec directory will be created based on this option\. If this option is unspecified, an interactive prompt will be displayed and the answer will be saved in Bundler\'s global config for future \fBbundle gem\fR use\. If no option is specified, the default testing framework is RSpec\.
|
|
.
|
|
.TP
|
|
\fB\-e\fR, \fB\-\-edit[=EDITOR]\fR
|
|
Open the resulting GEM_NAME\.gemspec in EDITOR, or the default editor if not specified\. The default is \fB$BUNDLER_EDITOR\fR, \fB$VISUAL\fR, or \fB$EDITOR\fR\.
|
|
.
|
|
.SH "SEE ALSO"
|
|
.
|
|
.IP "\(bu" 4
|
|
bundle config(1) \fIbundle\-config\.1\.html\fR
|
|
.
|
|
.IP "" 0
|
|
|