.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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 "APT-SRC.ES 1p"
.TH APT-SRC.ES 1p "2021-01-10" "perl v5.32.0" "User Contributed Perl Documentation"
.\" 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"
apt-src \- gestiona árboles de paquetes fuentes de Debian
.SH "SINOPSIS"
.IX Header "SINOPSIS"
\&\fBapt-src\fR [\fIopciones\fR] \fIorden\fR
.PP
\&\fBapt-src\fR [\fIopciones\fR] \fIinstall|remove\fR paq1 [paq2 ...]
.PP
\&\fBapt-src\fR \fIlocalización\fR paq
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
apt-src es una interfaz de línea de órdenes para descargar, instalar,
actualizar, y seguir los paquetes fuentes de Debian. Puede ejecutarse como
usuario normal o como superusuario.
.PP
A diferencia de los paquetes binarios, los paquetes fuentes no se instalan
en un lugar canónico. En lugar de esto, se \*(L"instalan\*(R" desempaquetando el
árbol de las fuentes en un directorio, el cual puede estar donde desee. Un
paquete fuente puede instalarse varias veces en diferentes lugares. Este
programa gestiona los paquetes fuentes instalados de este modo, y
proporciona facilidades de búsqueda para encontrar donde fue instalado un
determinado paquete.
.PP
A menos que se proporcione la opción \-h o \-\-help se debe de proporcionar una
de los siguientes órdenes.
.IP "update" 4
.IX Item "update"
Actualiza la lista de paquetes disponibles. Idéntico que apt-get update,
debe ejecutarse como superusuario en su configuración predeterminada.
.IP "install" 4
.IX Item "install"
Instala los paquetes fuentes nombrados en el directorio actual. Si un
paquete ya está instalado en el directorio actual, intentará actualizarlo.
.Sp
Esta orden aceptará el nombre de paquetes binarios o paquetes fuentes. Igual
que con apt-get install, puede usar como prefijo del nombre =versión o
/distribución para especificar la versión que quiere instalar o de que
distribución desea obtenerla.
.Sp
Se asegurará de que las dependencias de construcción del paquete se
satisfacen.
.Sp
Si se proporciona la opción \-\-location, el paquete fuente se instalará o
actualizará en el lugar indicado en vez de en el directorio actual.
.Sp
Si se proporciona la opción \-\-build, se compilará cada paquete instalado o
actualizado.
.IP "upgrade" 4
.IX Item "upgrade"
Actualiza todos los paquetes fuentes instalados, o, si se proporcionan las
opciones \-\-location o \-\-here, sólo se actualizarán los paquetes fuentes del
directorio especificado.
.Sp
Si se proporciona la opción \-\-patch (por omisión), apt-src intentará generar
un parche que contenga todos los cambios locales hechos al paquete fuente, y
los aplicará al árbol actualizado. Esto permite que los cambios locales se
preserven a través de las actualizaciones de los paquetes, pero es posible
que no siempre funcione, en estos casos deberá combinar los cambios usted
mismo.
.Sp
Si se proporciona la opción \-\-build, se compilará cada paquete instalado o
actualizado.
.IP "remove" 4
.IX Item "remove"
Elimina los paquetes fuentes nombrados. Se pueden usar las opciones
\&\-\-location y \-\-here para eliminar sólo los paquetes de un directorio
determinado.
.IP "build" 4
.IX Item "build"
Construye las fuentes especificadas. Si el paquete fuente no está instalado,
se instalará primero.
.IP "clean" 4
.IX Item "clean"
Limpia el árbol de los paquetes fuentes listados. Se pueden usar las
opciones \-\-location y \-\-here para limpiar sólo los paquetes de un
determinado directorio.
.IP "import" 4
.IX Item "import"
Use esta opción para hacerle saber a apt-src acerca de un paquete fuente ya
desempaquetado. Después del nombre bajo el que será importado debe
especificar la localización del árbol con las fuentes (con \-\-location), y
puede especificar la versión (con \-\-version). No espere que la orden build
funcione en estas fuentes, a menos que tengan un directorio debian/.
.IP "list" 4
.IX Item "list"
Sin ningún otro parámetro, listará todos los paquetes fuentes instalados, su
estado, y el directorio donde fueron instalados. Si se proporciona el nombre
de un paquete, mostrará sólo los ejemplares instalados de ese paquete
fuente. Si se usan las opciones \-\-location o \-\-here, limitarán la lista de
paquetes a los instalados en el directorio especificado.
.IP "location" 4
.IX Item "location"
Sólo acepta un parámetro, el nombre del paquete fuente. Si el paquete está
instalado, devolverá el directorio raíz del árbol de las fuentes del
paquete.
.Sp
Esta orden puede usarse cuando necesite incluir ficheros de otro paquete
fuente, o algo por el estilo. Por ejemplo:
.Sp
.Vb 1
\& \-I\`apt\-src location paquete\`
.Ve
.IP "version" 4
.IX Item "version"
Sólo acepta un parámetro, el nombre del paquete fuente. Si el paquete está
instalado devuelve la versión del paquete.
.IP "name" 4
.IX Item "name"
Sólo acepta un parámetro, el nombre del paquete fuente (puede especificarse
con expresiones regulares). Devuelve el nombre del paquete fuente que
concuerde con el nombre, si es que hay alguno.
.SH "OPCIONES"
.IX Header "OPCIONES"
Todas las opciones de la línea de órdenes pueden incluirse en el fichero de
configuración. Las descripciones indican la opción que es necesario
emplear. Para opciones booleanas puede modificar el comportamiento usando
algo como \-f\-,\-\-no\-f, \-f=no o alguna que otra variante.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Muestra este texto de ayuda.
.IP "\fB\-b\fR, \fB\-\-build\fR, \fB\-\-compile\fR" 4
.IX Item "-b, --build, --compile"
Construye los paquetes fuentes después de instalarlos o actualizarlos.
Opción de configuración: APT::Src::Compile.
.IP "\fB\-i\fR, \fB\-\-installdebs\fR" 4
.IX Item "-i, --installdebs"
Instala los paquetes después de construirlos. Implica \-\-build.  Opción de
configuración: APT::Src::InstallDebs
.Sp
Note que si un paquete fuente genera varios binarios, todos se instalarán.
.IP "\fB\-p\fR, \fB\-\-patch\fR" 4
.IX Item "-p, --patch"
Trata de parchear los cambios locales en el nuevo árbol después de
actualizar. Habilitado por omisión, use \-\-no\-p para deshabilitarlo.  Opción
de configuración: APT::Src::Patch.
.IP "\fB\-l\fR, \fB\-\-location\fR" 4
.IX Item "-l, --location"
Especifica un directorio, sólo opera en paquetes en ese directorio.  Opción
de configuración: APT::Src::Location.
.IP "\fB\-c\fR, \fB\-\-cwd\fR, \fB\-\-here\fR" 4
.IX Item "-c, --cwd, --here"
Sólo operan sobre paquetes en el directorio actual.  Opción de
configuración: APT::Src::Here.
.IP "\fB\-\-upstream\-version\fR" 4
.IX Item "--upstream-version"
Sólo tiene utilidad con la orden version, hace que omita la versión de
Debian de la salida de la versión del paquete.
.IP "\fB\-k\fR, \fB\-\-keep\-built\fR" 4
.IX Item "-k, --keep-built"
No borra los .debs y otros ficheros contruídos después de instalarlos con la
opción \-\-installdebs. Opción de configuración: APT::Src::KeepBuilt
.IP "\fB\-n\fR, \fB\-\-no\-delete\-source\fR" 4
.IX Item "-n, --no-delete-source"
No borra los ficheros fuentes cuando se elimine el paquete fuente.  Opción
de configuración: APT::Src:NoDeleteSource
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Especifica una versión del árbol de las fuentes. Se usa junto con la orden
import.
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
.IX Item "-q, --quiet"
Dirije todo salida de la orden a /dev/null a menos que la orden no se
ejecute como era de esperar. Opción de configuración: APT::Src::Quiet
.IP "\fB\-t\fR, \fB\-\-trace\fR" 4
.IX Item "-t, --trace"
Muestra todas las órdenes que ejecuta. Opción de configuración:
APT::Src::Trace
.PP
Además de las opciones anteriores, algunas opciones de configuración menos
usadas sólo pueden especificarse en los ficheros de configuración,
/etc/apt/apt.conf y ~/.apt\-src/config.  Éstas son:
.IP "APT::Src::BuildCommand" 4
.IX Item "APT::Src::BuildCommand"
La orden a usar para construir el árbol. Se ejecuta en el árbol a construir,
por omisión es \*(L"dpkg-buildpackage \-b \-us \-uc\*(R", con \*(L"\-rfakeroot\*(R" añadido para
los usuarios distintos del superusuario.
.IP "APT::Src::RootCommand" 4
.IX Item "APT::Src::RootCommand"
La orden a usar si un usuario necesita convertirse en superusuario. Se usa,
por ejemplo, para satisfacer dependencias de construcción. \*(L"sudo\*(R" es una
buena elección, es el comportamiento predeterminado. Si quiere usar \*(L"su\*(R",
necesitará establecerlo a \*(L"su \-c\*(R".
.IP "APT::Src::BuildDeps" 4
.IX Item "APT::Src::BuildDeps"
Controla si apt-src se asegura de que las dependencias de construcción de un
paquete se satisfacen al instalar o actualizar el paquete. Por omisión está
habilitado, si lo deshabilita, es posible que los paquetes no se puedan
construir debido a la falta de las dependencias de contrucción.
.SH "NOTA SOBRE LOS NOMBRES"
.IX Header "NOTA SOBRE LOS NOMBRES"
Puede usar el nombre del paquete binario o del paquete fuente cuando desee
instalar un nuevo paquete fuente.
.PP
El resto del tiempo, cuando los paquetes ya estén instalados, tiene que usar
el nombre del paquete fuente (es posible que esto cambie en un futuro). Sin
embargo, puede usar expresiones regulares como parte de los nombres.
.SH "ENTORNO"
.IX Header "ENTORNO"
Este programa establece \s-1APT_SRC_BUILD\s0 cuando contruye un paquete.
.SH "EJEMPLOS"
.IX Header "EJEMPLOS"
Para instalar las fuentes de pine en /usr/src, construirlo, e instalar los
debs resultantes:
.PP
.Vb 1
\&  apt\-src install \-\-location=/usr/src \-i pine
.Ve
.PP
Para seguir los cambios del paquete fuente pine, e instalar los debs cuando
halla una nueva versión disponible:
.PP
.Vb 1
\&  apt\-src install \-i pine
.Ve
.PP
Para instalar una copia local del paquete tal, al que va a aplicar un parche
local:
.PP
.Vb 4
\&  apt\-src install tal
\&  cd tal\-version
\&  patch <~/mi\-parche\-para\-tal
\&  apt\-src build \-\-installdebs tal
.Ve
.PP
Para actualizar su copia local de tal, manteniendo su parche, constuirlo, e
instalar los nuevos debs:
.PP
.Vb 1
\&  apt\-src install \-i tal
.Ve
.PP
Para importar el árbol de fuentes en /usr/src/linux, que puede haber sido
desempaquetado de un tar de ftp.kernel.org (o desde el paquete
kernel-source)  en apt-src, de forma que éste pase a saber de su existencia:
.PP
.Vb 1
\&  apt\-src import kernel \-\-location=/usr/src/linux \-\-version=2.4.18
.Ve
.PP
En un debian/rules de un paquete de módulos del núcleo que necesite saber si
está siendo construido por apt-src, y si es así establecer las variables
\&\s-1KVERS, KSRC.\s0 y \s-1KDREV\s0 que normalmente establece make-kpkg:
.PP
.Vb 5
\&  ifdef APT_SRC_BUILD
\&  KDREV=$(shell apt\-src version kernel\e(\-source.\e*\e)\e?)
\&  KSRC=$(shell apt\-src location kernel\e(\-source.\e*\e)\e?)
\&  KVERS=$(shell apt\-src name kernel\e(\-source.\e*\e)\e? | sed s/kernel\-source\-//)
\&  endif
.Ve
.SH "FICHEROS"
.IX Header "FICHEROS"
.IP "/etc/apt/sources.list" 4
.IX Item "/etc/apt/sources.list"
Contiene los lugares de dónde descarga los paquetes.
.IP "~/.apt\-src/status" 4
.IX Item "~/.apt-src/status"
El fichero de estado de apt-src, contiene los paquetes instalados.
.IP "/etc/apt/apt.conf" 4
.IX Item "/etc/apt/apt.conf"
Fichero de configuración global de apt-src (y apt).
.IP "~/.apt\-src/config" 4
.IX Item "~/.apt-src/config"
Fichero de configuración de apt-src para cada usuario.
.SH "VÉASE ADEMÁS"
.IX Header "VÉASE ADEMÁS"
\&\fBapt\-get\fR\|(8), \fBsources.list\fR\|(5), \fBdpkg\-source\fR\|(1)
.SH "AUTOR"
.IX Header "AUTOR"
Copyright 2002 Joey Hess <joeyh@debian.org>
.PP
Esto es software libre; lea la Licencia Pública General de \s-1GNU\s0 versión 2 o
posterior para las condiciones de copia. \s-1NO\s0 hay ninguna garantía.
.SH "TRADUCTOR"
.IX Header "TRADUCTOR"
Traducción de Rubén Porras Campo <debian\-l10n\-spanish@lists.debian.org>