Provided by: apt-src_0.25.1-0.2_all bug

NOMBRE

       apt-src - gestiona arboles de paquetes fuentes de Debian

SINOPSIS

       apt-src [opciones] orden

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

       apt-src localizacion paq

DESCRIPCION

       apt-src es una interfaz de linea de ordenes 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 canonico. En lugar
       de esto, se "instalan" desempaquetando el arbol 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 busqueda para
       encontrar donde fue instalado un determinado paquete.

       A menos que se proporcione la opcion -h o --help se debe de proporcionar una de los siguientes ordenes.

       update
           Actualiza  la  lista  de  paquetes  disponibles.  Identico  que  apt-get update, debe ejecutarse como
           superusuario en su configuracion predeterminada.

       install
           Instala los paquetes fuentes nombrados en el directorio actual. Si un paquete ya esta instalado en el
           directorio actual, intentara actualizarlo.

           Esta orden aceptara el nombre de paquetes binarios o paquetes fuentes. Igual que con apt-get install,
           puede usar como prefijo del nombre =version o /distribucion para especificar la  version  que  quiere
           instalar o de que distribucion desea obtenerla.

           Se asegurara de que las dependencias de construccion del paquete se satisfacen.

           Si  se  proporciona  la  opcion  --location, el paquete fuente se instalara o actualizara en el lugar
           indicado en vez de en el directorio actual.

           Si se proporciona la opcion --build, se compilara cada paquete instalado o actualizado.

       upgrade
           Actualiza todos los paquetes fuentes instalados, o, si se  proporcionan  las  opciones  --location  o
           --here, solo se actualizaran los paquetes fuentes del directorio especificado.

           Si  se  proporciona la opcion --patch (por omision), apt-src intentara generar un parche que contenga
           todos los cambios locales hechos al paquete fuente, y los aplicara al arbol actualizado. Esto permite
           que los cambios locales se preserven a traves de las actualizaciones de los paquetes, pero es posible
           que no siempre funcione, en estos casos debera combinar los cambios usted mismo.

           Si se proporciona la opcion --build, se compilara cada paquete instalado o actualizado.

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

       build
           Construye las fuentes especificadas. Si el paquete fuente no esta instalado, se instalara primero.

       clean
           Limpia el arbol de los paquetes fuentes listados. Se pueden usar las  opciones  --location  y  --here
           para limpiar solo los paquetes de un determinado directorio.

       import
           Use  esta  opcion para hacerle saber a apt-src acerca de un paquete fuente ya desempaquetado. Despues
           del nombre bajo el que sera importado debe especificar la localizacion del arbol con las fuentes (con
           --location), y puede especificar la version (con --version). No espere que la orden build funcione en
           estas fuentes, a menos que tengan un directorio debian/.

       list
           Sin ningun otro parametro, listara todos los paquetes fuentes instalados, su estado, y el  directorio
           donde  fueron  instalados.  Si  se  proporciona el nombre de un paquete, mostrara solo los ejemplares
           instalados de ese paquete fuente. Si se usan las opciones --location o --here, limitaran la lista  de
           paquetes a los instalados en el directorio especificado.

       location
           Solo  acepta  un  parametro, el nombre del paquete fuente. Si el paquete esta instalado, devolvera el
           directorio raiz del arbol 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
           Solo  acepta  un  parametro,  el  nombre del paquete fuente. Si el paquete esta instalado devuelve la
           version del paquete.

       name
           Solo acepta un  parametro,  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  linea  de  ordenes  pueden  incluirse  en  el fichero de configuracion. Las
       descripciones indican la opcion 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  despues  de instalarlos o actualizarlos.  Opcion de configuracion:
           APT::Src::Compile.

       -i, --installdebs
           Instala  los  paquetes  despues  de  construirlos.  Implica  --build.    Opcion   de   configuracion:
           APT::Src::InstallDebs

           Note que si un paquete fuente genera varios binarios, todos se instalaran.

       -p, --patch
           Trata  de  parchear  los  cambios  locales  en  el  nuevo arbol despues de actualizar. Habilitado por
           omision, use --no-p para deshabilitarlo.  Opcion de configuracion: APT::Src::Patch.

       -l, --location
           Especifica un directorio, solo opera  en  paquetes  en  ese  directorio.   Opcion  de  configuracion:
           APT::Src::Location.

       -c, --cwd, --here
           Solo operan sobre paquetes en el directorio actual.  Opcion de configuracion: APT::Src::Here.

       --upstream-version
           Solo  tiene  utilidad  con  la  orden version, hace que omita la version de Debian de la salida de la
           version del paquete.

       -k, --keep-built
           No borra los .debs y otros ficheros contruidos despues de instalarlos con  la  opcion  --installdebs.
           Opcion de configuracion: APT::Src::KeepBuilt

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

       --version
           Especifica una version del arbol 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.
           Opcion de configuracion: APT::Src::Quiet

       -t, --trace
           Muestra todas las ordenes que ejecuta. Opcion de configuracion: APT::Src::Trace

       Ademas  de  las  opciones  anteriores,  algunas  opciones  de  configuracion  menos  usadas  solo  pueden
       especificarse en los ficheros de configuracion, /etc/apt/apt.conf y ~/.apt-src/config.  Estas son:

       APT::Src::BuildCommand
           La orden a usar para construir el arbol. Se ejecuta en el arbol a construir, por  omision  es  "dpkg-
           buildpackage -b -us -uc", con "-rfakeroot" an~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  construccion.  "sudo"  es  una  buena  eleccion,  es  el  comportamiento
           predeterminado. Si quiere usar "su", necesitara establecerlo a "su -c".

       APT::Src::BuildDeps
           Controla si apt-src se asegura de que las dependencias de construccion de un paquete se satisfacen al
           instalar  o actualizar el paquete. Por omision esta habilitado, si lo deshabilita, es posible que los
           paquetes no se puedan construir debido a la falta de las dependencias de contruccion.

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 esten 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  version
       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  arbol  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  este  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 modulos del nucleo que necesite saber si esta siendo construido por
       apt-src, y si es asi 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 donde descarga los paquetes.

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

       /etc/apt/apt.conf
           Fichero de configuracion global de apt-src (y apt).

       ~/.apt-src/config
           Fichero de configuracion de apt-src para cada usuario.

VEASE ADEMAS

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

AUTOR

       Copyright 2002 Joey Hess <joeyh@debian.org>

       Esto es software libre; lea la Licencia Publica General de GNU version 2 o posterior para las condiciones
       de copia. NO hay ninguna garantia.

TRADUCTOR

       Traduccion de Ruben Porras Campo <debian-l10n-spanish@lists.debian.org>

perl v5.18.1                                       2013-10-10                                      APT-SRC.ES(1)