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

NOM

       apt-src - Gere les arborescences des paquets source debian.

SYNOPSIS

       apt-src [options] commande

       apt-src [options] install|remove paquet1 [paquet2 ...]

       apt-src emplacement paquet

DESCRIPTION

       apt-src est une interface en ligne de commande pour le telechargement,
       l'installation, la mise a niveau et le suivi des paquets source debian.
       Ce programme peut etre execute aussi bien par un utilisateur normal que
       par le superutilisateur (root).

       A la difference des paquets binaires, les paquets source ne sont pas
       installes dans un emplacement standard (canonique). En effet, ils sont
       << installes >> en depaquetant leur arborescence source dans le
       repertoire desire. Un paquet source peut etre installe plusieurs fois,
       a des emplacements differents. Ce programme gere les paquets source
       installes selon ce principe et fournit des outils de recherche pour
       vous aider a trouver ou un paquet source est installe.

       Une des commandes ci-dessous doit etre indiquee, sauf lors de
       l'utilisation des options -h ou -help.

       update
           Met a jour les listes des paquets disponibles. Rigoureusement
           identique a << apt-get update >>. Ne peut etre executee, dans la
           configuration par defaut, que par le superutilisateur.

       install
           Installe, dans le repertoire courant, le ou les paquets source
           indiques. Si le paquet est deja installe dans le repertoire
           courant, une mise a niveau est tentee.

           Cette commande accepte aussi bien les noms de paquets binaires que
           ceux des paquets source. Comme avec << apt-get install >>, vous
           pouvez prefixer le nom avec =version ou /distribution (release)
           pour specifier la version du paquet ou la distribution choisie.

           Cette commande s'assurera que les dependances du paquet source sont
           satisfaites.

           Avec l'option --location, le paquet source sera installe ou mis a
           niveau a l'emplacement indique au lieu du repertoire courant.

           Avec l'option --build tous les paquets nouvellement installes ou
           mis a jour seront compiles.

       upgrade
           Met a jour tous les paquets source installes, sauf avec les options
           --location ou --here (ici), ou seuls les paquets source situes dans
           le repertoire indique seront mis a jour.

           Avec l'option --patch (valeur par defaut), apt-src tentera de
           fabriquer une rustine (patch) contenant tous les changements locaux
           apportes au paquet source puis appliquera cette rustine a
           l'arborescence apres sa mise a jour. Ceci permet a vos changements
           locaux d'etre preserves lors d'une mise a niveau du paquet. Il peut
           arriver que cette methode ne fonctionne pas, vous devrez alors
           fusionner vos propres modifications a la main.

           Avec l'option --build tous les paquets nouvellement installes ou
           mis a jour seront compiles.

       remove
           Supprime le ou les paquets source specifies. Les options --location
           ou --here (ici) peuvent etre employees pour limiter la suppression
           des paquets au repertoire indique.

       build
           Construit la ou les sources specifiees. Si la source n'est pas
           encore installee, elle le sera prealablement.

       clean
           Nettoie les arborescences du ou des paquets source specifies. Les
           options --location ou --here (ici) peuvent etre employees pour ne
           nettoyer que les paquets du repertoire indique.

       import
           Permet d'informer apt-src de l'existence d'une arborescence source
           prealablement depaquetee. En plus du nom sous lequel elle doit etre
           importee, vous devez indiquer l'emplacement de cette arborescence
           source (avec --location). Vous pouvez avoir besoin de specifier la
           version de la source (avec --version). N'esperez pas que la
           commande build fonctionne avec cette source, a moins qu'elle ne
           possede un repertoire debian/

       list
           Sans autre parametre, cette commande enumere tous les paquets
           source installes et indique leur etat ainsi que le repertoire ou
           ils sont installes. Si le nom d'un paquet est specifie, la commande
           affichera seulement les occurrences installees de ce paquet source.
           Si les options --location ou --here sont employees, elles
           limiteront la liste aux paquets du repertoire indique.

       location
           N'accepte qu'un seul parametre : Le nom du paquet source. Si le
           paquet est installe, la commande renvoie le chemin de la racine de
           l'arborescence du paquet source.

           Cette commande peut etre employee quand vous devez inclure des
           fichiers provenant d'un autre paquet source, ou quelque chose comme
           ca. Par exemple :

           apt-src location pkg

       version
           N'accepte qu'un seul parametre : le nom du paquet source. Si le
           paquet est installe, sa version est retournee.

       name
           N'accepte qu'un seul parametre : le nom d'un paquet source (une
           expression rationnelle peut etre utilisee). Renvoie le nom du
           paquet source installe, correspondant au parametre specifie.
           (NdT : Utile en cas d'utilisation d'expression rationnelle.)

OPTIONS

       Toutes les options en ligne de commande peuvent etre reglees par
       l'intermediaire du fichier de configuration. Les descriptions indiquent
       l'option de configuration a regler. Pour les options booleennes vous
       pouvez surcharger les valeurs par defaut du fichier en employant
       quelque chose comme -f-, --no-f, -f=no ou d'autres variantes.

       -h, --help
           Affiche ce fichier d'aide.

       -b, --build, --compile
           Construit les paquets source apres les avoir installes ou mis a
           jour. Parametre de configuration : APT::Src::Compile

       -i, --installdebs
           Installe les paquets apres avoir construit les sources. Implique
           l'usage de --build. Parametre de configuration :
           APT::Src::InstallDebs

           Notez que si des paquets multiples sont produits a partir d'un
           paquet source unique, ils seront tous installes.

       -p, --patch
           Tente de reimplanter les changements locaux dans la nouvelle
           arborescence apres la mise a jour. Cette option est prise par
           defaut. Employer --no-p pour ignorer cette action. Parametre de
           configuration : APT::Src::Patch

       -l, --location
           Specifie un repertoire. Limite l'action aux paquets du repertoire
           specifie. Parametre de configuration : APT::Src::Location

       -c, --cwd, --here
           Limite l'action aux paquets du repertoire courant. Parametre de
           configuration : APT::Src::Here

       --upstream-version
           Utilisable seulement avec la commande version. Permet de ne pas
           afficher le numero de version debian de la version du paquet.

       -k, --keep-built
           Conserve les .debs et les autres fichiers construits, apres leur
           installation, lors de l'usage de l'option --installdebs. Parametre
           de configuration : APT::Src::KeepBuilt

       -n, --no-delete-source
           Conserve les fichiers source lors de la desinstallation d'un paquet
           source. Parametre de configuration : APT::Src:NoDeleteSource

       --version
           Specifie une version de l'arborescence de la source. A utiliser
           avec la commande d'importation.

       -q, --quiet
           Redirige toutes les sorties vers /dev/null a moins qu'une commande
           ne fonctionne pas comme prevu. Parametre de configuration :
           APT::Src::Quiet

       -t, --trace
           Affiche chaque commande telle qu'elle est lancee. Parametre de
           configuration : APT::Src::Trace

       En plus des options ci-dessus, il existe quelques elements de
       configuration moins utilises. Ils ne peuvent etre indiques que dans les
       fichiers de configuration /etc/apt/apt.conf et ~/.apt-src/config Il
       s'agit de :

       APT::Src::BuildCommand
           Indique la commande a employer pour construire le paquet. Cette
           commande sera executee a partir de l'arborescence des sources. Par
           defaut << dpkg-buildpackage - b -us -uc >>, avec << -rfakeroot >>
           ajoute pour les utilisateurs autres que le superutilisateur.

       APT::Src::RootCommand
           Indique la commande a employer si un utilisateur autre que le
           superutilisateur doit devenir superutilisateur. Elle est employee
           pour, par exemple, satisfaire build-deps. sudo, la valeur par
           defaut, est un choix judicieux. Si vous voulez employer su, vous
           devez le faire sous la forme << su -c >>.

       APT::Src::BuildDeps
           Demande a apt-src d'installer les dependances necessaires au paquet
           source lors de son installation ou de sa mise a jour. Actif par
           defaut. Si vous desactivez cette option, certains paquets peuvent
           ne pas etre construits en raison de dependances manquantes.

NOTE SUR LES NOMS

       Vous pouvez employer le nom du paquet binaire ou le nom du paquet
       source pour installer un nouveau paquet source.

       Par contre, pour travailler avec des paquets deja installes, vous
       devez, actuellement, employer les noms des paquets source. (Cela
       pourrait changer plus tard). Toutefois, vous pouvez employer des
       expressions rationnelles pour specifier les noms.

ENVIRONNEMENT

       Ce programme definit APT_SRC_BUILD lorsqu'il construit un paquet.

EXEMPLES

       Pour installer le paquet source << toto >> dans /usr/src, construire le
       paquet et installer les .debs resultants :

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

       Pour suivre les changements du paquet source << toto >> deja implante
       et installer les .debs a chaque fois qu'une nouvelle version est
       disponible :

         apt-src install -i toto

       Pour installer une copie locale du paquet foo, et appliquer une rustine
       (patch) locale :

         apt-src install foo
         cd foo-version
         patch <~/my-foo-patch
         apt-src build --installdebs foo

       Pour mettre a niveau votre copie locale de foo, conserver votre rustine
       (patch), puis construire et installer les nouveaux .debs :

         apt-src install -i foo

       Pour importer, dans apt-src, l'arborescence source que vous avez
       depaquetee, par un tarball, dans /usr/src/linux, depuis ftp.kernel.org
       (ou depuis un paquet du kernel-source). Cette commande a pour but de
       renseigner apt-src au sujet du paquet :

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

       Voici un exemple utilise pour le paquet d'un module noyau dont le
       script debian/rules cherche a determiner s'il est construit par
       apt-src, pour, dans ce cas, definir les variables KVERS, KSRC, et KDREV
       qui sont normalement fixees par 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

FICHIERS

       /etc/apt/sources.list
           Emplacement des archives du systeme de distribution de paquets.

       ~/.apt-src/status
           Fichier d'etat d'apt-src, qui liste les paquets installes.

       /etc/apt/apt.conf
           Fichier global de configuration pour apt-src (et apt).

       ~/.apt-src/config
           Fichier de configuration propre a l'utilisateur pour apt-src.

VOIR AUSSI

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

AUTEUR

       Copyright 2002 Joey Hess <joeyh@debian.org>

       Ceci est logiciel libre. Consultez la version 2 et suivantes de la
       Licence Publique Generale (GPL) de GNU pour les conditions de
       duplication. Ce logiciel est fourni sans AUCUNE garantie.

TRADUCTION

       Valery Perrin <valery.perrin.debian@free.fr> le 18 octobre 2004.

       L'equipe de traduction a fait le maximum pour realiser une adaptation
       francaise de qualite.

       La version anglaise la plus a jour de ce document est toujours
       consultable via la commande  << man -L en apt-src >>.

       N'hesitez pas a signaler a l'auteur ou au traducteur, selon le cas,
       toute erreur dans de cette page de manuel.