Quando usar man and man -k para checar as páginas de manual?

Question

Quando se deve usar man e quando man -k para verificar páginas man? Sempre que eu gostaria de verificar uma página de um homem, fico confuso com qual deveria ser. Devo usar isto: man -k xyz ou isto: man xyz .

Algumas páginas do manual não são encontradas quando pesquisamos usando man , mas essa mesma página é encontrada por man -k .

Então, por favor, dê uma explicação quando eu devo usar man xyz ou man -k xyz .

    

Answer 1

Fazer um man man mostra o que a opção -k faz para man .

Usando a opção -k

man -k printf
       Search  the  short descriptions and manual page names for the keyword 
       printf as regular expression.  Print out any matches.  Equivalent
       to apropos -r printf.

A ferramenta, apropos mencionada acima, pesquisa nos arquivos de índice, observando os nomes das páginas man e uma breve descrição de cada uma.

homem apropos

Each manual page has a short description available within it.
apropos searches the descriptions for instances of keyword.

Você pode comparar a saída de 2 comandos para se convencer de que eles estão fazendo as mesmas coisas assim:

$ diff <(man -k printf) <(apropos -r printf)
$

Apenas homem

Fazer apenas um man xyz procurará uma página man nos locais definidos quando você faz um man -w .

Exemplo

$ man -w
/usr/local/share/man:/usr/share/man

Portanto, quando eu digitar man xyz , o comando man pesquisará esses diretórios, procurando uma página man que corresponda a xyz .

Linha de fundo?

Portanto, man xyz está procurando páginas man que correspondam ao nome xyz , enquanto man -k xyz está procurando a sequência, "xyz" nos nomes das páginas man, juntamente com a descrição curta para cada homem página.