From 702ca24b980ca28ad1c5cd19160bd083c3e0095b Mon Sep 17 00:00:00 2001 From: Samuel Giddins Date: Thu, 4 Jan 2018 14:16:47 -0800 Subject: [Man] Audit links to other manpages --- man/bundle-binstubs.ronn | 2 +- man/bundle-check.ronn | 6 +++--- man/bundle-config.ronn | 8 ++++---- man/bundle-exec.ronn | 6 +++--- man/bundle-gem.ronn | 2 +- man/bundle-init.ronn | 8 ++++---- man/bundle-inject.ronn | 6 +++--- man/bundle-install.ronn | 2 +- man/bundle-lock.ronn | 2 +- man/bundle-outdated.ronn | 2 +- man/bundle-package.ronn | 6 +++--- man/bundle-show.ronn | 4 ++-- man/bundle-update.ronn | 16 ++++++++-------- man/bundle-viz.ronn | 2 +- man/bundle.ronn | 32 ++++++++++++++++---------------- man/gemfile.5.ronn | 6 +++--- 16 files changed, 55 insertions(+), 55 deletions(-) diff --git a/man/bundle-binstubs.ronn b/man/bundle-binstubs.ronn index ce7983acf0..99ddc79ef0 100644 --- a/man/bundle-binstubs.ronn +++ b/man/bundle-binstubs.ronn @@ -40,4 +40,4 @@ Calling binstubs with [GEM [GEM]] will create binstubs for all given gems. ## BUNDLE INSTALL --BINSTUBS To create binstubs for all the gems in the bundle you can use the `--binstubs` -flag in [bundle install(1)][bundle-install]. +flag in [bundle install(1)][bundle-install(1)]. diff --git a/man/bundle-check.ronn b/man/bundle-check.ronn index b299da422f..f2846b8ff2 100644 --- a/man/bundle-check.ronn +++ b/man/bundle-check.ronn @@ -18,9 +18,9 @@ If not, the first missing gem is listed and Bundler exits status 1. ## OPTIONS * `--dry-run`: - Locks the `Gemfile(5)` before running the command. + Locks the [`Gemfile(5)`][Gemfile(5)] before running the command. * `--gemfile`: - Use the specified gemfile instead of the `Gemfile(5)` + Use the specified gemfile instead of the [`Gemfile(5)`][Gemfile(5)]. * `--path`: - Specify a different path than the system default ($BUNDLE_PATH or $GEM_HOME). + Specify a different path than the system default (`$BUNDLE_PATH` or `$GEM_HOME`). Bundler will remember this value for future installs on this machine. diff --git a/man/bundle-config.ronn b/man/bundle-config.ronn index 3d3063dfb3..88ad827313 100644 --- a/man/bundle-config.ronn +++ b/man/bundle-config.ronn @@ -98,11 +98,11 @@ After running this command, every time bundler needs to install the Configuration keys in bundler have two forms: the canonical form and the environment variable form. -For instance, passing the `--without` flag to [bundle install(1)][bundle-install] +For instance, passing the `--without` flag to [bundle install(1)][bundle-install(1)] prevents Bundler from installing certain groups specified in the Gemfile(5). Bundler persists this value in `app/.bundle/config` so that calls to `Bundler.setup` do not try to find gems from the `Gemfile` that you didn't install. Additionally, -subsequent calls to [bundle install(1)][bundle-install] remember this setting +subsequent calls to [bundle install(1)][bundle-install(1)] remember this setting and skip those groups. The canonical form of this configuration is `"without"`. To convert the canonical @@ -116,7 +116,7 @@ the environment variable `BUNDLE_LOCAL__RACK`. ## LIST OF AVAILABLE KEYS The following is a list of all configuration keys and their purpose. You can -learn more about their operation in [bundle install(1)][bundle-install]. +learn more about their operation in [bundle install(1)][bundle-install(1)]. * `allow_bundler_dependency_conflicts` (`BUNDLE_ALLOW_BUNDLER_DEPENDENCY_CONFLICTS`): Allow resolving to specifications that have dependencies on `bundler` that @@ -279,7 +279,7 @@ learn more about their operation in [bundle install(1)][bundle-install]. A `:`-separated list of groups whose gems bundler should not install. In general, you should set these settings per-application by using the applicable -flag to the [bundle install(1)][bundle-install] or [bundle package(1)][bundle-package] command. +flag to the [bundle install(1)][bundle-install(1)] or [bundle package(1)][bundle-package(1)] command. You can set them globally either via environment variables or `bundle config`, whichever is preferable for your setup. If you use both, environment variables diff --git a/man/bundle-exec.ronn b/man/bundle-exec.ronn index bd6e36d981..7b63cc7b47 100644 --- a/man/bundle-exec.ronn +++ b/man/bundle-exec.ronn @@ -8,11 +8,11 @@ bundle-exec(1) -- Execute a command in the context of the bundle ## DESCRIPTION This command executes the command, making all gems specified in the -`Gemfile(5)` available to `require` in Ruby programs. +[`Gemfile(5)`][Gemfile(5)] available to `require` in Ruby programs. Essentially, if you would normally have run something like `rspec spec/my_spec.rb`, and you want to use the gems specified -in the `Gemfile(5)` and installed via [bundle install(1)][bundle-install], you +in the [`Gemfile(5)`][Gemfile(5)] and installed via [bundle install(1)][bundle-install(1)], you should run `bundle exec rspec spec/my_spec.rb`. Note that `bundle exec` does not require that an executable is @@ -27,7 +27,7 @@ available on your shell's `$PATH`. ## BUNDLE INSTALL --BINSTUBS -If you use the `--binstubs` flag in [bundle install(1)][bundle-install], Bundler will +If you use the `--binstubs` flag in [bundle install(1)][bundle-install(1)], Bundler will automatically create a directory (which defaults to `app_root/bin`) containing all of the executables available from gems in the bundle. diff --git a/man/bundle-gem.ronn b/man/bundle-gem.ronn index 3fcf93cd21..0002f05c40 100644 --- a/man/bundle-gem.ronn +++ b/man/bundle-gem.ronn @@ -75,4 +75,4 @@ configuration file using the following names: ## SEE ALSO -* [bundle-config](http://bundler.io/v1.16/bundle_config.html) +* [bundle config(1)][bundle-config(1)] diff --git a/man/bundle-init.ronn b/man/bundle-init.ronn index e5dfd420e9..781a25b1a2 100644 --- a/man/bundle-init.ronn +++ b/man/bundle-init.ronn @@ -7,12 +7,12 @@ bundle-init(1) -- Generates a Gemfile into the current working directory ## DESCRIPTION -Init generates a default `Gemfile(5)` in the current working directory. When -adding a `Gemfile(5)` to a gem with a gemspec, the `--gemspec` option will +Init generates a default [`Gemfile(5)`][Gemfile(5)] in the current working directory. When +adding a [`Gemfile(5)`][Gemfile(5)] to a gem with a gemspec, the `--gemspec` option will automatically add each dependency listed in the gemspec file to the newly -created `Gemfile(5)`. +created [`Gemfile(5)`][Gemfile(5)]. ## OPTIONS * `--gemspec`: - Use the specified .gemspec to create the `Gemfile(5)` + Use the specified .gemspec to create the [`Gemfile(5)`][Gemfile(5)] diff --git a/man/bundle-inject.ronn b/man/bundle-inject.ronn index 02f5dd8bd2..f454341896 100644 --- a/man/bundle-inject.ronn +++ b/man/bundle-inject.ronn @@ -8,9 +8,9 @@ bundle-inject(1) -- Add named gem(s) with version requirements to Gemfile ## DESCRIPTION Adds the named gem(s) with their version requirements to the resolved -`Gemfile(5)`. +[`Gemfile(5)`][Gemfile(5)]. -This command will add the gem to both your `Gemfile(5)` and Gemfile.lock if it +This command will add the gem to both your [`Gemfile(5)`][Gemfile(5)] and Gemfile.lock if it isn't listed yet. Example: @@ -19,4 +19,4 @@ Example: bundle inject 'rack' '> 0' This will inject the 'rack' gem with a version greater than 0 in your -`Gemfile(5)` and Gemfile.lock +[`Gemfile(5)`][Gemfile(5)] and Gemfile.lock diff --git a/man/bundle-install.ronn b/man/bundle-install.ronn index c7e38e154f..59e5adcd58 100644 --- a/man/bundle-install.ronn +++ b/man/bundle-install.ronn @@ -366,7 +366,7 @@ which other gems in the Gemfile(5) still depend on, run `Summary`: In general, after making a change to the Gemfile(5) , you should first try to run `bundle install`, which will guarantee that no other gem in the Gemfile(5) is impacted by the change. If that -does not work, run [bundle update(1)][bundle-update]. +does not work, run [bundle update(1)][bundle-update(1)]. ## SEE ALSO diff --git a/man/bundle-lock.ronn b/man/bundle-lock.ronn index 31ecd3c877..951194715f 100644 --- a/man/bundle-lock.ronn +++ b/man/bundle-lock.ronn @@ -91,4 +91,4 @@ For a full explanation of gem platforms, see `gem help platform`. ## PATCH LEVEL OPTIONS -See [bundle update(1)][bundle-update] for details. +See [bundle update(1)][bundle-update(1)] for details. diff --git a/man/bundle-outdated.ronn b/man/bundle-outdated.ronn index 7eacad5dc0..76baa3d755 100644 --- a/man/bundle-outdated.ronn +++ b/man/bundle-outdated.ronn @@ -69,7 +69,7 @@ are up to date, Bundler will exit with a status of 0. Otherwise, it will exit 1. ## PATCH LEVEL OPTIONS -See [bundle update(1)][bundle-update] for details. +See [bundle update(1)][bundle-update(1)] for details. One difference between the patch level options in `bundle update` and here is the `--strict` option. `--strict` was already an option on outdated before the patch level options were added. `--strict` diff --git a/man/bundle-package.ronn b/man/bundle-package.ronn index 78bbd88c4b..e2d83c092f 100644 --- a/man/bundle-package.ronn +++ b/man/bundle-package.ronn @@ -27,8 +27,8 @@ in your local bundler configuration. ## REMOTE FETCHING -By default, if you run [bundle install(1)][bundle-install] after running -[bundle package(1)][bundle-package], bundler will still connect to `rubygems.org` +By default, if you run `bundle install(1)`][bundle-install(1)] after running +[bundle package(1)][bundle-package(1)], bundler will still connect to `rubygems.org` to check whether a platform-specific gem exists for any of the gems in `vendor/cache`. @@ -66,7 +66,7 @@ machine and check in the gems. For instance, you can run staging process, and check in the `vendor/cache` before deploying to production. -By default, [bundle package(1)][bundle-package] fetches and also +By default, [bundle package(1)][bundle-package(1)] fetches and also installs the gems to the default location. To package the dependencies to `vendor/cache` without installing them to the local install location, you can run `bundle package --no-install`. diff --git a/man/bundle-show.ronn b/man/bundle-show.ronn index 714b6067aa..a333a44e5d 100644 --- a/man/bundle-show.ronn +++ b/man/bundle-show.ronn @@ -9,7 +9,7 @@ bundle-show(1) -- Shows all the gems in your bundle, or the path to a gem ## DESCRIPTION Without the [GEM] option, `show` will print a list of the names and versions of -all gems that are required by your `Gemfile(5)`. +all gems that are required by your [`Gemfile(5)`][Gemfile(5)]. Calling show with [GEM] will list the exact location of that gem on your machine. @@ -17,4 +17,4 @@ machine. ## OPTIONS * `--paths`: - List the paths of all gems that are required by your `Gemfile(5)`. + List the paths of all gems that are required by your [`Gemfile(5)`][Gemfile(5)]. diff --git a/man/bundle-update.ronn b/man/bundle-update.ronn index b29965985b..413a446c60 100644 --- a/man/bundle-update.ronn +++ b/man/bundle-update.ronn @@ -20,7 +20,7 @@ bundle-update(1) -- Update your gems to the latest available versions Update the gems specified (all gems, if none are specified), ignoring the previously installed gems specified in the `Gemfile.lock`. In -general, you should use [bundle install(1)][bundle-install] to install the same exact +general, you should use [bundle install(1)][bundle-install(1)] to install the same exact gems and versions across machines. You would use `bundle update` to explicitly update the version of a @@ -91,7 +91,7 @@ Consider the following Gemfile(5): gem "rails", "3.0.0.rc" gem "nokogiri" -When you run [bundle install(1)][bundle-install] the first time, bundler will resolve +When you run [bundle install(1)][bundle-install(1)] the first time, bundler will resolve all of the dependencies, all the way down, and install what you need: Fetching gem metadata from https://rubygems.org/......... @@ -128,11 +128,11 @@ all of the dependencies, all the way down, and install what you need: As you can see, even though you have two gems in the Gemfile(5), your application needs 26 different gems in order to run. Bundler remembers the exact versions -it installed in `Gemfile.lock`. The next time you run [bundle install(1)][bundle-install], bundler skips +it installed in `Gemfile.lock`. The next time you run [bundle install(1)][bundle-install(1)], bundler skips the dependency resolution and installs the same gems as it installed last time. After checking in the `Gemfile.lock` into version control and cloning it on another -machine, running [bundle install(1)][bundle-install] will _still_ install the gems that you installed +machine, running [bundle install(1)][bundle-install(1)] will _still_ install the gems that you installed last time. You don't need to worry that a new release of `erubis` or `mail` changes the gems you use. @@ -192,12 +192,12 @@ update all dependencies of that gem, including those that are also dependencies of another gem. To prevent updating shared dependencies, prior to version 1.14 the only option -was the `CONSERVATIVE UPDATING` behavior in [bundle install(1)][bundle-install]: +was the `CONSERVATIVE UPDATING` behavior in [bundle install(1)][bundle-install(1)]: In this scenario, updating the `thin` version manually in the Gemfile(5), -and then running [bundle install(1)][bundle-install] will only update `daemons` and `eventmachine`, +and then running [bundle install(1)][bundle-install(1)] will only update `daemons` and `eventmachine`, but not `rack`. For more information, see the `CONSERVATIVE UPDATING` section -of [bundle install(1)][bundle-install]. +of [bundle install(1)][bundle-install(1)]. Starting with 1.14, specifying the `--conservative` option will also prevent shared dependencies from being updated. @@ -335,7 +335,7 @@ use the following workflow: $ git add Gemfile.lock -* If [bundle install(1)][bundle-install] reports a conflict, manually update the specific +* If [bundle install(1)][bundle-install(1)] reports a conflict, manually update the specific gems that you changed in the Gemfile(5) $ bundle update rails thin diff --git a/man/bundle-viz.ronn b/man/bundle-viz.ronn index f43faab635..762558c184 100644 --- a/man/bundle-viz.ronn +++ b/man/bundle-viz.ronn @@ -14,7 +14,7 @@ bundle-viz(1) -- Generates a visual dependency graph for your Gemfile `viz` generates a PNG file of the current `Gemfile(5)` as a dependency graph. `viz` requires the ruby-graphviz gem (and its dependencies). -The associated gems must also be installed via `bundle install(1)`. +The associated gems must also be installed via [`bundle install(1)`][bundle-install(1)]. ## OPTIONS diff --git a/man/bundle.ronn b/man/bundle.ronn index 01a3018413..60cb54a9b9 100644 --- a/man/bundle.ronn +++ b/man/bundle.ronn @@ -30,20 +30,20 @@ We divide `bundle` subcommands into primary commands and utilities. ## PRIMARY COMMANDS -* [`bundle install(1)`][bundle-install]: +* [`bundle install(1)`][bundle-install(1)]: Install the gems specified by the `Gemfile` or `Gemfile.lock` -* [`bundle update(1)`][bundle-update]: +* [`bundle update(1)`][bundle-update(1)]: Update dependencies to their latest versions -* [`bundle package(1)`][bundle-package]: +* [`bundle package(1)`][bundle-package(1)]: Package the .gem files required by your application into the `vendor/cache` directory -* [`bundle exec(1)`][bundle-exec]: +* [`bundle exec(1)`][bundle-exec(1)]: Execute a script in the context of the current bundle -* [`bundle config(1)`][bundle-config]: +* [`bundle config(1)`][bundle-config(1)]: Specify and read configuration options for bundler * `bundle help(1)`: @@ -51,44 +51,44 @@ We divide `bundle` subcommands into primary commands and utilities. ## UTILITIES -* `bundle add(1)`: +* [`bundle add(1)`][bundle-add(1)]: Add the named gem to the Gemfile and run `bundle install` -* `bundle binstubs(1)`: +* [`bundle binstubs(1)`][bundle-binstubs(1)]: Generate binstubs for executables in a gem -* `bundle check(1)`: +* [`bundle check(1)`][bundle-check(1)]: Determine whether the requirements for your application are installed and available to bundler -* `bundle show(1)`: +* [`bundle show(1)`][bundle-show(1)]: Show the source location of a particular gem in the bundle -* [`bundle outdated(1)`][bundle-outdated]: +* [`bundle outdated(1)`][bundle-outdated(1)]: Show all of the outdated gems in the current bundle * `bundle console(1)`: Start an IRB session in the context of the current bundle -* `bundle open(1)`: +* [`bundle open(1)`][bundle-open(1)]: Open an installed gem in the editor * [`bundle lock(1)`][bundle-lock]: Generate a lockfile for your dependencies -* `bundle viz(1)`: +* [`bundle viz(1)`][bundle-viz(1)]: Generate a visual representation of your dependencies -* `bundle init(1)`: +* [`bundle init(1)`][bundle-init(1)]: Generate a simple `Gemfile`, placed in the current directory -* [`bundle gem(1)`][bundle-gem]: +* [`bundle gem(1)`][bundle-gem(1)]: Create a simple gem, suitable for development with bundler -* [`bundle platform(1)`][bundle-platform]: +* [`bundle platform(1)`][bundle-platform(1)]: Display platform compatibility information -* `bundle clean(1)`: +* [`bundle clean(1)`][bundle-clean(1)]: Clean up unused gems in your bundler directory * `bundle doctor(1)`: diff --git a/man/gemfile.5.ronn b/man/gemfile.5.ronn index 9baa7f8e3e..9f6bbce93a 100644 --- a/man/gemfile.5.ronn +++ b/man/gemfile.5.ronn @@ -35,7 +35,7 @@ this warning, by using the [`:source` option](#SOURCE) or a ### CREDENTIALS -Some gem sources require a username and password. Use [bundle config(1)][bundle-config] to set +Some gem sources require a username and password. Use [bundle config(1)][bundle-config(1)] to set the username and password for any of the 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. @@ -228,7 +228,7 @@ As with groups, you can specify one or more platforms: gem "ruby-debug", :platforms => :mri_18 gem "nokogiri", :platforms => [:mri_18, :jruby] -All operations involving groups (`bundle install`, `Bundler.setup`, +All operations involving groups ([`bundle install`][bundle-install(1)], `Bundler.setup`, `Bundler.require`) behave exactly the same as if any groups not matching the current platform were explicitly excluded. @@ -465,7 +465,7 @@ software is installed or some other conditions are met. ## GEMSPEC -The [.gemspec](http://guides.rubygems.org/specification-reference/) file is where +The [`.gemspec`](http://guides.rubygems.org/specification-reference/) file is where you provide metadata about your gem to Rubygems. Some required Gemspec attributes include the name, description, and homepage of your gem. This is also where you specify the dependencies your gem needs to run. -- cgit v1.2.1