Existe comando man para pacote?

3

Existe um comando bundle in ruby .

Eu quero usar o comando man ou função semelhante para bundle . Isto existe? Se houver, quero saber como procurar um comando separado como bundle gem .

Eu posso ver on-line, mas prefiro lê-lo na linha de comando. link

    
por ironsand 07.10.2016 / 02:00

1 resposta

5

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
    
por 07.10.2016 / 03:19

Tags