.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" 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 turned on, 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 "2016-07-24" "9.20150101+deb8u2" "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 "NOMBRE"
.IX Header "NOMBRE"
dh_install \- Instala ficheros en los directorios de construcción del paquete
.SH "SINOPSIS"
.IX Header "SINOPSIS"
\&\fBdh_install\fR [\fB\-X\fR\fIelemento\fR] [\fB\-\-autodest\fR]
[\fB\-\-sourcedir=\fR\fIdirectorio\fR] [\fIopciones-de-debhelper\fR]
[\fIfichero|directorio\fR [...] \fIdirectorio-de-destino\fR]
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
\&\fBdh_install\fR es un programa de debhelper que instala ficheros en los
directorios de construcción del paquete. Hay muchas órdenes
\&\fBdh_install\fR\fI*\fR que se encargan de instalar tipos de ficheros específicos,
como documentación, ejemplos, páginas de manual y más, se deben utilizar
siempre que sea posible, pues a menudo son más hábiles en estas tareas
particulares. Así, \fBdh_install\fR es útil para instalar el resto de las cosas
para las cuales no se necesite ninguna habilidad especial. Es un reemplazo
de la antigua orden \fBdh_movefiles\fR.
.PP
Este programa se puede utilizar de dos modos. Si sólo tiene uno o dos
ficheros que el «Makefile» del desarrollador principal no instala, puede
utilizar \fBdh_install\fR para moverlos a su lugar. Por otro lado, quizá tenga
un gran paquete que construye múltiples paquetes binarios. Puede utilizar el
\&\fIMakefile\fR del desarrollador original para instalar todo en \fIdebian/tmp\fR,
y después utilizar \fBdh_install\fR para copiar los directorios y ficheros
desde ahí a los directorios de construcción del paquete adecuados.
.PP
From debhelper compatibility level 7 on, \fBdh_install\fR will fall back to
looking in \fIdebian/tmp\fR for files, if it doesn't find them in the current
directory (or wherever you've told it to look using \fB\-\-sourcedir\fR).
.SH "FICHEROS"
.IX Header "FICHEROS"
.IP "debian/\fIpaquete\fR.install" 4
.IX Item "debian/paquete.install"
Los ficheros «debian/paquete.install» listan los ficheros a instalar en cada
paquete y el directorio donde se deben instalar. El formato es un conjunto
de líneas, cada línea lista un fichero o ficheros a instalar, y al final de
ésta se encuentra el directorio donde se deben instalar. El nombre de los
ficheros (o directorios) a instalar debe ser relativo al directorio actual,
mientras que el directorio de instalación es relativo al directorio de
construcción del paquete. Se pueden utilizar comodines en los nombres de los
ficheros a instalar (en modo v3 o superior).
.Sp
Tenga en cuenta que si lista exactamente un nombre de fichero o patrón de
comodines en una sola línea, sin ningún destino explícito, \fBdh_install\fR
averiguará automáticamente el destino, al igual que si se utiliza la opción
«\-\-autodest».
.SH "OPCIONES"
.IX Header "OPCIONES"
.IP "\fB\-\-list\-missing\fR" 4
.IX Item "--list-missing"
Esta opción hace que \fBdh_install\fR registre los ficheros que instala y, al
final, compare esa lista con los ficheros en el directorio fuente. Si alguno
de los ficheros (o enlaces simbólicos) en el directorio fuente no se
instalaron en algún lugar, dará un aviso a través de la salida de error
estándar.
.Sp
Puede ser útil si tiene un paquete grande y quiere comprobar que no olvida
instalar ningún fichero nuevo añadido en una nueva versión del programa.
.Sp
Tenga en cuenta de que no avisa de los ficheros excluidos mediante la opción
\&\fB\-X\fR.
.IP "\fB\-\-fail\-missing\fR" 4
.IX Item "--fail-missing"
Esta opción es como \fB\-\-list\-missing\fR, excepto que si olvida un fichero, no
sólo se listarán los ficheros olvidados, sino que además se devolverá un
código de salida distinto de cero.
.IP "\fB\-X\fR\fIelemento\fR, \fB\-\-exclude=\fR\fIelemento\fR" 4
.IX Item "-Xelemento, --exclude=elemento"
No instala ficheros que contienen \fIelemento\fR en cualquier parte de su
nombre.
.IP "\fB\-\-sourcedir=\fR\fIdirectorio\fR" 4
.IX Item "--sourcedir=directorio"
Busca en el directorio especificado los ficheros a instalar.
.Sp
Tenga en cuenta que no es igual que la opción \fB\-\-sourcedirectory\fR utilizada
por las órdenes \fBdh_auto_\fR\fI*\fR. Rara vez utilizará esta opción, ya que
\&\fBdh_install\fR busca ficheros de forma automática en \fIdebian/tmp\fR con el
nivel de compatibilidad 7 y posterior.
.IP "\fB\-\-autodest\fR" 4
.IX Item "--autodest"
Averigua el directorio dónde instalar las cosas. Si se define, no debería
listar los directorios de destino en los ficheros \fIdebian/paquete.install\fR
o en la línea de órdenes. En vez de esto, \fBdh_install\fR lo averiguará del
siguiente modo:
.Sp
Si está presente, elimina \fIdebian/tmp\fR (o el «sourcedir», si se
proporciona) del principio del nombre del fichero, y lo instala en el
directorio que forma parte del nombre del fichero. Esto es, si el nombre del
fichero es \fIdebian/tmp/usr/bin\fR, el directorio se copiará a
\&\fIdebian/paquete/usr/\fR. Si el nombre del fichero es
\&\fIdebian/tmp/etc/passwd\fR, se copiará a \fIdebian/paquete/etc/\fR.
.IP "\fIfichero|destino\fR ... \fIdirectorio-de-destino\fR" 4
.IX Item "fichero|destino ... directorio-de-destino"
Lista los ficheros (o directorios) a instalar y el lugar dónde se
instalarán. Los ficheros se instalarán en el primer paquete sobre el que
actúe \fBdh_install\fR.
.SH "LIMITACIONES"
.IX Header "LIMITACIONES"
\&\fBdh_install\fR no puede renombrar ficheros o directorios, sólo puede
instalarlos con los nombres que ya tengan en el lugar que desee en el árbol
de construcción del paquete.
.SH "VÉASE TAMBIÉN"
.IX Header "VÉASE TAMBIÉN"
\&\fIdebhelper\fR\|(7)
.PP
Este programa es parte de debhelper.
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>
.SH "TRADUCTOR"
.IX Header "TRADUCTOR"
Traducci�n de Rub�n Porras Campo <debian\-l10n\-spanish@lists.debian.org>
Actualizaci�n de Omar Campagne Polaino