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.

           Se  o  autor  fornecer um directório examples, você vai muitas vezes querer usar examples/* em vez de
           examples neste  ficheiro.  O  posterior  irá  criar  /usr/share/doc/pacote/examples/examples,  o  que
           raramente é o que você quer.

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

13.24.2ubuntu1                                     2025-05-22                              DH_INSTALLEXAMPLES(1)