Acabei de construir (a partir do código-fonte) uma versão atual (versão 2.1) no libgpiod
meu RPi 4B. Existem seis (6) "ferramentas de linha de comando" incluídas no tarball de origem do libgpiod
. Durante o make install
processo, essas ferramentas – e suas novas man
páginas – foram instaladas em subpastas em /usr/lib/arm-linux-gnueabihf
.
- páginas de manual:
./share/man/man1
- ferramentas exe binárias:
./bin
Não desinstalei o libgpiod
pacote existente do meu sistema. Por enquanto (até eu descobrir se devo ou não manter a versão 2.1, ou se um pacote atualizado for lançado), estou criando links simbólicos apontando /usr/bin
para as novas ferramentas no /usr/lib/arm-linux-gnueabihf/bin
. Mas não estou claro sobre como lidar com os man
problemas. Quero ver as novas man
páginas; por exemplo, quando eu entro man gpioset
, quero ver a página de manual em /usr/lib/arm-linux-gnueabihf/share/man/man1/gpioset.1
.
Como o RPi OS é um derivado do Debian, eu esperaria que os manuais fossem instalados na convenção IAW Debian (seja lá o que for). Eu executei um whereis
no nome de uma das 6 ferramentas de linha de comando e obtive o seguinte:
$ whereis gpioinfo
gpioinfo: /usr/bin/gpioinfo /usr/bin/gpioinfo.old /usr/share/man/man1/gpioinfo.1.gz
E encontro todos os 6 manuais /usr/share/man/man1
(como arquivos compactados "gzip" ). Suponho que uma maneira de substituir as páginas de manual "novas pelas antigas " seria mover ( mv
) os manuais antigos e colocar links para os novos em seus lugares. Mas eu esperava algo mais elegante do que isso - talvez uma "linha única" em algum lugar que apontasse para a localização dos novos manuais no formato /usr/lib/arm-linux-gnueabihf/share/man/man1
. Existe tal one-liner ?
Existe uma maneira de configurar isso ad hoc - até que o novo libgpiod
pacote seja lançado?
Existem várias opções diferentes, dependendo da versão exata
man
que você instalou. Até agora identifiquei arquivos de configuração chamados/etc/man.conf
,/etc/man_db.conf
,/etc/manpath.config
. Felizmente, aquele que você precisa deve ser referenciado emman man
e pode ser descrito pelo nome (por exemplo,man man.conf
). No entanto, você não deve precisar editá-los sozinho e aqui estão duas sugestões, dependendo se você precisa que as páginas de manual sejam acessíveis por vários usuários ou apenas por você:Coloque suas páginas de manual no diretório nomeado corretamente em um local conhecido do sistema. Para instalações locais, normalmente seria
/usr/local/share/man
. Então você moveria ou copiaria os arquivos do seu local./share/man/man1
para o diretório/usr/local/share/man/man1
.Defina a variável de ambiente
MANPATH
como uma lista de árvores de diretórios separadas por dois pontos para procurar páginas de manual. O fator um pouco complicador aqui é saber o caminho de busca original, e em alguns sistemas você pode executarmanpath
(ou talvezmanpath -g
) para obter esse valor.Aqui estão algumas sugestões que devem funcionar, sendo a primeira preferida: