man page (Português)

Status de tradução:
Esse artigo é uma tradução de
Man page
. Data da última tradução: 2022-08-01. Você pode ajudar a sincronizar a tradução, se houver
alterações
na versão em inglês.
Artigos relacionados
Color output in console#man
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-ja
AUR
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-tr
AUR
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 documentada
Ctrl+L
a partir de uma janela existente.
https://wiki.gnome.org/Apps/Yelp
||
yelp
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>
.
https://userbase.kde.org/KHelpCenter
||
khelpcenter
Konqueror
— Gerenciador de arquivos e navegador web do KDE. Ele pode mostrar páginas man via
man:<nome>
.
https://konqueror.org/
||
konqueror
xman
— Fornece um visual categorizado em páginas man.
https://xorg.freedesktop.org/
||
xorg-xman
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
.
Nota
O recurso de pesquisa é fornecido por um cache dedicado. Por padrão, a manutenção desse cache é tratada pelo
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
roffit
AUR
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:
POSIX.1-2017
Há também uma
tabela comparativa
dos bancos de dados online.
Atenção
Algumas distribuições fornecem páginas man alteradas ou desatualizadas que se diferem daquelas fornecidas pelo Arch. Exercite o cuidado ao usar páginas man 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)
Veja também
Gentoo:man page
Escrevendo o bom manual com pod2man