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".

-n, --name=TEXTO
    descrição para o parágrafo NOME

-s, --section=SEÇÃO
    número da seção para a página do manual (1, 6, 8)

-m, --manual=TEXTO
    nome do manual (Comandos do usuário, ...)

-S, --source=TEXTO
    origem do programa (FSF, Debian, ...)

-L, --locale=TEXTO
    seleciona a localidade (padrão: "C")

-i, --include=ARQUIVO
    inclui o material de "ARQUIVO"

-I, --opt-include=ARQUIVO
    inclui o material de "ARQUIVO", se ele existir

-o, --output=ARQUIVO
    envia a saída para ARQUIVO

-p, --info-page=TEXTO
    nome do manual Texinfo

-N, --no-info
    suprime o apontador para o manual Texinfo

-l, --libtool
    exclui a parte "lt-" do nome do programa

--help
    emite esta ajuda e sai

--version
    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:

-h, --help-option=TEXTO
    o texto para a opção de ajuda

-v, --version-option=TEXTO
    o texto para a opção de versão

--version-string=TEXTO
    o texto da versão

--no-discard-stderr
    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, 2022 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.