.\" Automatically generated by Pod::Man 2.27 (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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "APT-SRC.ES 1"
.TH APT-SRC.ES 1 "2013-10-10" "perl v5.18.1" "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 a\*'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 \fIlocalizacio\*'n\fR paq
.SH "DESCRIPCIO\*'N"
.IX Header "DESCRIPCIO'N"
apt-src es una interfaz de li\*'nea de o\*'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 cano\*'nico. En lugar de esto, se \*(L"instalan\*(R" desempaquetando el a\*'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 bu\*'squeda
para encontrar donde fue instalado un determinado paquete.
.PP
A menos que se proporcione la opcio\*'n \-h o \-\-help se debe de proporcionar una de
los siguientes o\*'rdenes.
.IP "update" 4
.IX Item "update"
Actualiza la lista de paquetes disponibles. Ide\*'ntico que apt-get update, debe
ejecutarse como superusuario en su configuracio\*'n predeterminada.
.IP "install" 4
.IX Item "install"
Instala los paquetes fuentes nombrados en el directorio actual. Si un paquete ya
esta\*' instalado en el directorio actual, intentara\*' actualizarlo.
.Sp
Esta orden aceptara\*' el nombre de paquetes binarios o paquetes fuentes. Igual que
con apt-get install, puede usar como prefijo del nombre =versio\*'n o
/distribucio\*'n para especificar la versio\*'n que quiere instalar o de que
distribucio\*'n desea obtenerla.
.Sp
Se asegurara\*' de que las dependencias de construccio\*'n del paquete se satisfacen.
.Sp
Si se proporciona la opcio\*'n \-\-location, el paquete fuente se instalara\*' o
actualizara\*' en el lugar indicado en vez de en el directorio actual.
.Sp
Si se proporciona la opcio\*'n \-\-build, se compilara\*' 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, so\*'lo se actualizara\*'n los paquetes fuentes del
directorio especificado.
.Sp
Si se proporciona la opcio\*'n \-\-patch (por omisio\*'n), apt-src intentara\*' generar un
parche que contenga todos los cambios locales hechos al paquete fuente, y los
aplicara\*' al a\*'rbol actualizado. Esto permite que los cambios locales se preserven
a trave\*'s de las actualizaciones de los paquetes, pero es posible que no siempre
funcione, en estos casos debera\*' combinar los cambios usted mismo.
.Sp
Si se proporciona la opcio\*'n \-\-build, se compilara\*' 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 so\*'lo los paquetes de un directorio determinado.
.IP "build" 4
.IX Item "build"
Construye las fuentes especificadas. Si el paquete fuente no esta\*' instalado, se
instalara\*' primero.
.IP "clean" 4
.IX Item "clean"
Limpia el a\*'rbol de los paquetes fuentes listados. Se pueden usar las opciones
\&\-\-location y \-\-here para limpiar so\*'lo los paquetes de un determinado directorio.
.IP "import" 4
.IX Item "import"
Use esta opcio\*'n para hacerle saber a apt-src acerca de un paquete fuente ya
desempaquetado. Despue\*'s del nombre bajo el que sera\*' importado debe especificar
la localizacio\*'n del a\*'rbol con las fuentes (con \-\-location), y puede especificar
la versio\*'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 ningu\*'n otro para\*'metro, listara\*' todos los paquetes fuentes instalados, su
estado, y el directorio donde fueron instalados. Si se proporciona el nombre de
un paquete, mostrara\*' so\*'lo los ejemplares instalados de ese paquete fuente. Si se
usan las opciones \-\-location o \-\-here, limitara\*'n la lista de paquetes a los
instalados en el directorio especificado.
.IP "location" 4
.IX Item "location"
So\*'lo acepta un para\*'metro, el nombre del paquete fuente. Si el paquete esta\*'
instalado, devolvera\*' el directorio rai\*'z del a\*'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"
So\*'lo acepta un para\*'metro, el nombre del paquete fuente. Si el paquete esta\*'
instalado devuelve la versio\*'n del paquete.
.IP "name" 4
.IX Item "name"
So\*'lo acepta un para\*'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 li\*'nea de o\*'rdenes pueden incluirse en el fichero de
configuracio\*'n. Las descripciones indican la opcio\*'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 despue\*'s de instalarlos o actualizarlos.
Opcio\*'n de configuracio\*'n: APT::Src::Compile.
.IP "\fB\-i\fR, \fB\-\-installdebs\fR" 4
.IX Item "-i, --installdebs"
Instala los paquetes despue\*'s de construirlos. Implica \-\-build.
Opcio\*'n de configuracio\*'n: APT::Src::InstallDebs
.Sp
Note que si un paquete fuente genera varios binarios, todos se instalara\*'n.
.IP "\fB\-p\fR, \fB\-\-patch\fR" 4
.IX Item "-p, --patch"
Trata de parchear los cambios locales en el nuevo a\*'rbol despue\*'s de
actualizar. Habilitado por omisio\*'n, use \-\-no\-p para deshabilitarlo.
Opcio\*'n de configuracio\*'n: APT::Src::Patch.
.IP "\fB\-l\fR, \fB\-\-location\fR" 4
.IX Item "-l, --location"
Especifica un directorio, so\*'lo opera en paquetes en ese directorio.
Opcio\*'n de configuracio\*'n: APT::Src::Location.
.IP "\fB\-c\fR, \fB\-\-cwd\fR, \fB\-\-here\fR" 4
.IX Item "-c, --cwd, --here"
So\*'lo operan sobre paquetes en el directorio actual.
Opcio\*'n de configuracio\*'n: APT::Src::Here.
.IP "\fB\-\-upstream\-version\fR" 4
.IX Item "--upstream-version"
So\*'lo tiene utilidad con la orden version, hace que omita la versio\*'n de Debian de
la salida de la versio\*'n del paquete.
.IP "\fB\-k\fR, \fB\-\-keep\-built\fR" 4
.IX Item "-k, --keep-built"
No borra los .debs y otros ficheros contrui\*'dos despue\*'s de instalarlos con la
opcio\*'n \-\-installdebs. Opcio\*'n de configuracio\*'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.
Opcio\*'n de configuracio\*'n: APT::Src:NoDeleteSource
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Especifica una versio\*'n del a\*'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. Opcio\*'n de configuracio\*'n: APT::Src::Quiet
.IP "\fB\-t\fR, \fB\-\-trace\fR" 4
.IX Item "-t, --trace"
Muestra todas las o\*'rdenes que ejecuta. Opcio\*'n de configuracio\*'n: APT::Src::Trace
.PP
Adema\*'s de las opciones anteriores, algunas opciones de configuracio\*'n menos
usadas so\*'lo pueden especificarse en los ficheros de configuracio\*'n,
/etc/apt/apt.conf y ~/.apt\-src/config.
E\*'stas son:
.IP "APT::Src::BuildCommand" 4
.IX Item "APT::Src::BuildCommand"
La orden a usar para construir el a\*'rbol. Se ejecuta en el a\*'rbol a construir, por
omisio\*'n es \*(L"dpkg-buildpackage \-b \-us \-uc\*(R", con \*(L"\-rfakeroot\*(R" an\*~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 construccio\*'n. \*(L"sudo\*(R" es una buena
eleccio\*'n, es el comportamiento predeterminado. Si quiere usar \*(L"su\*(R", necesitara\*'
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 construccio\*'n de un
paquete se satisfacen al instalar o actualizar el paquete. Por omisio\*'n esta\*'
habilitado, si lo deshabilita, es posible que los paquetes no se puedan
construir debido a la falta de las dependencias de contruccio\*'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 este\*'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 versio\*'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 a\*'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 e\*'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 mo\*'dulos del nu\*'cleo que necesite saber si
esta\*' siendo construido por apt-src, y si es asi\*' 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 do\*'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 configuracio\*'n global de apt-src (y apt).
.IP "~/.apt\-src/config" 4
.IX Item "~/.apt-src/config"
Fichero de configuracio\*'n de apt-src para cada usuario.
.SH "VE\*'ASE ADEMA\*'S"
.IX Header "VE'ASE ADEMA'S"
\&\fIapt\-get\fR\|(8), \fIsources.list\fR\|(5), \fIdpkg\-source\fR\|(1)
.SH "AUTOR"
.IX Header "AUTOR"
Copyright 2002 Joey Hess <joeyh@debian.org>
.PP
Esto es software libre; lea la Licencia Pu\*'blica General de \s-1GNU\s0
versio\*'n 2 o posterior para las condiciones de copia. \s-1NO\s0 hay ninguna garanti\*'a.
.SH "TRADUCTOR"
.IX Header "TRADUCTOR"
Traduccio\*'n de Rube\*'n Porras Campo <debian\-l10n\-spanish@lists.debian.org>