Provided by: apt-src_0.25.1_all bug

NOMBRE

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

SINOPSIS

       apt-src [opciones] orden

       apt-src [opciones] installremove paq1 [paq2 ...]

       apt-src localizacin paq

DESCRIPCIÓN

       apt-src es una interfaz de línea de órdenes para descargar, instalar,
       actualizar, y seguir los paquete fuente de Debian. Puede ejecutarse
       como usuario normal o como superusuario.

       A diferencia de los paquetes binarios, los paquetes fuente 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 fuente
       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 fuente 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
           fuente. 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 fuente 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 caso 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 fuente 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 fuente
           instalados, su estado, y el directorio donde fueron instalados. Si
           se proporciona el nombre de un paquete, mostrará solo 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
       variación.

       -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

       --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.  Estas 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 satisfaces 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 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 the
       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 necesita
       saber si está siendo construido por apt-src, y si es así establece 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 donde 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>