Scroll to navigation

HELP2MAN(1) Comandos de usuário HELP2MAN(1)

NOME

help2man - gera uma página de manual simples

SINOPSE

help2man [OPÇÃO]... EXECUTÁVEL

DESCRIÇÃO

"help2man" gera uma página de manual (man page) a partir da saída das opções "--help" e "--version".

descrição para o parágrafo NOME
número da seção para a página do manual (1, 6, 8)
nome do manual (Comandos do usuário, ...)
origem do programa (FSF, Debian, ...)
seleciona a localidade (padrão: "C")
inclui o material de "ARQUIVO"
inclui o material de "ARQUIVO", se ele existir
envia a saída para ARQUIVO
nome do manual Texinfo
suprime o apontador para o manual Texinfo
exclui a parte "lt-" do nome do programa
emite esta ajuda e sai
emite o número da versão e sai

O EXECUTÁVEL deveria aceitar as opções "--help" e "--version" e produzir a saída para a saída padrão, embora alternativas podem ser especificadas usando:

o texto para a opção de ajuda
o texto para a opção de versão
o texto da versão
inclui o texto no erro padrão ao analisar a saída das opções

ARQUIVOS INCLUSOS

Materiais adicionais podem ser incluídos na saída gerada com as opções --include e --opt-include. O formato é simples:


[seção]
texto


/padrão/
texto

Blocos de texto *roff literais são inseridos na saída ou no início de uma dada [seção] (indiferente à maiusculização), ou após um parágrafo que coincida com o /padrão/.

Os padrões usam a sintaxe Perl de expressão regular e podem ser seguidos pelos modificadores i, s ou m (veja perlre(1)).

As linhas antes da primeira seção ou de um padrão que comece com "-" são processados como opções. Qualquer outra coisa é ignorada silenciosamente e pode ser usada para comentários, palavras-chaves RCS e coisas do tipo.

A ordem da saída das seções é:


NOME
SINOPSE
DESCRIÇÃO
OPÇÕES
outra
AMBIENTE
ARQUIVOS
EXEMPLOS
AUTOR
RELATANDO PROBLEMAS
DIREITOS AUTORAIS
VEJA TAMBÉM

Quaisquer seções [NAME] ou [SINOPSIS] que apareçam no arquivo de inclusão substituirá o que seria produzido automaticamente (embora você ainda possa sobrepor o primeiro com --name se necessário).

Outras seções são acrescentadas antes da saída produzida automaticamente para as seções padrões citadas acima ou inclusas na posição outra (acima) na ordem em que elas forem encontradas no arquivo de inclusão.

A localização do texto dentro da seção pode ser requisitada explicitamente usando a sintaxe [<seção], [=seção] ou [>seção] para colocar o texto adicionar antes, sobre ou após a saída padrão, respectivamente.

DISPONIBILIDADE

A última versão desta distribuição está disponível on-line em:


ftp://ftp.gnu.org/gnu/help2man/

AUTOR

Escrito por Brendan O'Dea <bod@debian.org>

RELATANDO PROBLEMAS

Relate problemas para <bug-help2man@gnu.org>.

DIREITOS AUTORAIS

Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021 Free Software Foundation, Inc.
Este é um software livre; veja o código-fonte para as condições de cópia. NÃO HÁ GARANTIAS; nem mesmo para COMERCIALIZAÇÃO ou ADAPTAÇÃO PARA UM FIM ESPECÍFICO.

VEJA TAMBÉM

A documentação completa para help2man é mantida como um manual Texinfo. Se info e os programas help2man estiverem instalados apropriadamente em sua máquina, o comando

info help2man

deveria lhe fornecer acesso ao manual completo.

março de 2021 GNU help2man 1.48.2