NOME

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

RESUMO

       dh_install [-Xitem] [--autodest] [--sourcedir=directório] [opções do debhelper]
       [ficheiro|directório ... directório de destino]

DESCRIÇÃO

       dh_install é um programa debhelper que lida com a instalação de ficheiros em directórios
       de compilação de pacotes. Existem muitos comandos dh_install* que lidam com a instalação
       de tipos de ficheiros específicos como documentação, exemplos, manuais, e por ai fora, e
       esses devem ser usados sempre que possível pois geralmente eles têm inteligência extra
       para essas tarefas particulares. Então, o  dh_install é útil para instalar tudo o resto,
       para qual não é necessária inteligência particular. É um substituto do antigo comando
       dh_movefiles.

       Este programa pode ser usado de uma ou duas maneiras. Se você tem apenas um ficheiro ou
       dois que o Makefile do autor não instala por si, pode correr o dh_install neles para os
       mover para a localização. Por outro lado, talvez você tenha um pacote grande que compila
       vários pacotes binários. Você pode usar o Makefile do autor para os instalar todos em
       debian/tmp, e depois usar o dh_install para copiar directórios e ficheiros de lá para para
       os directórios apropriados de compilação de pacotes.

       Desde nível de compatibilidade 7 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.install
           Lista os ficheiros a instalar em cada pacote e o directório onde eles devem ser
           instalados. O formato é um conjunto de linhas, onde cada linha lista um ficheiro ou
           ficheiros a instalar, e no fim da linha diz o directório onde deverão ser instalados.
           O nome dos ficheiros (ou directórios) a instalar devem ser fornecidos relativamente ao
           directório actual, enquanto que o directório de instalação é fornecido relativamente
           ao directório de compilação do pacote. Você pode usar wildcards nos nomes dos
           ficheiros a instalar.

           Note que se você lista exactamente um nome de ficheiro ou um padrão de wildcard numa
           linha sozinho, sem um destino explícito, então o dh_install irá adivinhar
           automaticamente o destino a usar, do mesmo modo em que se a opção --autodest fosse
           usada.

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

       debian/not-installed
           Usado com as opções --list-missing e --fail-missing descontinuadas. Por favor consulte
           dh_missing(1) para a documentação deste ficheiro.

OPÇÕES

       --list-missing
           Descontinuado: Por favor use dh_missing --list-missing em vez deste. Se usar esta
           opção, o dh_install irá chamar dh_missing com essa opção após ter processado todos os
           ficheiros. Por favor veja dh_missing(1) para a documentação sobre esta opção.

           Esta opção foi removida no nível de compatibilidade 12.

       --fail-missing
           Descontinuado: Por favor use dh_missing --fail-missing em vez deste. Se usar esta
           opção, dh_install irá chamar dh_missing com essa opção após ter processado todos os
           ficheiros. Por favor veja dh_missing(1) para a documentação sobre esta opção.

           Esta opção foi removida no nível de compatibilidade 12.

       --sourcedir=directório
           Procura no directório especificado por ficheiros a instalar.

           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_install procura
           automaticamente por ficheiros em debian/tmp no nível de compatibilidade 7 e superiores
           do debhelper.

       --autodest
           Adivinha o directório de destino para onde instalar as coisas. Se isto for
           especificado, você não deve listar directórios de destino nos ficheiros
           debian/package.install nem na linha de comandos. Em vez disso, o dh_install irá
           adivinhar no método que se segue:

           Despoja debian/tmp (ou o sourcedir se for fornecido um) da frente do nome de ficheiro,
           se estiver presente, e instala-lo no nome de directório do nome de ficheiro. Então, se
           o nome de ficheiro for debian/tmp/usr/bin, então esse directório será copiado para
           debian/package/usr/. Se o nome de ficheiro for debian/tmp/etc/passwd, será copiado
           para debian/package/etc/.

       ficheiro|dir ... destdir
           Lista ficheiros (ou directórios) a instalar e onde os instalar. Os ficheiros serão
           instalados no primeiro pacote em que o dh_install actua.

EXEMPLOS

       Aqui estão alguns pequenos exemplos de ficheiros de configuração para dh_install.

           # Install my-prog into usr/bin (as "usr/bin/my-prog")
           my-prog usr/bin

           # Install a plugins directory into usr/share/my-prog
           # (as "usr/share/my-prog/plugins/")
           plugins usr/share/my-prog

           # Install a file with spaces in into usr/share/my-prog/data
           # (as "usr/share/my-prog/data/my datafile with spaces.txt")
           # ASSUMES COMPAT 13, where substitution patterns are available
           my${Space}datafile${Space}with${Space}spaces.txt usr/share/my-prog/data

           # Install a library into the multi-arch lib directory
           # ASSUMES COMPAT 13, where substitution patterns are available
           build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}

LIMITAÇÕES

       dh_install não pode renomear ficheiros ou directórios, pode apenas instala-los com os
       nomes que já têm para onde você os deseja na árvore de compilação do pacote.

       No entanto, o renomear pode ser conseguido ao usar o dh-exec com compatibilidade 9 ou
       posterior. Um ficheiro exemplo debian/pacote.install que usa o dh-exec poderá ser parecer
       com:

        #!/usr/bin/dh-exec
        debian/default.conf => /etc/my-package/start.conf

       Por favor lembre-se das três coisas seguintes:

       •   O pacote tem se usar nível de compatibilidade 9 ou superior veja debhelper(7))

       •   O pacote irá precisar de uma dependência de compilação em dh-exec.

       •   O ficheiro install tem de ser marcado como executável.

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.