logo hsb.horse
← Voltar para o índice de snippets

Snippets

Salvar páginas man em arquivo de texto

Como salvar a saída do comando man em um arquivo no macOS/Linux. Use col -b para remover caracteres de controle e criar texto legível.

Publicado: Atualizado:

Às vezes você quer salvar a saída do comando man em um arquivo para ler em um editor ou compartilhar. Redirecionamento simples mistura caracteres de controle, então processamento posterior adequado é necessário.

Usando col -b

Terminal window
man <comando> | col -b > <nome_arquivo>.txt

Exemplo

Terminal window
man ls | col -b > ls_manual.txt

Isso cria texto simples que não ficará ilegível quando aberto em um editor de texto comum.

Por que redirecionamento simples não funciona

Terminal window
man ls > ls_bad.txt

Salvar como acima gera caracteres de controle como backspaces (usados pelo man para formatação como negrito e sublinhado, aparecendo como ^H, etc.) diretamente no arquivo. Fica muito difícil de ler em editores que não sejam o less.

col -b filtra esses caracteres, deixando apenas o texto como aparece.

Salvando como PDF

Para fins de impressão ou quando você quer PDF, passe por PostScript.

macOS

Terminal window
man -t ls | pstopdf -i -o ls_manual.pdf

Linux

Terminal window
man -t ls > ls.ps
ps2pdf ls.ps ls_manual.pdf

A opção -t gera saída no formato PostScript, que é então convertido para PDF.

Resumo das opções

MétodoComandoCaso de uso
Texto simplesman …col -b
PDFman -t …pstopdf
HTMLman2htmlExibição no navegador

Pessoalmente, texto simples é o mais prático. Buscar e processar é fácil.