NOME¶

dh_installexamples - instala ficheiros exemplo em directórios de compilação de pacotes

RESUMO¶

dh_installexamples [debhelper opções] [-A] [-Xitem] [ficheiro ...]

DESCRIÇÃO¶

dh_installexamples é um programa debhelper responsável por instalar exemplos em usr/share/doc/package/examples nos directórios de compilação de pacotes.

Desde nível de compatibilidade 11 do debhelper em diante, o dh_install irá procurar os ficheiros em debian/tmp, se não os encontrar no directório actual (ou onde você o mandou procurar usando --sourcedir).

FICHEIROS¶

debian/pacote.examples

Lista ficheiros ou directórios exemplo para serem instalados.

If upstream provides an examples directory, you will often want to use examples/* rather than examples in this file. The latter would create /usr/share/doc/package/examples/examples, which is rarely what you want.

Suporta variáveis de substituição em compatibilidade 13 e posterior como documentado em debhelper(7).

OPÇÕES¶

-A, --all

Instala quaisquer ficheiros especificados pelos parâmetros de linha de comandos em TODOS os pacotes em que actua.

--sourcedir=directório

Procura no directório especificado por ficheiros para serem instalados. Esta opção requer compatibilidade 11 ou posterior (é ignorada em silêncio na compatibilidade 10 ou anterior).

Note que isto não é o mesmo que a opção --sourcedirectory usada pelos comandos dh_auto_*. Você raramente vai precisar de usar esta opção, pois o dh_installexamples procura automaticamente por ficheiros em debian/tmp no nível de compatibilidade 11 e superiores do debhelper.

--doc-main-package=main-package

Define o pacote principal para pacote de documentação. Isto é usado para a documentação do pacote de documentação em /usr/share/doc/main-package como recomendado pelo manual de políticas Debian 3.9.7 em §12.3.

Em compatibilidade 11 (ou posterior), esta opção apenas é útil se a auto-detecção do debhelper do pacote principal está errada. A opção também pode ser usada para silenciar um aviso do debhelper quando a auto-detecção falha mas acontece a predefinição estar correcta.

Esta opção não pode ser usada quando dh_installexamples é instruído para actuar em múltiplos pacotes. Se precisar desta opção, você irá geralmente precisar de combiná-la com -p para assegurar exactamente que um pacote é actuado.

-Xitem, --exclude=item

Exclui de serem instalados ficheiros que tenham item em qualquer ponto no seu nome de ficheiro.

ficheiro ...

Instala estes ficheiros (ou directórios) como exemplos no primeiro pacote em que actua. (Ou em todos os pacotes se for especificado -A).

NOTAS¶

Note que dh_installexamples irá alegremente copiar as hierarquias de directórios inteiras se lho pedir (semelhante a cp -a). Se lhe for pedido para instalar um directório, ele irá instalar o conteúdo completo do directório.

VEJA TAMBÉM¶

debhelper(7)

Este programa é parte do debhelper.

AUTOR¶

Joey Hess <joeyh@debian.org>

TRADUÇÃO¶

Américo Monteiro

Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro a_monteiro@gmx.com ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.