Linux / Comando info: navegar pelos manuais GNU

info abre no terminal documentos no formato Info, usado por muitos programas GNU. Esses manuais são organizados em nós, unidades de leitura conectadas por menus, referências cruzadas e índices. Por exemplo, info coreutils abre o manual do GNU Coreutils quando a documentação está instalada.

Para programas com documentação extensa como GNU Coreutils, os documentos Info frequentemente fornecem explicações mais detalhadas sobre conceitos, interações de opções e exemplos. Este artigo explica como abrir documentos, navegar entre nós e menus, pesquisar no texto e índice, ir diretamente para um local específico no documento e o que fazer se o documento estiver ausente.

O que é o comando info?

info é um leitor de arquivos Info, normalmente gerados a partir do sistema de documentação Texinfo. Os arquivos costumam ficar em diretórios como /usr/share/info. Um manual pode reunir vários nós, frequentemente organizados em capítulos e seções.

Os documentos Info podem incluir menus para navegar para subtemas, referências cruzadas apontando para outros nós ou manuais, e índices específicos por assunto. Eles são adequados não apenas para ler os itens necessários em ordem, mas também para seguir explicações relacionadas ou consultar termos no índice.

Sintaxe básica e como começar

O esquema abaixo apresenta a sintaxe, sem ser um comando pronto para executar. Substitua os campos pelos valores desejados; os colchetes indicam partes opcionais e as reticências indicam repetição. Nos exemplos seguintes, digite somente os comandos concretos.

info [opções...] [manual] [item-de-menu-ou-índice...]

Se executado sem argumentos, o menu do diretório de nível superior reunindo os documentos Info registrados no sistema será aberto.

info

Quando os respectivos manuais estão instalados, info info abre uma introdução ao sistema Info e info info-stnd abre o manual do leitor GNU independente. A presença do executável, por si só, não garante que esses dois documentos estejam disponíveis.

info info
info info-stnd

Se um nome de programa específico for especificado, ele procura a entrada relacionada no diretório de nível superior e navega até esse manual ou nó.

info ls
info coreutils

info ls pode vincular ao nó relacionado ao ls dentro do manual GNU Coreutils, em vez de um arquivo ls.info separado. Isso ocorre porque as entradas do diretório de nível superior podem apontar diretamente para nós específicos dentro de um manual.

Compreendendo a estrutura dos documentos Info

Quando executado pela primeira vez, pode parecer complicado devido a termos que diferem das páginas da web comuns ou do man. Compreender os quatro conceitos a seguir facilita a compreensão da estrutura do documento.

No topo da tela, os nomes do arquivo e do nó atuais, assim como alvos de navegação como Next, Prev e Up podem ser exibidos. Na linha de modo inferior, o status como o manual atual, o nó e a posição dentro do documento é mostrado.

Teclas usadas para mover a tela e navegar pelos documentos

A tabela abaixo é baseada nas teclas padrão do GNU Info independente. Algumas teclas podem diferir dependendo das configurações do usuário ou da opção --vi-keys.

Ao usá-lo pela primeira vez, é recomendado abrir info info-stnd, pressionar H para verificar as teclas básicas e ler o documento usando Space e Backspace.

Como seguir menus e referências cruzadas

Selecionando itens na tela com Tab e Enter

Se um menu ou referência cruzada estiver visível na tela, você pode se mover entre os itens com Tab e selecionar com Enter. Shift+Tab retorna ao item anterior. Essa é uma forma direta de navegar quando você ainda não conhece a estrutura do documento.

Digitando nomes de menu com m

Pressione m para digitar o nome do item de menu na área de entrada na parte inferior da tela. Você pode então digitar parte do nome e usar Tab para verificar os itens que podem ser completados, facilitando mover-se rapidamente em um menu longo.

Após ler outro documento seguindo o menu, use l para retornar à posição original. Se você quiser se mover para um nó superior na estrutura, deve usar u em vez do histórico de visitas.

Como procurar o conteúdo desejado dentro do documento

Pesquisando texto no corpo principal

Pressione s ou /, digite a busca e confirme com Enter. O leitor procura no arquivo Info atual e seleciona o nó com a ocorrência encontrada. Por padrão, uma busca sem letras maiúsculas ignora diferenças de caixa; uma letra maiúscula torna a busca sensível à caixa. Na configuração descrita pelo GNU Info 7.3, o padrão de busca é uma expressão regular; R alterna entre expressão regular e texto literal.

? pesquisa para trás. Para repetir a busca com o termo anterior, pressione s e confirme o valor proposto com Enter. Na configuração padrão, n continua sendo navegação para o próximo nó, não para a próxima ocorrência. Ctrl+s e Ctrl+r oferecem busca incremental para frente e para trás; se o terminal interceptar uma combinação, use a busca com s ou /.

Encontrando tópicos no índice

i pesquisa o termo inserido no índice do manual atual e se move para o nó apontado pela primeira entrada correspondente. Isso pode ser mais rápido e preciso do que pesquisar em todo o texto ao procurar nomes de opções ou conceitos em manuais longos.

I coleta entradas de índice correspondentes em um nó virtual para exibição. Após uma pesquisa i, pressionar a tecla vírgula (,) move para a próxima entrada de índice correspondente.

Pesquisando todos os índices de Info instalados

No shell, info -k ou info --apropos procura o termo nos índices dos manuais instalados, imprime os resultados e termina. Essa busca não equivale a procurar em todo o texto. Se houver muitos manuais, ela pode demorar; se não houver índices correspondentes, o resultado pode ficar vazio. Os termos em inglês abaixo dependem do conteúdo instalado.

info -k permissions
info --apropos='regular expression'

Abrir um manual ou nó diretamente

Abrir pelo nome do manual ou programa

Se você souber o nome do manual, pode especificá-lo diretamente. Toda a documentação do GNU Coreutils pode ser aberta da seguinte maneira.

info coreutils

Se entradas específicas do programa estiverem registradas no diretório de nível superior, você pode ir diretamente ao nó relevante dentro do manual usando apenas o nome do programa.

info ls
info cp
info date

Os exemplos dependem tanto da documentação do GNU Coreutils quanto das entradas correspondentes no diretório Info. Ter apenas os executáveis ls, cp e date instalados não garante a presença do manual.

Especificar um nome de nó

Você pode especificar o nó inicial para abrir com -n ou --node. Nomes de nós com espaços devem ser colocados entre aspas para que sejam passados como um único argumento para o shell.

info coreutils -n 'ls invocation'

Você também pode especificar o formato de referência cruzada Info (manual)node como um único argumento. Coloque toda a string entre aspas para que parênteses e espaços não sejam interpretados pelo shell.

info '(coreutils)ls invocation'

O nome do nó pode variar dependendo da versão do documento instalada. Se você não tiver certeza do nome exato, é mais seguro navegar primeiro usando info ls ou uma pesquisa no índice.

Encontrando nós que expliquem como executar comandos

-O, --show-options ou --usage encontram nós de Invocação que expliquem como executar o programa especificado a partir da linha de comando.

info ls -O
info --show-options coreutils

Dependendo da estrutura da documentação, você pode não encontrar um nó de Invocação adequado. Nesse caso, abra-o com info programa e use a busca de índice de i.

Opções de info usadas com frequência

As opções abaixo se referem ao leitor GNU Info independente. Consulte info --help para a versão instalada e info info-stnd para sua documentação, quando disponível. A referência oficial de opções de execução do GNU Info explica os detalhes e as interações entre opções.

Localizar arquivos Info e exportar texto

Conferir o arquivo selecionado

-w exibe a localização do arquivo que o Info seleciona sem abrir o documento. Isso permite verificar qual documento é lido quando vários arquivos com o mesmo nome existem no caminho de busca.

info -w coreutils

Em ambientes que suportam todos os caminhos de arquivo correspondentes, pode ser usado com --all.

info --all --where coreutils

Exportando documentos para um arquivo de texto

Com -o, o conteúdo é escrito em um arquivo em vez de abrir uma sessão interativa. Escolha um nome de saída ainda não utilizado no diretório atual antes de executar o exemplo. --subnodes inclui recursivamente os nós ligados pelos menus do manual; não copia automaticamente manuais externos apontados por referências.

info --subnodes -o coreutils.txt coreutils

Se você especificar - como o arquivo de saída, pode enviá-lo para a saída padrão, facilitando a conexão com outros comandos.

info -o - coreutils | less

A exportação completa pode ser grande. Confirme a conclusão do comando e a existência de conteúdo no arquivo; depois, abra coreutils.txt em um editor ou com less coreutils.txt. Se precisar apenas de uma seção, combine -n com um nome de nó válido. O exemplo com -o - envia a saída ao paginador less; use q para sair dele.

Especificando documentos do usuário e caminhos de pesquisa

Abrindo diretamente arquivos locais do Info

Arquivos Info no diretório atual podem ser abertos especificando um caminho relativo. Se uma barra for incluída no caminho, ela direciona para o arquivo naquela localização em vez de pelo caminho de busca geral.

info ./project.info
info -f ./project.info

Arquivos Info comprimidos também podem ser lidos diretamente se o formato for suportado pela implementação.

Adicionar diretórios de busca

Você pode adicionar diretórios para buscar documentos usando -d. Isto é útil para abrir temporariamente a documentação de ferramentas instaladas fora do caminho do sistema.

info -d /opt/example/share/info example

INFOPATH influencia o caminho de busca de arquivos Info. No Linux, seus diretórios são separados por dois-pontos; a presença de um dois-pontos ao final permite incluir a lista padrão de compilação. O GNU Info também acrescenta seu diretório padrão de documentação. Antes de alterar a variável, confira o valor atual e o arquivo selecionado por info -w; não suponha que uma variável vazia signifique ausência de todos os caminhos padrão.

printf '%s\n' "$INFOPATH"
info -w info-stnd

Diferenças entre info e man

Você não precisa usar apenas um deles. Quando quiser verificar rapidamente o significado de uma opção, man ou --help é conveniente, e quando quiser ver o conceito geral dos programas GNU e as relações entre as opções em profundidade, info é útil. Escolha a ferramenta apropriada dependendo do formato do documento fornecido pelo programa e do status da instalação.

Quando info ou o manual não estão disponíveis

Instalando o programa info

Em instalações mínimas, o executável info pode estar ausente. O Debian e o Fedora oferecem um pacote chamado info; o repositório oficial do Rocky Linux 9 também o lista. Execute somente o bloco apropriado à sua distribuição. Esses comandos instalam pacotes e exigem privilégios administrativos.

sudo apt update
sudo apt install info

sudo dnf install info

Como os nomes dos pacotes podem variar dependendo da versão da distribuição e da configuração do repositório, se ele não estiver instalado, verifique os resultados da busca de pacotes para essa distribuição.

Verifique se a documentação Info de um programa específico está instalada

Instalar o leitor não instala necessariamente todos os manuais. Abra o diretório geral e procure o nome ou tema desejado. Nos dois últimos comandos abaixo, substitua program or topic pelo termo de pesquisa e manual pelo nome real do manual; esses campos são exemplos de preenchimento.

info
info -k 'program or topic'
info -w manual

Se o leitor abrir, mas o manual não for localizado, procure o pacote de documentação do programa na sua distribuição e versão. Alguns contêineres excluem arquivos de documentação durante a instalação; nesse caso, instalar o leitor ou editar o menu não recupera os arquivos ausentes.

Quando o documento não aparece no menu de diretório

Se o arquivo existir, mas não aparecer no menu do diretório, tente abri-lo por nome de arquivo ou com um diretório de busca adicional. Os caminhos do exemplo abaixo são campos a substituir pelos caminhos existentes no seu sistema; eles não representam arquivos instalados automaticamente.

info -d /additional/document/path manual
info -f /full/path/manual.info

Se o software foi instalado diretamente da fonte, verifique também se o processo de instalação atualizou os arquivos do diretório Info. Antes de modificar manualmente o registro da documentação do sistema, verifique primeiro os registros de instalação do pacote e as instruções de instalação do programa.

Ordem prática de uso

1. Verifique se o documento relevante abre com o programa info.
2. Verifique a ajuda das teclas com o H, e navegue pela estrutura com Space, n, p, u.
3. Selecione os menus exibidos na tela usando Tab e Enter ou m.
4. Se você souber o termo exato, pesquise no índice com i, e para frases gerais, pesquise o texto com s ou /.
5. Se você não souber qual manual usar, pesquise em todo o índice instalado a partir do shell com info -k palavra.
6. Se você quiser visualizar um local repetidamente, especifique o nó diretamente com -n ou exiba o conteúdo necessário com -o.

Perguntas frequentes

Como você sai do info?

Pressione q para sair. Se você não souber as configurações de tecla atuais, pressione H maiúsculo para verificar a ajuda rápida.

Por que n muda de nó em vez de repetir a busca?

Nas configurações de tecla padrão, n move para o nó Next do nó atual, não para os resultados da pesquisa. Use s ou / para pesquisa de texto, e i para pesquisa por índice. As combinações de teclas podem mudar se você usar --vi-keys.

Qual é a diferença entre info ls e info coreutils?

info ls encontra a entrada ls no diretório de nível superior e vai diretamente para o nó relacionado, enquanto info coreutils abre o local inicial do manual do Coreutils. Dependendo das entradas de diretório instaladas e da versão do documento, o nó inicial real pode variar.

Todos os comandos têm documentos Info?

Não. O Info é amplamente usado no projeto GNU, mas nem todos os programas Linux fornecem documentos Info. Se não houver documento Info, verifique man comando, comando --help ou a documentação oficial do programa.

Os documentos Info são sempre mais precisos do que os manuais man?

Não é sempre o caso. Cada projeto possui diferentes documentos de referência e métodos de atualização. Alguns projetos, como o GNU Coreutils, fornecem o manual Info como um documento de referência detalhado, enquanto outros programas podem priorizar páginas man ou documentos na web. Recomenda-se verificar tanto a versão do programa atualmente instalada quanto a documentação oficial do projeto.

Resumo

info permite que você navegue pelos longos manuais dos programas GNU através de nós, menus, referências cruzadas e índices. A princípio, você pode ler a maior parte da documentação apenas aprendendo info programa, H, Space, n, p, u, i e q.

É eficiente verificar rapidamente a sintaxe e as opções simples com --help ou man, e usar info para conceitos de base e exemplos quando necessário. Se você quiser consultar outros comandos básicos, pode consultar a referência de comandos Linux em português.

Documentação oficial

• Manual Oficial GNU Info Independente
• Como executar GNU Info e opções
• Manual Oficial GNU Coreutils
• Informações do pacote info do Debian
• Informações do pacote info do Fedora
• Manual info(1) distribuído pelo Debian 13