
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             * 
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in cvs, for example),
but store the po file used as source file by po4a-translate. 

In fact, consider this as a binary, and the po file as a regular .c file:
If the po get lost, keeping this translation up-to-date will be harder.

=head1 NOM

apt-src - Gère les arborescences des paquets source debian.

=head1 SYNOPSIS

B<apt-src> [S<I<options>>] S<I<commande>>

B<apt-src> [S<I<options>>] S<I<install|remove>> paquet1 [paquet2 ...]

B<apt-src> S<I<emplacement>> paquet

=head1 DESCRIPTION

apt-src est une interface en ligne de commande pour le téléchargement,
l'installation, la mise à niveau et le suivi des paquets source debian. Ce
programme peut être exécuté aussi bien par un utilisateur normal que par le
superutilisateur (root).

À la différence des paquets binaires, les paquets source ne sont pas
installés dans un emplacement standard (canonique). En effet, ils sont S<«
installés »> en dépaquetant leur arborescence source dans le répertoire
désiré. Un paquet source peut être installé plusieurs fois, à des
emplacements différents. Ce programme gère les paquets source installés
selon ce principe et fournit des outils de recherche pour vous aider à
trouver où un paquet source est installé.

Une des commandes ci-dessous doit être indiquée, sauf lors de l'utilisation
des options -h ou -help.

=over 4

=item update

Met à jour les listes des paquets disponibles. Rigoureusement identique à
S<« apt-get update »>. Ne peut être exécutée, dans la configuration par
défaut, que par le superutilisateur.

=item install

Installe, dans le répertoire courant, le ou les paquets source indiqués. Si
le paquet est déjà installé dans le répertoire courant, une mise à niveau
est tentée.

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

Cette commande s'assurera que les dépendances du paquet source sont
satisfaites.

Avec l'option --location, le paquet source sera installé ou mis à niveau à
l'emplacement indiqué au lieu du répertoire courant.

Avec l'option --build tous les paquets nouvellement installés ou mis à jour
seront compilés.

=item upgrade

Met à jour tous les paquets source installés, sauf avec les options
--location ou --here (ici), où seuls les paquets source situés dans le
répertoire indiqué seront mis à jour.

Avec l'option --patch (valeur par défaut), apt-src tentera de fabriquer une
rustine (patch) contenant tous les changements locaux apportés au paquet
source puis appliquera cette rustine à l'arborescence après sa mise à
jour. Ceci permet à vos changements locaux d'être préservés lors d'une mise
à niveau du paquet. Il peut arriver que cette méthode ne fonctionne pas,
vous devrez alors fusionner vos propres modifications à la main.

Avec l'option --build tous les paquets nouvellement installés ou mis à jour
seront compilés.

=item remove

Supprime le ou les paquets source spécifiés. Les options --location ou
--here (ici) peuvent être employées pour limiter la suppression des paquets
au répertoire indiqué.

=item build

Construit la ou les sources spécifiées. Si la source n'est pas encore
installée, elle le sera préalablement.

=item clean

Nettoie les arborescences du ou des paquets source spécifiés. Les options
--location ou --here (ici) peuvent être employées pour ne nettoyer que les
paquets du répertoire indiqué.

=item import

Permet d'informer apt-src de l'existence d'une arborescence source
préalablement dépaquetée. En plus du nom sous lequel elle doit être
importée, vous devez indiquer l'emplacement de cette arborescence source
(avec --location). Vous pouvez avoir besoin de spécifier la version de la
source (avec --version). N'espérez pas que la commande build fonctionne avec
cette source, à moins qu'elle ne possède un répertoire debian/

=item list

Sans autre paramètre, cette commande énumère tous les paquets source
installés et indique leur état ainsi que le répertoire où ils sont
installés. Si le nom d'un paquet est spécifié, la commande affichera
seulement les occurrences installées de ce paquet source. Si les options
--location ou --here sont employées, elles limiteront la liste aux paquets
du répertoire indiqué.

=item location

N'accepte qu'un seul S<paramètre :> Le nom du paquet source. Si le paquet
est installé, la commande renvoie le chemin de la racine de l'arborescence
du paquet source.

Cette commande peut être employée quand vous devez inclure des fichiers
provenant d'un autre paquet source, ou quelque chose comme ça. Par S<exemple
:>

I<apt-src location pkg>

=item version

N'accepte qu'un seul S<paramètre :> le nom du paquet source. Si le paquet
est installé, sa version est retournée.

=item name

N'accepte qu'un seul S<paramètre :> le nom d'un paquet source (une
expression rationnelle peut être utilisée). Renvoie le nom du paquet source
installé, correspondant au paramètre spécifié. S<(NdT : Utile> en cas
d'utilisation d'expression rationnelle.)

=back

=head1 OPTIONS

Toutes les options en ligne de commande peuvent être réglées par
l'intermédiaire du fichier de configuration. Les descriptions indiquent
l'option de configuration à régler. Pour les options booléennes vous pouvez
surcharger les valeurs par défaut du fichier en employant quelque chose
comme -f-, --no-f, -f=no ou d'autres variantes.

=over 4

=item B<-h>, B<--help>

Affiche ce fichier d'aide.

=item B<-b>, B<--build>, B<--compile>

Construit les paquets source après les avoir installés ou mis à
jour. Paramètre de S<configuration :> APT::Src::Compile

=item B<-i>, B<--installdebs>

Installe les paquets après avoir construit les sources. Implique l'usage de
--build. Paramètre de S<configuration :> APT::Src::InstallDebs

Notez que si des paquets multiples sont produits à partir d'un paquet source
unique, ils seront tous installés.

=item B<-p>, B<--patch>

Tente de réimplanter les changements locaux dans la nouvelle arborescence
après la mise à jour. Cette option est prise par défaut. Employer --no-p
pour ignorer cette action. Paramètre de S<configuration :> APT::Src::Patch

=item B<-l>, B<--location>

Spécifie un répertoire. Limite l'action aux paquets du répertoire
spécifié. Paramètre de S<configuration :> APT::Src::Location

=item B<-c>, B<--cwd>, B<--here>

Limite l'action aux paquets du répertoire courant. Paramètre de
S<configuration :> APT::Src::Here

=item B<--upstream-version>

Utilisable seulement avec la commande version. Permet de ne pas afficher le
numéro de version debian de la version du paquet.

=item B<-k>, B<--keep-built>

Conserve les .debs et les autres fichiers construits, après leur
installation, lors de l'usage de l'option --installdebs. Paramètre de
S<configuration :> APT::Src::KeepBuilt

=item B<-n>, B<--no-delete-source>

Conserve les fichiers source lors de la desinstallation d'un paquet
source. Paramètre de S<configuration :> APT::Src:NoDeleteSource

=item B<--version>

Spécifie une version de l'arborescence de la source. À utiliser avec la
commande d'importation.

=item B<-q>, B<--quiet>

Redirige toutes les sorties vers /dev/null à moins qu'une commande ne
fonctionne pas comme prévu. Paramètre de S<configuration :> APT::Src::Quiet

=item B<-t>, B<--trace>

Affiche chaque commande telle qu'elle est lancée. Paramètre de
S<configuration :> APT::Src::Trace

=back

En plus des options ci-dessus, il existe quelques éléments de configuration
moins utilisés. Ils ne peuvent être indiqués que dans les fichiers de
configuration /etc/apt/apt.conf et ~/.apt-src/config Il s'agit S<de :>

=over 4

=item APT::Src::BuildCommand

Indique la commande à employer pour construire le paquet. Cette commande
sera exécutée à partir de l'arborescence des sources. Par défaut S<«
dpkg-buildpackage - b -us -uc »,> avec S<« -rfakeroot »> ajouté pour les
utilisateurs autres que le superutilisateur.

=item APT::Src::RootCommand

Indique la commande à employer si un utilisateur autre que le
superutilisateur doit devenir superutilisateur. Elle est employée pour, par
exemple, satisfaire build-deps. sudo, la valeur par défaut, est un choix
judicieux. Si vous voulez employer su, vous devez le faire sous la forme S<«
su -c ».>

=item APT::Src::BuildDeps

Demande à apt-src d'installer les dépendances nécessaires au paquet source
lors de son installation ou de sa mise à jour. Actif par défaut. Si vous
désactivez cette option, certains paquets peuvent ne pas être construits en
raison de dépendances manquantes.

=back



=head1 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 déjà installés, vous devez,
actuellement, employer les noms des paquets source. (Cela pourrait changer
plus tard). Toutefois, vous pouvez employer des expressions rationnelles
pour spécifier les noms.

=head1 ENVIRONNEMENT

Ce programme définit APT_SRC_BUILD lorsqu'il construit un paquet.

=head1 EXEMPLES

Pour installer le paquet source S<« toto »> dans /usr/src, construire le
paquet et installer les .debs S<résultants :>

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

Pour suivre les changements du paquet source S<« toto »> déjà implanté et
installer les .debs à chaque fois qu'une nouvelle version est S<disponible
:>

  apt-src install -i toto

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

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

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

  apt-src install -i foo

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

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

Voici un exemple utilisé pour le paquet d'un module noyau dont le script
debian/rules cherche à déterminer s'il est construit par apt-src, pour, dans
ce cas, définir les variables KVERS, KSRC, et KDREV qui sont normalement
fixées par S<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

=head1 FICHIERS

=over 4

=item /etc/apt/sources.list

Emplacement des archives du système de distribution de paquets.

=item ~/.apt-src/status

Fichier d'état d'apt-src, qui liste les paquets installés.

=item /etc/apt/apt.conf

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

=item ~/.apt-src/config

Fichier de configuration propre à l'utilisateur pour apt-src.

=back

=head1 VOIR AUSSI

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

=head1 AUTEUR

Copyright 2002 Joey Hess <joeyh@debian.org>

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




=head1 TRADUCTION

Valéry Perrin <valery.perrin.debian@free.fr> le 18 octobre 2004.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.

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

N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans de cette page de manuel.

=cut
