Provided by:
devscripts_2.11.1ubuntu3_i386 
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