man page (Português)
Páginas man — abreviação para "páginas de manual" e tradução de man pages em inglês — são a forma de documentação que está disponível na maioria dos sistemas operacionais tipo UNIX, incluindo o Arch Linux. O comando usado para exibi-los é man
.
Apesar de seu escopo, páginas man são projetadas para serem documentos autocontidos, consequentemente limitando-as a fazer referência a outras páginas man ao discutir assuntos relatados. Esse é um contraste nítido com os documentos info compatíveis com hiperlinks, a tentativa do GNU de substituir o formato tradicional de página man.
Instalação
man-db implementa man no Arch Linux, e o less é o paginador padrão usado com man. mandoc também pode ser usado.
man-pages fornece as páginas man do Linux e do POSIX.1 (veja [1][link inativo 2023-05-06 ⓘ]).
Algumas páginas man localizadas também estão disponíveis:
- man-pages-cs para tcheco
- man-pages-da para dinamarquês
- man-pages-de para alemão
- man-pages-es para espanhol
- man-pages-fr para francês
- man-pages-hu para húngaro
- man-pages-it para italiano
- man-pages-jaAUR para japonês
- man-pages-mk para macedônio
- man-pages-nl para holandês
- man-pages-pl para polonês
- man-pages-pt_br para português brasileiro
- man-pages-ro para romeno
- man-pages-ru para russo
- man-pages-trAUR para turco
- man-pages-zh_cn para chinês simplificado
- man-pages-zh_tw para chinês tradicional
Você também pode pesquisar todas as páginas de manual localizadas disponíveis nos repositórios oficiais e no AUR.
Você pode usar alguns aplicativos para visualizar páginas man:
- GNOME Help — Visualização de ajuda para o GNOME. Ele pode mostrar páginas man via
yelp man:<nome>
ou a combinação de teclas não documentadaCtrl+L
a partir de uma janela existente.
- KHelpCenter — Aplicativo para mostrar documentação dos aplicativos do KDE. Páginas man estão em Páginas de manual do UNIX ou executando
khelpcenter man:<nome>
.
- Konqueror — Gerenciador de arquivos e navegador web do KDE. Ele pode mostrar páginas man via
man:<nome>
.
- xman — Fornece um visual categorizado em páginas man.
Acessando páginas man
Para ler uma página man, basta digitar:
$ man nome_página
Manuais são ordenados em diversas seções. Cada seção tem uma introdução, tal como intro(1), intro(2) e por aí vai. Para uma listagem completa, veja a seção intitulada "Sections of the manual pages" no man-pages(7).
Páginas man geralmente são referenciadas por seu nome, seguido do número de sua seção em parênteses. Geralmente há múltiplas páginas man com o mesmo nome, tal como man(1) e man(7). Neste caso, forneça ao man o número da seção seguido pelo nome da página man. Por exemplo:
$ man 5 passwd
para ler a página man sobre /etc/passwd
, em vez do utilitário passwd
.
Ou, de forma equivalente, a página man seguida pelo número da seção, separado por um ponto:
$ man passwd.5
Pesquisando por manuais
As páginas man podem ser pesquisadas quando o nome exato de uma página não é conhecido usando qualquer um dos seguintes comandos equivalentes:
$ man -k expressão $ man --apropos expressão $ apropos expressão
expressão
é interpretada como uma expressão regular por padrão.
Para pesquisar palavras-chaves em textos de páginas inteiras, use a opção -K
.
man-db.service
, que é acionada periodicamente pelo man-db.timer
. Se você estiver recebendo uma mensagem "nada apropriado" para cada pesquisa, tente gerar novamente manualmente o cache executando mandb
como root.Descrições de uma linha podem ser exibidas usando o comando whatis
. Por exemplo, para uma descrição breve das seções de página man sobre ls
, digite:
$ whatis ls
ls (1p) - list directory contents ls (1) - list directory contents
Largura de página
A largura de páginas man é controlada pela variável de ambiente MANWIDTH
.
Se o número de colunas no terminal é pequeno demais (ex.: a largura da janela é estreita), as quebras de linha ficarão erradas. Isso pode ser bem incômodo para ler. Você pode corrigir isso definindo MANWIDTH na invocação de man
. Com Bash
, isso seria:
~/.bashrc
man() { local width=$(tput cols) [ $width -gt $MANWIDTH ] && width=$MANWIDTH env MANWIDTH=$width \ man "$@" }
Lendo páginas man locais
Em vez da interface padrão, o uso de navegadores como lynx e Firefox para visualizar páginas man permite que os usuários colham o principal benefício de texto hiperlink das páginas info. As alternativas incluem o seguinte:
Conversão para HTML
mandoc
Instale o pacote mandoc. Para converter uma página, por exemplo free(1)
:
$ mandoc -Thtml -Ostyle=style.css /usr/share/man/man1/free.1.gz > free.html
Agora, abra o arquivo chamado free.html
em seu navegador favorito.
man2html
Primeiro, instale man2html dos repositórios oficiais.
Agora, converta uma página man:
$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html
Outro uso para man2html
é exportar para texto não tratado, no formato de impressão:
$ man free | man2html -bare > ~/free.txt
man -H
A implementação de man-db também tem a capacidade de fazer isso por conta própria:
$ man -H free
Isso vai ler sua variável de ambiente BROWSER
para determinar o navegador. Você pode sobrepor isso passando o executável para a opção -H
.
roffit
Primeiro, instale roffitAUR do AUR.
Para converter uma página man:
$ gunzip -c /usr/share/man/man1/free.1.gz | roffit > free.html
Conversão para PDF
Páginas man sempre foram imprimíveis: elas são escritas em troff(1), que é fundamentalmente uma linguagem de formatação de texto. Portanto, você pode facilmente converter páginas man para qualquer um dos formatos suportados como dispositivos de saída por groff, que é usado por man-db. Para uma lista de dispositivos de saída, veja a opção -T
em groff(1) (ou mandoc(1) se você usar o pacote mandoc).
Isso vai produzir um arquivo PDF:
$ man -Tpdf página_man > arquivo
Ressalvas: Fontes são geralmente limitadas a Times em tamanhos fixos. Algumas páginas man foram projetadas especificamente para ver no terminal e não ficarão bem na forma de PS ou PDF.
Páginas man online
Há vários bancos de dado online de páginas man, incluindo:
- Páginas de manual do Arch — contém páginas man de pacotes do Arch Linux. Usado para links de páginas man do wiki. Você também pode usar o bang
!archman
do DuckDuckGo para pesquisar pelas páginas de manual do Arch diretamente. - man7.org — O projeto man-pages do Linux. Upstream do pacote man-pages.
- manned.org — coleção de várias distribuições Linux, BSD, etc. com múltiplas versões de pacotes
- linux.die.net
- man.cx
- Páginas man do Debian
- Páginas man do Ubuntu
- Páginas man do DragonFlyBSD
- Páginas man do FreeBSD
- Páginas man do NetBSD
- Páginas man do OpenBSD
- Manual do Plan 9 — Volume 1
- Manual do Inferno — Volume 1
- Repositório de páginas man do UNIX and Linux Forums
Observe que enquanto man-pages fornece as páginas man para POSIX.1 (veja [2][link inativo 2023-05-06 ⓘ]), uma referência online oficial também existe:
Há também uma tabela comparativa dos bancos de dados online.
Páginas man notáveis
Aqui está uma lista não exaustiva de páginas dignas de nota que podem lhe ajudar a entender muitas coisas em profundidade. Alguns deles podem servir como uma boa referência (como a tabela ASCII).
- ascii(7)
- boot(7)
- charsets(7)
- chmod(1)
- credentials(7)
- fstab(5)
- file-hierarchy(7)
- systemd(1)
- locale(1p), locale(5), locale(7)
- printf(3)
- proc(5)
- regex(7)
- signal(7)
- term(5), term(7)
- termcap(5)
- terminfo(5)
- utf-8(7)
De forma mais geral, dê uma olhada nas páginas de categoria 7 (miscelânea):
$ man -s 7 -k ".*"
Páginas específicas do Arch Linux:
- alpm-hooks(5)
- libalpm(3)
- makepkg(8)
- makepkg.conf(5)
- makepkg-template(1)
- mkinitcpio(8)
- pacman(8)
- pacman.conf(5)
- pacman-conf(8)
- pacman-key(8)