.\" Automatically generated by Pod::Man 4.09 (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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "DH_INSTALLDOCS 1"
.TH DH_INSTALLDOCS 1 "2017-08-01" "10.7.2+exp.buildlabels" "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_installdocs \- Instala documentación en los directorios de construcción
del paquete
.SH "SINOPSIS"
.IX Header "SINOPSIS"
\&\fBdh_installdocs\fR [\fIopciones-de-debhelper\fR] [\fB\-A\fR] [\fB\-X\fR\fIelemento\fR]
[\fIfichero\fR ...]
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
\&\fBdh_installdocs\fR es un programa de debhelper responsable de instalar
documentación en \fIusr/share/doc/paquete\fR en los directorios de construcción
del paquete.
.PP
In compat 10 and earlier, \fIdh_install\fR\|(1) may be a better tool for handling
the upstream documentation, when upstream's own build system installs all
the desired documentation correctly.  In this case, \fBdh_installdocs\fR is
still useful for installing packaging related documentation (e.g. the
\&\fIdebian/copyright\fR file).
.PP
In compat 11 and later, \fBdh_installdocs\fR offers many of the features that
\&\fIdh_install\fR\|(1) also have.  Furthermore, \fBdh_installdocs\fR also supports
the \fBnodoc\fR build profile to exclude documentation (regardless of compat
level).
.SH "FICHEROS"
.IX Header "FICHEROS"
.IP "debian/\fIpaquete\fR.docs" 4
.IX Item "debian/paquete.docs"
Lista los ficheros de documentación a instalar en el \fIpackage\fR.
.IP "\fIdebian/copyright\fR" 4
.IX Item "debian/copyright"
El fichero «copyright» se instala en todos los paquetes, a menos que se
disponga de un fichero «copyright» más específico.
.IP "debian/\fIpaquete\fR.copyright" 4
.IX Item "debian/paquete.copyright"
.PD 0
.IP "debian/\fIpaquete\fR.README.Debian" 4
.IX Item "debian/paquete.README.Debian"
.IP "debian/\fIpaquete\fR.TODO" 4
.IX Item "debian/paquete.TODO"
.PD
Se instalará automáticamente cada uno de estos ficheros si están presentes
para el \fIpaquete\fR.
.IP "\fIdebian/README.Debian\fR" 4
.IX Item "debian/README.Debian"
.PD 0
.IP "\fIdebian/TODO\fR" 4
.IX Item "debian/TODO"
.PD
Estos ficheros se instalan en el primer paquete binario listado en
«debian/control».
.Sp
Tenga en cuenta que \fI\s-1README\s0.debian\fR también se instala como
\&\fI\s-1README\s0.Debian\fR, y que \fI\s-1TODO\s0\fR se instalará como \fI\s-1TODO\s0.Debian\fR en paquetes
no nativos.
.IP "debian/\fIpaquete\fR.doc\-base" 4
.IX Item "debian/paquete.doc-base"
Installed as doc-base control files. Note that the doc-id will be determined
from the \fBDocument:\fR entry in the doc-base control file in question. In the
event that multiple doc-base files in a single source package share the same
doc-id, they will be installed to usr/share/doc\-base/package instead of
usr/share/doc\-base/doc\-id.
.IP "debian/\fIpaquete\fR.doc\-base.*" 4
.IX Item "debian/paquete.doc-base.*"
If your package needs to register more than one document, you need multiple
doc-base files, and can name them like this. In the event that multiple
doc-base files of this style in a single source package share the same
doc-id, they will be installed to usr/share/doc\-base/package\-* instead of
usr/share/doc\-base/doc\-id.
.SH "OPCIONES"
.IX Header "OPCIONES"
.IP "\fB\-A\fR, \fB\-\-all\fR" 4
.IX Item "-A, --all"
Instala todos los ficheros especificados en los parámetros de la línea de
órdenes en \s-1TODOS\s0 los paquetes sobre los que actúa.
.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 lugar de su
nombre. Tenga en cuenta que esto incluye ficheros de doc-base.
.IP "\fB\-\-link\-doc=\fR\fIpaquete\fR" 4
.IX Item "--link-doc=paquete"
Hace que el directorio de documentación de todos los paquetes sobre los que
se actúa sea un enlace simbólico al directorio de documentación del
\&\fIpaquete\fR. No tiene efecto cuando se actúa sobre el mismo \fIpaquete\fR, o si
el directorio de documentación a crear ya existe al ejecutar
\&\fBdh_installdocs\fR. Para cumplir las normas, el \fIpaquete\fR debe ser un
paquete binario que se origina del mismo paquete fuente.
.Sp
debhelper intentará evitar instalar ficheros en directorios de documentación
enlazados que podrían causar un conflicto con el paquete enlazado. La opción
\&\fB\-A\fR no tendrá efecto sobre los paquetes con directorios de documentación
enlazados, y no se instalarán los ficheros \fIcopyright\fR, \fIchangelog\fR,
\&\fI\s-1README\s0.Debian\fR y \fI\s-1TODO\s0\fR.
.Sp
(Otro método, aún permitido, es hacer del directorio de documentación un
enlace simbólico colgante, «dangling», antes de invocar \fBdh_installdocs\fR.)
.Sp
\&\fB\s-1CAVEAT 1\s0\fR: If a previous version of the package was built without this
option and is now built with it (or vice-versa), it requires a \*(L"dir to
symlink\*(R" (or \*(L"symlink to dir\*(R") migration.  Since debhelper has no knowledge
of previous versions, you have to enable this migration itself.
.Sp
This can be done by providing a "debian/\fIpackage\fR.maintscript" file and
using \fIdh_installdeb\fR\|(1) to provide the relevant maintainer script
snippets.
.Sp
\&\fB\s-1CAVEAT 2\s0\fR: The use of \fB\-\-link\-doc\fR should only be done when the packages
have same \*(L"architecture\*(R" type.  A link from a architecture independent
package to a architecture dependent package (or vice versa) will not work.
Since compat 10, debhelper will actively reject unsupported combinations.
.IP "\fIfichero\fR ..." 4
.IX Item "fichero ..."
Instala esos ficheros como documentación en el primer paquete sobre el que
actúa (o en todos si se especifica \fB\-A\fR).
.SH "EJEMPLOS"
.IX Header "EJEMPLOS"
A continuación se muestra un ejemplo de un fichero \fIdebian/paquete.docs\fR:
.PP
.Vb 6
\&  README
\&  TODO
\&  debian/notes\-for\-maintainers.txt
\&  docs/manual.txt
\&  docs/manual.pdf
\&  docs/manual\-html/
.Ve
.SH "NOTAS"
.IX Header "NOTAS"
Tenga en cuenta que \fBdh_installdocs\fR copiará sin problemas jerarquías de
directorio enteras si se le indica (similar a \fBcp \-a\fR). Si le indica
instalar un directorio instalará todos los contenidos de éste.
.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