man é um (porém não o único) programa de linha de comando de sistemas *nix para leitura de manpages.
Acredite: é bom você que usa linux aprender a usar o man... sob pena de receber num fórum de ajuda uma recomendação do tipo RTFM _ "Read The Fucking Manual". (Fonte: wikipédia)
Eis abaixo a forma mais comum de usá-lo:
A tabela a seguir mostra os números de seção do manual seguido pelos tipos de páginas que contém.
1 Programas executáveis, ou comandos do shell
2 Chamadas de sistema (funções oferecidas pelo kernel)
3 Chamadas de biblioteca (funções dentro de bibliotecas do programa)
4 Arquivos especiais (normalmente localizado em /dev )
5 formatos de arquivos e convenções, por exemplo /etc/passwd
6 Jogos
7 Diversos (incluindo pacotes de macros e convenções), por exemplo, o man(7), groff(7)
8 Comandos de administração do Sistema (normalmente, apenas para o root)
9 Rotinas do Kernel [ no-standard ]
O que isso tudo significa? Que se você olhar dentro do diretório onde estão as manpages, verá que estão divididas por subdiretórios denominados por "man" + esses números, definido por convenções POSIX sobre esse tema. Esse diretório costuma ser /usr/share/man .
Uma página de manual é composta por várias seções.
Nomes de seções convencionais incluem NOME, SINOPSE, CONFIGURAÇÃO, DESCRIÇÃO, OPÇÕES, STATUS DE SAÍDA, VALOR DE RETORNO, ERROS, MEIO AMBIENTE, ARQUIVOS, VERSÕES, DE ACORDO COM, NOTAS, BUGS, POR EXEMPLO, AUTORES, e VER TAMBÉM.
(Fonte: manpage do sistema linux.)
Veja um exemplo:
O exemplo dado é o da manpage do mplayer. Repare no destaque em NAME, SYNOPSIS e DESCRIPTION. Estas são as seções. Note que o nome do programa aparece destacado em negrito.
As seguintes convenções se aplicam à seção sinopse e podem ser usadas como orientação em outras seções:
tipo de texto em negrito exatamente como mostrado.
substituir texto em itálico com o argumento apropriado.
[ABC] -->>para qualquer um ou todos os argumentos dentro de [] são opcionais.
-a |-b -->> opções delimitadas por | não podem ser usados juntos.
argumento ... -->> argumento pode ser repetido. Ex: touch file1 file2 file3
[expressão] ... -->> expressão inteira dentro de [] pode ser repetida.
O modo de exibição de um comando ou função é um padrão que deve corresponder a todos os usos possíveis. Em alguns casos é conveniente ilustrar diversas invocações exclusivas.
Exemplos
$ man ls
Mostra a página do item (programa) ls.
$ man -a intro
Mostra, sucessivamente, as introduções de todas as páginas de manuais disponíveis no manual. É possível parar entre as telas sucessivas ou ignorar qualquer uma.
$ man -t alias | lpr -Pps
Formata a página do manual referenciada por 'alias', geralmente uma manpage Shell, no formato padrão troff ou groff e canalisa isso para a impressora chamada ps. A saída padrão para groff é geralmente PostScript. man --help deve informá-lo que o processo está ligado à opção -t.
$ man -l mplayer.1.gz > Mplayer.txt
O switche -l fará com que o man não faça a busca da manpage nos diretórios-padrão: é necessário dar o caminho absoluto do arquivo, ou ele procurará o arquivo no path atual. Esta opção é usada quando se deseja extrair o texto formatado pelo man para, por ex., um arquivo de texto. No ex. acima, a formatação do man é redirecionada para o arquivo Mplayer.txt . Se não fosse feito esse redirecionamento, o man mostraria o resualtado na saída padrão.
$ man -k printf
Busca nas descrições curtas e páginas de manual pela palavra-chave printf como expressão reegular. Imprime tudo que for encontrado. Equivalente a apropos -r printf.
$ man -f smail
Pesquisa páginas de manual referenciados por smail e imprime as breves descrições de quaisquer que forem encontrados. Equivalente a whatis -r smail.
(Fonte: manpage do sistema linux, sob GNU-LGPL)
Também podemos ver todos os comandos dando a opção "ALL" (todos) dentro do man. Com o seguinte comando isso é possivel ser feito: ~# man /All.
No site http://www.linuxmanhelp.com tem a lista completa de comandos que o man traz.
(Fonte: Linux Man Help)
Outros comandos também são os chamados Files (arquivos)
/ etc / manpath.config
man-db arquivo de configuração.
/ usr / share / man
A hierarquia da página global manual.
/ usr / share / man / index. (BT | db | dir | pag)
A cache de dados tradicionais índice global.
/ var / cache / man / index. (BT | db | dir | pag)
FHS um cache de dados compatível Global Index.
(Fonte: manpage do sistema linux, sob GNU-LGPL)
Como configurar o seu Man para português?
Primeiro baixe o arquivo com a tradução: http://br.tldp.org/ ( Projeto de Documentação Linux (tradução de manuais)).
Agora verifique se o man está instalado por default com o comando: $ set | grep MANPATH
Provavelmente você encontrará o arquivo em: /usr/man ou /usr/local/man, veja se existe o diretório pt_BR dentro deles, se não houver crie-o (como root) com o comando:
cd /usr/man
mkdir pt_BR
Agora extraia os arquivos que você baixou (ainda como root):
cd /tmp
tar -vxzf man-todas.tgz
Agora ele irá criar uma árvore com raiz desta forma:
Configure a variavel de ambiente LANG como usuário, assim: $ export LANG=pt_BR
você pode incluir esta linha no seu arquivo .bashrc, .profile ou .login para que ela seja executada automaticamente sempre (o export é usado no Shell Bourne, no C Shell a sintaxe é diferente, ao invés de export use setenv).
man
Acredite: é bom você que usa linux aprender a usar o man... sob pena de receber num fórum de ajuda uma recomendação do tipo RTFM _ "Read The Fucking Manual". (Fonte: wikipédia)
Eis abaixo a forma mais comum de usá-lo:
A tabela a seguir mostra os números de seção do manual seguido pelos tipos de páginas que contém.
1 Programas executáveis, ou comandos do shell
2 Chamadas de sistema (funções oferecidas pelo kernel)
3 Chamadas de biblioteca (funções dentro de bibliotecas do programa)
4 Arquivos especiais (normalmente localizado em /dev )
5 formatos de arquivos e convenções, por exemplo /etc/passwd
6 Jogos
7 Diversos (incluindo pacotes de macros e convenções), por exemplo, o man(7), groff(7)
8 Comandos de administração do Sistema (normalmente, apenas para o root)
9 Rotinas do Kernel [ no-standard ]
O que isso tudo significa? Que se você olhar dentro do diretório onde estão as manpages, verá que estão divididas por subdiretórios denominados por "man" + esses números, definido por convenções POSIX sobre esse tema. Esse diretório costuma ser /usr/share/man .
Uma página de manual é composta por várias seções.
Nomes de seções convencionais incluem NOME, SINOPSE, CONFIGURAÇÃO, DESCRIÇÃO, OPÇÕES, STATUS DE SAÍDA, VALOR DE RETORNO, ERROS, MEIO AMBIENTE, ARQUIVOS, VERSÕES, DE ACORDO COM, NOTAS, BUGS, POR EXEMPLO, AUTORES, e VER TAMBÉM.
(Fonte: manpage do sistema linux.)
Veja um exemplo:
O exemplo dado é o da manpage do mplayer. Repare no destaque em NAME, SYNOPSIS e DESCRIPTION. Estas são as seções. Note que o nome do programa aparece destacado em negrito.
As seguintes convenções se aplicam à seção sinopse e podem ser usadas como orientação em outras seções:
tipo de texto em negrito exatamente como mostrado.
substituir texto em itálico com o argumento apropriado.
[ABC] -->>para qualquer um ou todos os argumentos dentro de [] são opcionais.
-a |-b -->> opções delimitadas por | não podem ser usados juntos.
argumento ... -->> argumento pode ser repetido. Ex: touch file1 file2 file3
[expressão] ... -->> expressão inteira dentro de [] pode ser repetida.
O modo de exibição de um comando ou função é um padrão que deve corresponder a todos os usos possíveis. Em alguns casos é conveniente ilustrar diversas invocações exclusivas.
Exemplos
$ man ls
Mostra a página do item (programa) ls.$ man -a intro
Mostra, sucessivamente, as introduções de todas as páginas de manuais disponíveis no manual. É possível parar entre as telas sucessivas ou ignorar qualquer uma.$ man -t alias | lpr -Pps
Formata a página do manual referenciada por 'alias', geralmente uma manpage Shell, no formato padrão troff ou groff e canalisa isso para a impressora chamada ps. A saída padrão para groff é geralmente PostScript. man --help deve informá-lo que o processo está ligado à opção -t.$ man -l mplayer.1.gz > Mplayer.txt
O switche -l fará com que o man não faça a busca da manpage nos diretórios-padrão: é necessário dar o caminho absoluto do arquivo, ou ele procurará o arquivo no path atual. Esta opção é usada quando se deseja extrair o texto formatado pelo man para, por ex., um arquivo de texto. No ex. acima, a formatação do man é redirecionada para o arquivo Mplayer.txt . Se não fosse feito esse redirecionamento, o man mostraria o resualtado na saída padrão.
$ man -k printf
Busca nas descrições curtas e páginas de manual pela palavra-chave printf como expressão reegular. Imprime tudo que for encontrado. Equivalente a apropos -r printf.$ man -f smail
Pesquisa páginas de manual referenciados por smail e imprime as breves descrições de quaisquer que forem encontrados. Equivalente a whatis -r smail.(Fonte: manpage do sistema linux, sob GNU-LGPL)
Também podemos ver todos os comandos dando a opção "ALL" (todos) dentro do man. Com o seguinte comando isso é possivel ser feito:
~# man /All.
No site http://www.linuxmanhelp.com tem a lista completa de comandos que o man traz.
(Fonte: Linux Man Help)
Outros comandos também são os chamados Files (arquivos)
/ etc / manpath.config
man-db arquivo de configuração.
/ usr / share / man
A hierarquia da página global manual.
/ usr / share / man / index. (BT | db | dir | pag)
A cache de dados tradicionais índice global.
/ var / cache / man / index. (BT | db | dir | pag)
FHS um cache de dados compatível Global Index.
(Fonte: manpage do sistema linux, sob GNU-LGPL)
Como configurar o seu Man para português?
Primeiro baixe o arquivo com a tradução:
http://br.tldp.org/ ( Projeto de Documentação Linux (tradução de manuais)).
Agora verifique se o man está instalado por default com o comando:
$ set | grep MANPATH
Provavelmente você encontrará o arquivo em: /usr/man ou /usr/local/man, veja se existe o diretório pt_BR dentro deles, se não houver crie-o (como root) com o comando:
Agora extraia os arquivos que você baixou (ainda como root):
Agora ele irá criar uma árvore com raiz desta forma:
/tmp/arquivos/man1/
/tmp/arquivos/man2/
/tmp/arquivos/man3/
/tmp/arquivos/man4/
/tmp/arquivos/man5/
/tmp/arquivos/man6/
/tmp/arquivos/man7/
/tmp/arquivos/man8/
Copie os arquivos para o Home de seu man:
Se quiser pode excluir os arquivos originais:
Configure a variavel de ambiente LANG como usuário, assim:
$ export LANG=pt_BR
você pode incluir esta linha no seu arquivo .bashrc, .profile ou .login para que ela seja executada automaticamente sempre (o export é usado no Shell Bourne, no C Shell a sintaxe é diferente, ao invés de export use setenv).
(Fonte: http://www.vivaolinux.com.br/dica/Traduzindo-o-seu-man/)