À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
man <comando> | col -b > <nome_arquivo>.txtExemplo
man ls | col -b > ls_manual.txtIsso cria texto simples que não ficará ilegível quando aberto em um editor de texto comum.
Por que redirecionamento simples não funciona
man ls > ls_bad.txtSalvar 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
man -t ls | pstopdf -i -o ls_manual.pdfLinux
man -t ls > ls.psps2pdf ls.ps ls_manual.pdfA opção -t gera saída no formato PostScript, que é então convertido para PDF.
Resumo das opções
| Método | Comando | Caso de uso |
|---|---|---|
| Texto simples | man … | col -b |
| man -t … | pstopdf | |
| HTML | man2html | Exibição no navegador |
Pessoalmente, texto simples é o mais prático. Buscar e processar é fácil.
hsb.horse