Atualize o seu homem pager para obter uma melhor ajuda do Linux

Fiel à filosofia do Linux, a visualização de páginas de ajuda é um esforço de equipe. Enquanto o comando MAN é o que você realmente digita, ele se baseia em uma ferramenta de pager separada para exibir seu conteúdo real. Descubra quais são as implicações desse sistema e como ele pode melhorar sua experiência de obter ajuda.

O que o homem faz com um pager?

O comando MAN exibe páginas de documentação para vários comandos, chamadas de sistema, funções da biblioteca e muito mais. Ele busca essas informações de arquivos de texto simples no formato da página MAN, geralmente localizado em um diretório como/usr/share/man/.

Algumas páginas do homem são curtas, mas a maioria é mais longa que pelo menos uma tela de texto. Para exibir essas páginas, o programa MAN usa uma ferramenta chamada Pager, um conceito comum no Linux.

Um pager é simplesmente qualquer ferramenta que exiba o conteúdo de um arquivo de texto, com algum suporte para mover o arquivo uma linha – ou uma tela – por vez.

Sem um pager, o homem simplesmente despejará todo o conteúdo de uma página de homem no seu terminal de uma só vez, deixando você apenas com a página final, que varia de acordo com o tamanho da janela do terminal:

Com um pager, por outro lado, o homem mostrará que você ajudará uma página de cada vez:

Um dos grandes pontos fortes do Linux é sua tendência a fornecer programas pequenos e focados que desempenham funções específicas. Usando vários programas juntos, você pode realizar tarefas complexas sem software dedicado. Um pager incorpora essa filosofia: o programa Man se concentra em procurar páginas de ajuda e formatar seu texto, enquanto um pager se concentra em exibir peça de texto por peça.

Como mudar seu homem pager

Os programas Linux geralmente fornecem algumas maneiras de mudar seu comportamento, e o homem não é exceção. Os principais caminhos são:

• Opções da linha de comando.
• Variáveis ​​de ambiente.
• Arquivos de configuração.

Cada método tem seus benefícios, e o que você escolher geralmente depende se você deseja que a configuração seja permanente e quão amplamente você deseja que ela se aplique.

A primeira abordagem é usar uma opção de linha de comando. O programa MAN suporta uma opção -p para substituir o pager que ele usaria:

         man -P pager
     

Por exemplo, para procurar a página de ajuda para LS, usando o menos pager:

         man -P less ls
     

E procurar ajuda para o próprio homem, usando o mais pager:

         man -P more man
     

Você deve observar que o pager pode ser qualquer comando válido, incluindo seus próprios argumentos e até tubos:

         man -P "grep operand | wc -l" ls
     

Uma boa alternativa a esse argumento da linha de comando é uma variável de ambiente. O Linux geralmente usa o ENVVARS para configuração e dois são relevantes neste caso:

• O pager é uma configuração amplamente usada que deve indicar seu pager preferido para uso geral. Os programas de suporte colocarão sua saída através do comando nomeado em pager.
• Manpager substitui o pager, especificamente para o comando man. Embora outros programas sejam gratuitos para usar esse valor, você deve descobrir que apenas o homem realmente o faz. Isso permite especificar facilmente um pager para o homem que difere do seu pager em geral.

Você pode definir variáveis ​​de ambiente para todos os usuários em/etc/ambiente ou para o seu usuário específico em um arquivo como ~/.bash_profile; Isso varia de acordo com o shell que você está usando.

Como em qualquer comando, você pode definir a variável de ambiente para apenas uma única execução prefixando o comando:

         MANPAGER=most man pwd
     

Por fim, se sua versão do MAN suportar um arquivo de configuração, você poderá usá -lo para alterar o pager que o homem usa permanentemente.

Se você possui um arquivo man.conf, a sintaxe para definir o pager é semelhante a definir uma variável de ambiente:

         MANPAGER less -s     

A desvantagem dessa abordagem é que ela -aparentemente -sobrevive variáveis ​​de ambiente e o argumento da linha de comando -P. Portanto, uma vez definido, esse valor é aplicado para todos os usuários do sistema. Isso pode, raramente, ser exatamente o que você deseja, mas na maioria das vezes você terá mais controle se evitar usar o arquivo de configuração do homem para definir o pager.

Os melhores pagers para usar com o homem

Até agora, você pode reconhecer o valor de um bom pager, mas me pergunto quais são realmente bons – ou até quais pagers estão disponíveis. Para uma ferramenta tão simples, há realmente um número surpreendente de opções, mas você provavelmente já usará apenas um punhado delas.

Como padrão, o homem geralmente usa o menos pager, especificamente este comando:

         less -Sr     

O programa menos, lançado em 1984, substitui um pager mais velho nomeado maisde 1978. Embora um comando mais geralmente esteja disponível, pode ser o mesmo que menos no seu sistema, simplificando ou apenas sendo uma cópia direta. Por exemplo, no macOS tahoe, correndo diff/usr/bin/menos/usr/bin/mais não relata diferenças; Os dois binários executáveis ​​são idênticos.

O principal avanço que menos trazido foi rolar para trás; Acredite ou não, mas a versão original de More só poderia rolar para a frente. Usando menos, você pode rolar para a frente uma página de cada vez pressionando Espaçoe uma linha de cada vez com Digitar. Role de volta uma página com b E uma linha de cada vez com y.

Você também pode rolar a meia páginas de cada vez, o que pode facilitar o controle do seu contexto. Usar u rolar para trás (para cima) por meia página e d Para rolar para frente (para baixo) por meia página.

maioria é um pager relativamente novo que foi lançado em 2005. Escrito em C, é rápido e tem um pequeno executável (125K).

Muitos dos recursos da maioria podem ser úteis em um pager, mas não fazem muita diferença nas páginas do homem. Os recursos de janela do pager não podem ser facilmente usados ​​com o homem, e a rolagem horizontal não deve ser necessária, pois o homem já envolve longas filas.

Dito isto, alguns recursos podem ser úteis. O sinalizador -c torna as pesquisas sensíveis ao caso, que podem ser úteis para navegar nos títulos nas páginas MAN, que estão sempre em maiúsculas.

O argumento “+/pesquisa” também é muito útil. Use isso para rolar automaticamente para a primeira partida, por exemplo:

         man -P 'most +/symbolic' ls
     

Mais um pager de nota é ov. Este é um lançamento mais recente, lançado em 2020, e o programa está escrito em Go, com excelente documentação. O projeto ainda explica o melhor uso do OV com várias outras ferramentas, incluindo o homem.

Ov suporta um extenso conjunto de comandos interativos, que você pode visualizar a qualquer momento pressionando H:

Um dos meus recursos favoritos é básico, mas muito útil: G para alternar os números de linha. Embora o OV mostre o número atual da linha no fundo direito, isso pode ser fácil de perder, e os números de linha podem ajudá-lo a se orientar, especialmente dentro de páginas mais longas.

Como o mais pager, o OV pode exibir mais de um arquivo de uma só vez. Mas, ao contrário da maioria, ele pode abrir vários arquivos da linha de comando, por isso é possível ler mais de uma página de um homem de uma só vez, usando a substituição do processo:

         ov <(man ls) <(man pwd)
     

Na interface do OV, você pode pressionar ] para se mudar para o próximo arquivo e [[[ Para o anterior. Embora seja um pouco estranho de usar, esse recurso pode ser útil ao comparar as páginas do homem de dois comandos semelhantes. Você pode até usá -lo para comparar as páginas MAN para duas versões diferentes do mesmo comando.

Onde o OV realmente brilha é sua configuração. Um exemplo de uma pequena vitória é a opção de cabeçalho, que define o número de linhas de cabeçalho fixas:

         man -P 'ov --header 1' man
     

Isso é ótimo para visualizar as páginas do homem, já que a primeira linha é um bom cabeçalho que lembra qual página você está visualizando ajuda:

A opção -header mantém essa linha sempre à vista, para que você não se perca, mesmo com várias páginas de homem abertas em diferentes janelas de terminal.

Outra opção útil é–seção-delimitador. Ov permite usar isso para definir onde as seções ocorrem no documento que você está visualizando. Você pode navegar entre as seções usando o espaço para avançar e ^ para voltar para trás. Como as páginas do homem têm seções claramente definidas, isso é muito útil:

         man -P 'ov --section-delimiter "^[^s]"' man
     

O delimitador aqui é uma expressão regular que corresponde às linhas que começam com um caractere não espacial. Como as páginas do Man Pages Formato seção títulos como este, com todos os outros conteúdos recuados pelo espaço em branco, isso divide uma página de um homem em seções, com fácil navegação entre elas.

Como bônus, você também receberá cabeçalhos da seção que permanecem fixos na seção atual, como uma versão mais avançada da opção -Header:

Seu pager geralmente é uma ferramenta simples, então você seria perdoado por não pensar muito. Mas pagers mais novos como o OV podem, com um pouco de investimento, tornam as páginas de ajuda de leitura uma tarefa mais rápida e mais fácil.