捆绑有 man 命令吗？

Question

有一个命令bundle在ruby。

我想man对bundle. 它存在吗？如果有，我想知道如何查找像bundle gem.

我可以在网上看到它，但我更喜欢在命令行中阅读它。 http://bundle.io/v1.12/man/bundle-gem.1.html

Answer 1

当然，bundle-gem在线手册是从bundle-gem.ronn文件创建的。并且ronn是一种格式（和程序），旨在格式化为手册页。

首先让我们获取文件（forbundler-gem和ronn）：

git clone https://github.com/bundler/bundler.git
gem install ronn  # this actually depends on mustache, rdiscount and hpricot

并创建手册页：

$ /home/grochmal/.gem/ruby/2.3.0/bin/ronn -r bundler/man/bundle-gem.ronn 
     roff: bundler/man/bundle-gem.1

（您可能在 PATH 中有 gem 路径，但我在这里添加了它以防万一。也-r代表roffie 用于手册页的格式）

并查看联机帮助页：

man bundler/man/bundle-gem.1

如果您希望联机帮助页在您确实man bundle-gem将其放置在合理的位置并将该位置添加到MANPATH. 例如：

mkdir ~/man{,/man1}
cp bundler/man/bundle-gem.1 ~/man/man1/
export MANPATH=$MANPATH:~/man

（注意这里使用 man 部分）

附加说明

由于ronn用途，hpricot您可以ronn -5 <file.ronn>用来生成您正在阅读的网络手册。

gem将为ronn您运行，因此如果您安装了bundler，gem您将在~/.gem/ruby/<version>/gems/bundler-<version>/man. 不幸的是，gem它没有遵循将 man 部分划分为目录 ( man1, man2, ...)的 *nix 约定，因此从中检索手册页可能很麻烦~/.gem（MANPATH此处不可以使用 using ）。

如果您还没有MANPATH设置，那么您的系统正在使用/etc/man_db.conf. 在这种情况下，您应该设置MANPATH为：

export MANPATH=`manpath`:~/man