Definitivamente , o manual online bundle-gem
foi criado a partir do bundle-gem.ronn . E ronn
é um formato (e programa) que deve ser formatado como uma página man.
Primeiro, vamos pegar os arquivos (para bundler-gem
e ronn
):
git clone https://github.com/bundler/bundler.git
gem install ronn # this actually depends on mustache, rdiscount and hpricot
E crie a página man:
$ /home/grochmal/.gem/ruby/2.3.0/bin/ronn -r bundler/man/bundle-gem.ronn
roff: bundler/man/bundle-gem.1
(Você provavelmente tem o caminho gem no PATH, mas eu adicionei aqui apenas no caso. Também -r
representa roff
, ou seja, o formato usado para páginas man)
E veja a manpage:
man bundler/man/bundle-gem.1
Se você quiser que a página de manual seja exibida quando você fizer man bundle-gem
, coloque-a em algum lugar razoável e adicione esse local a MANPATH
. Por exemplo:
mkdir ~/man{,/man1}
cp bundler/man/bundle-gem.1 ~/man/man1/
export MANPATH=$MANPATH:~/man
(Observe o uso de seções homem aqui)
Notas extras
Como ronn
usa hpricot
, você pode usar ronn -5 <file.ronn>
para gerar o manual da web que estava lendo.
gem
executará ronn
para você, portanto, se você instalou bundler
com gem
, você terá a página de manual em ~/.gem/ruby/<version>/gems/bundler-<version>/man
. Infelizmente, gem
não segue a convenção * nix de dividir seções man em diretórios ( man1
, man2
, ...), portanto, pode ser problemático recuperar as páginas man de ~/.gem
(usando MANPATH
não é uma opção aqui).
Se você ainda não tiver o MANPATH
definido, seu sistema está usando /etc/man_db.conf
. Nesse caso, você deve definir MANPATH
como:
export MANPATH='manpath':~/man