NOMBRE

       apt-src - gestiona árboles de paquetes fuentes de Debian

SINOPSIS

       apt-src [opciones] orden

       apt-src [opciones] install|remove paq1 [paq2 ...]

       apt-src localización paq

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.

       A diferencia de los paquetes binarios, los paquetes fuentes no se instalan en un lugar
       canónico. En lugar de esto, se "instalan" 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.

       A menos que se proporcione la opción -h o --help se debe de proporcionar una de los
       siguientes órdenes.

       update
           Actualiza la lista de paquetes disponibles. Idéntico que apt-get update, debe
           ejecutarse como superusuario en su configuración predeterminada.

       install
           Instala los paquetes fuentes nombrados en el directorio actual. Si un paquete ya está
           instalado en el directorio actual, intentará actualizarlo.

           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.

           Se asegurará de que las dependencias de construcción del paquete se satisfacen.

           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.

           Si se proporciona la opción --build, se compilará cada paquete instalado o
           actualizado.

       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.

           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.

           Si se proporciona la opción --build, se compilará cada paquete instalado o
           actualizado.

       remove
           Elimina los paquetes fuentes nombrados. Se pueden usar las opciones --location y
           --here para eliminar sólo los paquetes de un directorio determinado.

       build
           Construye las fuentes especificadas. Si el paquete fuente no está instalado, se
           instalará primero.

       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.

       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/.

       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.

       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.

           Esta orden puede usarse cuando necesite incluir ficheros de otro paquete fuente, o
           algo por el estilo. Por ejemplo:

            -I`apt-src location paquete`

       version
           Sólo acepta un parámetro, el nombre del paquete fuente. Si el paquete está instalado
           devuelve la versión del paquete.

       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.

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.

       -h, --help
           Muestra este texto de ayuda.

       -b, --build, --compile
           Construye los paquetes fuentes después de instalarlos o actualizarlos.  Opción de
           configuración: APT::Src::Compile.

       -i, --installdebs
           Instala los paquetes después de construirlos. Implica --build.  Opción de
           configuración: APT::Src::InstallDebs

           Note que si un paquete fuente genera varios binarios, todos se instalarán.

       -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.

       -l, --location
           Especifica un directorio, sólo opera en paquetes en ese directorio.  Opción de
           configuración: APT::Src::Location.

       -c, --cwd, --here
           Sólo operan sobre paquetes en el directorio actual.  Opción de configuración:
           APT::Src::Here.

       --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.

       -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

       -n, --no-delete-source
           No borra los ficheros fuentes cuando se elimine el paquete fuente.  Opción de
           configuración: APT::Src:NoDeleteSource

       --version
           Especifica una versión del árbol de las fuentes. Se usa junto con la orden import.

       -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

       -t, --trace
           Muestra todas las órdenes que ejecuta. Opción de configuración: APT::Src::Trace

       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:

       APT::Src::BuildCommand
           La orden a usar para construir el árbol. Se ejecuta en el árbol a construir, por
           omisión es "dpkg-buildpackage -b -us -uc", con "-rfakeroot" añadido para los usuarios
           distintos del superusuario.

       APT::Src::RootCommand
           La orden a usar si un usuario necesita convertirse en superusuario. Se usa, por
           ejemplo, para satisfacer dependencias de construcción. "sudo" es una buena elección,
           es el comportamiento predeterminado. Si quiere usar "su", necesitará establecerlo a
           "su -c".

       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.

NOTA SOBRE LOS NOMBRES

       Puede usar el nombre del paquete binario o del paquete fuente cuando desee instalar un
       nuevo paquete fuente.

       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.

ENTORNO

       Este programa establece APT_SRC_BUILD cuando contruye un paquete.

EJEMPLOS

       Para instalar las fuentes de pine en /usr/src, construirlo, e instalar los debs
       resultantes:

         apt-src install --location=/usr/src -i pine

       Para seguir los cambios del paquete fuente pine, e instalar los debs cuando halla una
       nueva versión disponible:

         apt-src install -i pine

       Para instalar una copia local del paquete tal, al que va a aplicar un parche local:

         apt-src install tal
         cd tal-version
         patch <~/mi-parche-para-tal
         apt-src build --installdebs tal

       Para actualizar su copia local de tal, manteniendo su parche, constuirlo, e instalar los
       nuevos debs:

         apt-src install -i tal

       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:

         apt-src import kernel --location=/usr/src/linux --version=2.4.18

       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 KVERS, KSRC. y KDREV que
       normalmente establece make-kpkg:

         ifdef APT_SRC_BUILD
         KDREV=$(shell apt-src version kernel\(-source.\*\)\?)
         KSRC=$(shell apt-src location kernel\(-source.\*\)\?)
         KVERS=$(shell apt-src name kernel\(-source.\*\)\? | sed s/kernel-source-//)
         endif

FICHEROS

       /etc/apt/sources.list
           Contiene los lugares de dónde descarga los paquetes.

       ~/.apt-src/status
           El fichero de estado de apt-src, contiene los paquetes instalados.

       /etc/apt/apt.conf
           Fichero de configuración global de apt-src (y apt).

       ~/.apt-src/config
           Fichero de configuración de apt-src para cada usuario.

VÉASE ADEMÁS

       apt-get(8), sources.list(5), dpkg-source(1)

AUTOR

       Copyright 2002 Joey Hess <joeyh@debian.org>

       Esto es software libre; lea la Licencia Pública General de GNU versión 2 o posterior para
       las condiciones de copia. NO hay ninguna garantía.

TRADUCTOR

       Traducción de Rubén Porras Campo <debian-l10n-spanish@lists.debian.org>