Provided by: devscripts_2.11.1ubuntu3_i386 bug

NOM

       debcheckout - Recuperer le contenu du depot d'un paquet Debian

SYNOPSIS

       debcheckout [OPTIONS] PAQUET [REP_DESTINATION]
       debcheckout [OPTIONS] REP_D'EP^OT [REP_DESTINATION]
       debcheckout --help

DESCRIPTION

       debcheckout recupere les informations sur le systeme de gestion de
       version utilise pour la maintenance d'un paquet Debian (le parametre
       PAQUET), puis recupere la derniere version (potentiellement non
       officielle) du paquet depuis le depot. Par defaut le depot est recupere
       dans le repertoire PAQUET; mais ca peut etre change a l'aide du
       parametre REP_DESTINATION.

       Les informations indiquant ou se trouve le depot sont recherchees dans
       les champs Vcs-* du paquet source. Par exemple, le paquet vim fournit
       les informations en utilisant un champ Vcs-
       Git:git://git.debian.org/git/pkg-vim/vim.git que vous pouvez voir dans
       la sortie de apt-cache showsrc vim.

       Si plus d'un paquet source contenant des champs Vcs-* est disponible,
       debcheckout selectionnera le paquet avec le numero de version le plus
       eleve. Autrement, un numero de version specifique peut etre selectionne
       parmi ceux disponibles en utilisant la forme PAQUET=VERSION pour le nom
       de paquet.

       Si vous connaissez deja l'URL d'un depot, vous pouvez appeler
       directement debcheckout avec celle-ci, mais vous aurez probablement a
       utiliser le parametre -t approprie. C'est-a-dire que des heuristiques
       sont utilisees pour deviner le type de depot a partir de l'URL; si
       elles echouent, vous pouvez remplacer le type devine en utilisant -t.

       Les systemes de controle de versions actuellement pris en charge sont:
       Arch (arch), Bazaar (bzr), CVS (cvs), Darcs (darcs), Git (git),
       Mercurial (hg) et Subversion (svn).

OPTIONS

       OPTIONS G'EN'ERALES

       -a, --auth
           Utiliser le mode authentifie; cela signifie que pour les depots
           connus (principalement ceux heberges sur http://alioth.debian.org),
           une re-ecriture de l'URL est tentee avant d'effectuer la
           recuperation, pour s'assurer qu'il est possible d'envoyer les
           modifications dans le depot. Par exemple, pour les depots
           subversion heberges sur Alioth, cela signifie que
           svn+ssh://svn.debian.org/... sera utilise a la place de
           svn://svn.debian.org/...

       -d, --details
           N'afficher qu'une liste d'informations sur le depot du paquet, sans
           le recuperer; le format de sortie est une liste de champs, chaque
           champ etant une paire nom et valeur du champ separes par une
           tabulation. Les champs dependent du type de depot. Cette action
           peut necessiter une connexion reseau vers le depot distant.

           Consultez egalement -p. Cette option et l'option -p sont
           mutuellement exclusives.

       -h, --help
           Afficher un message d'aide detaille et quitter.

       -p, --print
           N'afficher qu'un resume des informations sur le depot du paquet,
           sans le recuperer; le format de sortie comprend deux champs separes
           par une tabulation: le type de depot et l'URL du depot. Cette
           action fonctionne hors-ligne, elle n'utilise que des informations
           <<statiques>> telles qu'elles sont connues du cache d'APT.

           Consultez egalement -d. Cette option et l'option -d sont
           mutuellement exclusives.

       -t TYPE, --type TYPE
           Forcer le type de depot (defini par defaut par des heuristiques
           basees sur l'URL ou, si les heuristiques echouent, <<svn>>); le
           type de depot doit etre un des types de depot geres.

       -u NOM_UTILISATEUR, --user NOM_UTILISATEUR
           Indiquer le nom d'utilisateur a utiliser en mode authentifie (voir
           -a). Cette option implique l'utilisation de -a: vous n'avez pas a
           preciser les deux.

       -f, --file
           Indiquer que le fichier mentionne doit etre extrait du depot et
           place dans le repertoire de destination. Elle peut etre utilisee
           plus d'une fois pour extraire plusieurs fichiers.

       --source=never|auto|download-only|always
           Certains paquets ne gardent que le repertoire debian en systeme de
           controle de versions. debcheckout permet de recuperer les morceaux
           manquants des sources avec apt-get source et de deplacer les
           fichiers dans le repertoire recupere.

           never
               N'utiliser que le depot.

           auto (defaut)
               Si le depot ne contient que le repertoire debian, recuperer le
               paquet source, le depaqueter, et mettre aussi le fichier
               .orig.tar.gz dans le repertoire actuel. Sinon, ne rien faire.

           download-only
               Toujours recuperer le fichier .orig.tar.gz, mais ne jamais le
               depaqueter.

           always
               Toujours recuperer le fichier .orig.tar.gz, et si le depot ne
               contient que le repertoire debian, le depaqueter.

       OPTIONS SPECIFIQUES AU SYST`EME DE CONTR^OLE DE VERSIONS

       OPTIONS SP'ECIFIQUES `A GIT

       --git-track BRANCHES
           Indiquer une liste de branches qui seront configurees pour etre
           suivies (comme avec gitbranch--track, consultez git-branch(1)) une
           fois que le depot Git distant sera clone. La liste doit etre une
           liste de noms de branches, separes par des espaces.

           Comme raccourci, la chaine <<*>> peut etre fournie pour demander le
           suivi de toutes les branches distantes.

VARIABLES DE CONFIGURATION

       Les deux fichiers de configuration /etc/devscripts.conf et
       ~/.devscripts sont charges dans cet ordre par un interpreteur de
       commandes pour definir les variables de configuration. Des options de
       ligne de commande peuvent etre utilisees pour ecraser les parametres
       des fichiers de configuration. Les parametres des variables
       d'environnement sont ignores a cette fin. Les variables actuellement
       reconnues sont:

       DEBCHECKOUT_AUTH_URLS
           Cette variable doit etre une listes d'expression rationnelles Perl
           et de textes de remplacements separees par des espaces, qui doivent
           etre fournies par paires: REGEXP TEXTE REGEXP TEXTE... Chaque paire
           indique une substitution qui est appliquee aux URL des depots si
           les autres moyens internes pour construire des URLS pour le mode
           authentifie (voir -a) ont echoues.

           Les references a des sous-chaines sont autorisees dans les textes
           de remplacement comme d'habitude avec Perl en utilisant $1, $2, ...

           Cette configuration permet d'activer le mode authentifie pour la
           plupart des depots existants. Notez que les depots Debian de
           alioth.debian.org ($vcs.debian.org) sont implicitement definis.

           Voici un bout d'exemple qui conviendra pour les fichiers de
           configuration:

            DEBCHECKOUT_AUTH_URLS='
             ^\w+://(svn\.example\.com)/(.*)    svn+ssh://$1/srv/svn/$2
             ^\w+://(git\.example\.com)/(.*)    git+ssh://$1/home/git/$2
            '

           Veuillez noter que les blancs ne sont autorises ni dans les
           expressions rationnelles ni dans les textes de remplacement. Aussi,
           comme les fichiers de configuration sont souvent lus par les
           interpreteurs de commandes avec <<source>>, vous avez interet a
           utiliser des guillemets simples autour de la valeur de cette
           variable.

VOIR AUSSI

       apt-cache(8), Section 6.2.5 de la reference du developpeur Debian (pour
       plus d'informations sur les champs Vcs-*):
       http://www.debian.org/doc/developers-reference/best-pkging-practices.html#bpp-vcs

AUTEUR

       debcheckout et cette page de manuel ont ete ecrits par Stefano
       Zacchiroli <zack@debian.org>.

TRADUCTION

       Cyril Brulebois <cyril.brulebois@enst-bretagne.fr>, 2006

       Thomas Huriaux <thomas.huriaux@gmail.com>, 2006