.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_INSTALL 1" .TH DH_INSTALL 1 "2019-02-23" "12.1.1" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOME" .IX Header "NOME" dh_install \- instala ficheiros em directórios de compilação de pacotes .SH "RESUMO" .IX Header "RESUMO" \&\fBdh_install\fR [\fB\-X\fR\fIitem\fR] [\fB\-\-autodest\fR] [\fB\-\-sourcedir=\fR\fIdirectório\fR] [\fIopções do debhelper\fR] [\fIficheiro|directório\fR ... \fIdirectório de destino\fR] .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" \&\fBdh_install\fR é um programa debhelper que lida com a instalação de ficheiros em directórios de compilação de pacotes. Existem muitos comandos \&\fBdh_install\fR\fI*\fR 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 \fBdh_install\fR é útil para instalar tudo o resto, para qual não é necessária inteligência particular. É um substituto do antigo comando \fBdh_movefiles\fR. .PP 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 \&\fBdh_install\fR 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 \fIdebian/tmp\fR, e depois usar o \fBdh_install\fR para copiar directórios e ficheiros de lá para para os directórios apropriados de compilação de pacotes. .PP From debhelper compatibility level 7 on, \fBdh_install\fR will fall back to looking in \fIdebian/tmp\fR for files, if it does not find them in the current directory (or wherever you've told it to look using \fB\-\-sourcedir\fR). .SH "FICHEIROS" .IX Header "FICHEIROS" .IP "debian/\fIpacote\fR.install" 4 .IX Item "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. .Sp 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 \fBdh_install\fR irá adivinhar automaticamente o destino a usar, do mesmo modo em que se a opção \-\-autodest fosse usada. .IP "debian/not\-installed" 4 .IX Item "debian/not-installed" Used with the deprecated \fB\-\-list\-missing\fR and \fB\-\-fail\-missing\fR options. Please refer to \fBdh_missing\fR\|(1) for the documentation of this file. .SH "OPÇÕES" .IX Header "OPÇÕES" .IP "\fB\-\-list\-missing\fR" 4 .IX Item "--list-missing" \&\fBDeprecated\fR: Please use \fBdh_missing \-\-list\-missing\fR instead. If you use this option, \fBdh_install\fR will call \fBdh_missing\fR with that option after it has processed all the files. Please see \fBdh_missing\fR\|(1) for the documentation of this option. .Sp This option is removed in compat 12. .IP "\fB\-\-fail\-missing\fR" 4 .IX Item "--fail-missing" \&\fBDeprecated\fR: Please use \fBdh_missing \-\-fail\-missing\fR instead. If you use this option, \fBdh_install\fR will call \fBdh_missing\fR with that option after it has processed all the files. Please see \fBdh_missing\fR\|(1) for the documentation of this option. .Sp This option is removed in compat 12. .IP "\fB\-\-sourcedir=\fR\fIdirectório\fR" 4 .IX Item "--sourcedir=directório" Procura no directório especificado por ficheiros a instalar. .Sp Note que isto não é o mesmo que a opção \fB\-\-sourcedirectory\fR usada pelos comandos \fBdh_auto_\fR\fI*\fR. Você raramente vai precisar de usar esta opção, pois o \fBdh_install\fR procura automaticamente por ficheiros em \fIdebian/tmp\fR no nível de compatibilidade 7 e superiores do debhelper. .IP "\fB\-\-autodest\fR" 4 .IX Item "--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 \&\fIdebian/package.install\fR nem na linha de comandos. Em vez disso, o \&\fBdh_install\fR irá adivinhar no método que se segue: .Sp Despoja \fIdebian/tmp\fR (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 \fIdebian/tmp/usr/bin\fR, então esse directório será copiado para \fIdebian/package/usr/\fR. Se o nome de ficheiro for \fIdebian/tmp/etc/passwd\fR, será copiado para \&\fIdebian/package/etc/\fR. .IP "\fIficheiro|dir\fR ... \fIdestdir\fR" 4 .IX Item "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 \fIdh_install\fR actua. .SH "LIMITAÇÕES" .IX Header "LIMITAÇÕES" \&\fBdh_install\fR não pode renomear ficheiros ou directórios, pode apenas instalá\-los com os nomes que já têm para onde você os deseja na árvore de compilação do pacote. .PP No entanto, o renomear pode ser conseguido ao usar o \fBdh-exec\fR com compatibilidade 9 ou posterior. Um ficheiro exemplo debian/\fIpacote\fR.install que usa o \fBdh-exec\fR poderá ser parecer com: .PP .Vb 2 \& #!/usr/bin/dh\-exec \& debian/default.conf => /etc/my\-package/start.conf .Ve .PP Por favor lembre-se das três coisas seguintes: .IP "\(bu" 4 O pacote tem se usar nível de compatibilidade 9 ou superior veja \&\fBdebhelper\fR\|(7)) .IP "\(bu" 4 O pacote irá precisar de uma dependência de compilação em dh-exec. .IP "\(bu" 4 O ficheiro install tem de ser marcado como executável. .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" \&\fBdebhelper\fR\|(7) .PP Este programa é parte do debhelper. .SH "AUTOR" .IX Header "AUTOR" Joey Hess .SH "TRADUÇÃO" .IX Header "TRADUÇÃO" Américo Monteiro .PP Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro \fIa_monteiro@gmx.com\fR ou Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.