Provided by:
devscripts_2.11.1ubuntu3_i386 
NOM
bts - Interface en ligne de commande pour le BTS, pour les developpeurs
SYNOPSIS
bts [options] commande [param`etres] [#commentaire] [.|, commande
[param`etres] [#commentaire]] ...
DESCRIPTION
Cela est une interface au systeme de suivi de bogues en ligne de
commande, principalement destinee a l'usage des developpeurs. Elle
permet de manipuler le BTS via de simples commandes pouvant etre
lancees depuis une invite de commandes ou depuis un script, effectue
diverses verifications de la validite des donnees entrees, afin de
creer et d'envoyer pour vous un message a l'adresse de controle du BTS.
Un cache local des pages web et des messages du BTS peut aussi etre
cree et mis a jour.
En general, cette interface en ligne de commande est la meme que si
vous vouliez ecrire un message a control@bugs.debian.org, simplement
precedee de <<bts>>. Par exemple:
% bts severity 69042 normal
% bts merge 69042 43233
% bts retitle 69042 bla bla
Quelques commandes supplementaires ont ete ajoutees pour votre confort,
et ce programme est moins strict sur la validite des numeros de bogue.
Par exemple, <<severity Bug#85942 normal>> est compris, tout comme
<<severity #85942 normal>>. (Bien sur, votre interpreteur de commandes
peut comprendre <<#>> comme un caractere de commentaire, donc il faudra
probablement le mettre entre guillemets.)
De meme, pour vous faciliter la vie, ce programme vous permet d'abreger
les commandes en la plus courte sous-chaine unique (d'une maniere
similaire a celle de cvs). Ainsi des choses comme <<bts cl 85942>> sont
comprises.
Il est aussi possible d'inclure un commentaire dans le message envoye
au BTS. Si votre interpreteur de commandes ne supprime pas le
commentaire dans une commande telle que <<bts severity 30321 normal
#severite augmentee>>, alors ce programme se debrouille pour trouver ou
se situe le commentaire et pour l'inclure dans le message. Notez que la
plupart des interpreteurs de commandes ne tiennent pas compte de ce
type de commentaires avant d'executer le programme, a moins que ce
commentaire soit place entre guillemets. (Quelque chose comme <<bts
severity #85942 normal>> ne sera pas traite comme un commentaire.)
Vous pouvez indiquer plusieurs commandes en les separant par un simple
point, comme pour update-rc.d; une simple virgule peut aussi etre
utilisee; toutes les commandes seront envoyees dans un seul message. Il
est necessaire d'entourer les points et les virgules par des espaces
pour ne pas etre confondus avec des portions de commandes. Par exemple
(en protegeant ce qui doit l'etre de maniere a ce que bts voie le
commentaire correctement):
% bts severity 95672 normal , merge 95672 95673 \#Il s\'agit des S<memes !>
L'abreviation <<it>> peut etre utilisee pour designer le dernier numero
de bogue mentionne, donc vous pouvez ecrire:
% bts severity 95672 wishlist , retitle it "bts: SVP ajoutez une option --toto"
Merci d'utiliser ce programme d'une facon raisonnable et de prendre nos
utilisateurs en consideration.
OPTIONS
bts examine les fichiers de configuration de devscripts comme decrit
ci-dessous. Les options en ligne de commande permettent de remplacer
les parametres des fichiers de configuration.
-o, --offline
Faire en sorte que bts utilise la mise en cache des bogues pour les
commandes show et bugs, si un cache est disponible pour les donnees
demandees. Veuillez vous reporter a la commande cache ci-dessous
pour plus d'informations sur la mise en place d'un cache.
--online, --no-offline
Contraire de l'option --offline; ecraser toute directive venant
d'un fichier de configuration afin de travailler hors ligne.
-n, --no-action
Ne pas envoyer le courrier, mais l'afficher sur la sortie standard.
--cache, --no-cache
Essayer ou non de mettre en cache de nouvelles versions des pages
du BTS lorsque des commandes show ou bugs sont lancees. Par defaut,
la mise en cache est activee.
--cache-mode={min|mbox|full}
Lors d'une utilisation de la commande bts cache, seulement faire un
miroir basic du bogue (min), inclure aussi la version mbox (mbox),
ou tout l'ensemble, a savoir la mbox et les differents fichiers
joints des pages du BTS, ainsi que les messages de confirmation
(full). Par defaut, min est utilise.
--cache-delay=secondes
Delai (en secondes) entre deux telechargements, afin d'eviter de
surcharger le serveur web du BTS. Il est de 5 secondes par defaut.
--mbox
Ouvrir un client de messagerie pour parcourir la boite de
messagerie (<<mbox>>) correspondant a un numero de bogue donne,
pour les commandes show et bugs.
--mailreader=CLIENT_DE_MESSAGERIE
Indiquer la commande pour lire la boite de messagerie (<<mbox>>).
Doit contenir une chaine <<%s>>, qui sera remplacee par le nom du
fichier mbox. La commande sera decoupee en fonction des espaces et
ne sera pas passee a un interpreteur de commandes (<<shell>>). Par
defaut, <<mutt -f %s>> sera utilise (par ailleurs %% sera remplace
par un simple % si necessaire).
--cc-addr=CC_ADRESSES_'ELECTRONIQUES
Envoyer une copie conforme du message a une liste d'utilisateurs.
CC_ADRESSES_'ELECTRONIQUES doit etre une liste d'adresses separees
par des virgules.
--use-default-cc
Ajouter les adresses indiquees par l'option BTS_DEFAULT_CC du
fichier de configuration a la liste indiquee en utilisant
--cc-addr. C'est le comportement par defaut.
--no-use-default-cc
Ne pas ajouter les adresses indiquees dans BTS_DEFAULT_CC dans la
liste des copies conformes.
--sendmail=COMMANDE_D_ENVOI_DE_MESSAGE
Indiquer la commande d'envoi de message a utiliser. La commande
sera separee a chaque espace, et non passee a l'interpreteur de
commandes. La valeur par defaut est /usr/sbin/sendmail. L'option -t
est ajoutee automatiquement si la commande est /usr/sbin/sendmail
ou /usr/sbin/exim*. Pour les autres logiciels, l'option -t doit
etre incluse dans COMMANDE_D_ENVOI_DE_MESSAGE si necessaire, par
exemple: --sendmail="/usr/sbin/monutilitaire -t".
--mutt
Utiliser mutt pour l'envoi des messages. Par defaut, mutt n'est pas
utilise, sauf pour certaines commandes.
Notez que $DEBEMAIL ou $EMAIL doit etre configuree dans
l'environnement pour que mutt puisse envoyer des courriers.
--no-mutt
Ne pas utiliser mutt pour l'envoi des messages.
--smtp-host=SERVEUR_SMTP
Indiquer un serveur SMTP. S'il est fourni, bts enverra les
courriers en utilisant directement ce serveur SMTP plutot qu'en
utilisant la commande sendmail.
Le nom d'hote peut etre suivi d'un caractere deux-points (<<:>>) et
d'un numero de port afin d'utiliser un port autre que le port par
defaut. Il peut egalement commencer par <<ssmtp://>> ou
<<smtps://>> pour indiquer que le protocole SMTPS doit etre
utilise.
Notez que $DEBEMAIL ou $EMAIL doit etre configuree dans
l'environnement pour l'envoi de courriers par connexion SMTP
directe.
Notez qu'en envoyant les courriers directement a un serveur SMTP,
si des adresses de --cc-addr ou BTS_DEFAULT_CC ne sont pas relayees
par le serveur SMTP, alors le serveur SMTP rejettera le courrier en
entier.
Notez egalement que la commande reassign peut, quand le mode
--interactive ou --force-interactive est active, conduire a l'ajout
automatique d'un Cc pour $nouveau_paquet@packages.debian.org. Dans
ce cas, la note ci-dessus a propos des relais s'applique.
L'interface de soumission (port 587) de reportbug.debian.org ne
prend pas en charge les relais et ne devrait donc pas etre utilisee
comme serveur SMTP pour bts dans les circonstances decrites dans ce
paragraphe.
--smtp-username=NOM_UTILISATEUR, --smtp-password=MOT_DE_PASSE
Indiquer les informations d'identification a utiliser pour la
connexion au serveur SMTP indique par --smtp-host. Si le serveur ne
necessite pas d'identification, alors ces options ne devraient pas
etre utilisees.
Si un nom d'utilisateur est indique mais pas de mot de passe, bts
demandera le mot de passe avant l'envoi du courrier.
--smtp-helo=HELO
Indiquer le nom a utiliser dans la commande HELO lors de la
connexion au serveur SMTP; par defaut, c'est le contenu du fichier
/etc/mailname, s'il existe.
Notez que certains serveurs SMTP peuvent rejeter l'utilisation d'un
HELO qui ne peut pas etre resolu ou qui ne semble pas appartenir a
l'hote qui l'utilise.
--bts-server
Utiliser un serveur debbugs autre que bugs.debian.org.
-f, --force-refresh
Telecharger le rapport de bogue a nouveau, meme s'il ne semble pas
avoir change depuis la derniere commande cache. Utile si une option
--cache-mode=full est utilisee la premiere fois (sinon les rapports
de bogue inchanges ne seront pas telecharges a nouveau, meme si les
parties ininteressantes n'ont pas ete telechargees).
--no-force-refresh
Ne tenir compte d'aucune option --force-refresh venant d'un fichier
de configuration.
--only-new
Ne telecharger que les nouveaux bogues pour la mise en cache. Ne
pas verifier si les bogues deja telecharges ont ete modifies.
--include-resolved
Lors de la mise en cache des rapports de bogue, inclure ceux qui
sont marques comme etant resolus. C'est le comportement par defaut.
--no-include-resolved
Inverser le comportement de l'option precedente. C'est-a-dire, ne
pas mettre les bogues dans le cache s'ils sont marques comme etant
resolus.
--no-ack
Supprimer les courriers de confirmation du BTS. Notez que cela
n'affectera que les copies des courriers en copie des bogues, pas
celles envoyees par le robot <<control>>.
--ack
Ne pas supprimer les courriers de confirmation. C'est le
comportement par defaut.
-i, --interactive
Avant d'envoyer un courrier au robot <<control>>, afficher son
contenu et permettre de l'editer ou d'annuler l'envoi.
--force-interactive
Semblable a --interactive, a l'exception qu'un editeur est lance
avant de demander la confirmation de l'envoi du courrier.
--no-interactive
Envoyer des courrier a <<control>> sans confirmation. C'est le
comportement par defaut.
-q, --quiet
En lancant bts cache, n'afficher que les informations concernant
les pages nouvellement mises en cache, et non les messages
indiquant ce qui a deja ete mis en cache. Si cette option est
fournie deux fois, n'afficher que les messages d'erreur, vers la
sortie d'erreur (<<stderr>>).
--no-conf, --noconf
Ne lire aucun fichier de configuration. L'option ne peut etre
utilisee qu'en premiere position de la ligne de commande.
COMMANDES
Pour tous les details sur les commandes, veuillez consulter la
documentation du BTS. http://bugs.debian.org/Bugs/server-control
<http://bugs.debian.org/Bugs/server-control>
show [options] [num'ero_de_bogue | paquet | responsable | : ] [opt=val
...]
show [options] [src:paquet | from:rapporteur] [opt=val ...]
show [options] [tag:'etiquette | usertag:'etiquette] [opt=val ...]
show [release-critical | release-critical/... | RC]
Cela est un synonyme pour bts bugs.
bugs [options] [num'ero_de_bogue | paquet | responsable | : ] [opt=val
...]
bugs [options] [src:paquet | from:rapporteur] [opt=val ...]
bugs [options] [tag:'etiquette | usertag:'etiquette] [opt=val ...]
bugs [release-critical | release-critical/... | RC]
Afficher la page referencant les bogues demandes dans un navigateur
web en utilisant sensible-browser(1).
Des options peuvent etre indiquees apres la commande bugs en plus
ou a la place des options au debut de la ligne de commande. Les
options reconnues pour l'instant sont: -o/--offline/--online,
--mbox, --mailreader et --[no-]cache. Celles-ci sont expliquees
plus haut dans cette page de manuel. Si -o ou --offline est
utilisee, ou s'il y a deja une copie a jour dans le cache local,
les versions mises en cache vont etre utilisees.
Les significations des arguments possibles sont les suivantes:
(aucune)
Si rien n'est indique, bts bugs va afficher vos bogues, en
supposant que soit DEBEMAIL, soit EMAIL (considerees dans
cet ordre) est definie a l'adresse electronique desiree.
num'ero_de_bogue
Afficher le bogue de numero num'ero_de_bogue.
paquet Afficher les bogues du paquet paquet.
src:paquet
Afficher les bogues du paquet source paquet.
responsable
Afficher les bogues dont le responsable a pour adresse
electronique responsable.
from:rapporteur
Afficher les bogues dont le rapporteur a pour adresse
electronique rapporteur.
tag:'etiquette
Afficher les bogues marques avec 'etiquette.
usertag:'etiquette
Afficher les bogues marques avec l'etiquette utilisateur
'etiquette. Veuillez consulter la documentation du BTS pour
plus d'informations sur les etiquettes utilisateur. Cela
necessite d'utiliser une option users=adresse.
: Les details concernant le systeme de suivi de bogues, ainsi
qu'une page de recherche dans les bogues contenant plus
d'options que ce script, peuvent etre trouves a
http://bugs.debian.org/. Cette page peut etre ouverte via
la commande bts bugs :.
release-critical, RC
Afficher le sommaire des pages du BTS concernant les
rapports de bogues critiques pour la prochaine publication.
Cela est un synonyme pour
http://bugs.debian.org/release-critical/index.html. Il est
aussi possible d'indiquer release-critical/debian/main.html
et de meme RC est synonyme de
release-critical/other/all.html.
Apres le parametre indiquant quoi afficher, vous pouvez indiquer
des options facultatives pour formater la page ou changer ce qui
doit etre affiche. Celles-ci sont passees au BTS via l'URL
demandee. Par exemple, passez dist=stable pour afficher les bogues
touchant la version stable d'un paquet, version=1.0 pour voir les
bogues touchant cette version d'un paquet, ou reverse=yes pour
afficher d'abord les messages les plus recents dans le fichier
journal des bogues.
Si la mise en cache a ete activee (c'est-a-dire si --no-cache n'a
pas ete utilisee et si la variable BTS_CACHE ne vaut pas no), alors
toute page demandee via bts show va etre automatiquement mise en
cache et sera donc disponible pour etre visualisee plus tard tout
en etant hors ligne. Les pages mises en cache automatiquement de
cette maniere seront supprimees lors d'invocations ulterieures de
bts show|bugs|cache si on n'y accede pas dans les 30jours.
Attention: sur un systeme de fichiers monte avec l'option
<<noatime>>, l'execution de bts show|bugs ne met pas a jour les
heures et dates d'acces aux fichiers du cache; un bogue mis en
cache sera donc nettoye automatiquement 30 jours apres son
telechargement initial, meme si on y accede entre temps.
Toute autre commande bts suivant cela sur la ligne de commande sera
executee apres que le navigateur aura quitte.
Le navigateur voulu peut etre indique et configure en definissant
la variable d'environnement BROWSER. Les conventions suivent celles
definies par Eric Raymond a l'adresse
http://www.catb.org/~esr/BROWSER/; nous reproduisons ici les
informations pertinentes.
La variable BROWSER peut etre constituee d'une serie de commandes
de navigateur separees par des deux-points. Celles-ci devraient
etre essayees successivement jusqu'a ce qu'il y en ait une qui
fonctionne. Chaque commande peut contenir la chaine %s; si c'est le
cas, celle-ci est remplacee par l'URL a afficher. Si une des
commandes ne contient pas %s, le navigateur est lance comme si
l'URL avait ete indiquee en tant que premier parametre. La chaine
%% doit etre remplacee par un simple <<%>>.
Justification: nous devons pouvoir indiquer plusieurs navigateurs
de maniere a ce que les programmes suivant cette convention
puissent faire ce qu'il faut que ce soit dans un environnement
graphique ou console, en essayant un environnement graphique
d'abord. Indiquer plusieurs commandes peut etre utile a ceux qui
partagent des fichiers, comme leur .profile, entre plusieurs
systemes. %s est necessaire parce que la plupart des navigateurs
ont une syntaxe qui l'exige. Enfin, %% doit etre transforme en %,
sinon il ne serait pas possible d'avoir un %s litteral dans la
chaine.
Par exemple, sur la plupart des systemes Linux, une bonne chose a
faire serait:
BROWSER='mozilla -raise -remote "openURL(%s,new-window)":links'
select [clef:valeur ...]
Utiliser l'interface SOAP pour sortir une liste de bogues qui
correspondent a certains criteres de recherche.
Les clefs suivantes sont autorisees, et peuvent etre utilisees
plusieurs fois.
package Nom d'un paquet binaire.
source Nom d'un paquet source.
maintainer
Adresse electronique du responsable.
submitter
Adresse electronique de l'auteur du bogue.
severity
Severite du bogue.
status Etat du bogue. Soit open, done ou forwarded.
tag Etiquettes attachees au bogue. Si users est indique, les
etiquettes peuvent etre des <<usertags>> en plus des
etiquettes traditionnelles.
owner Proprietaire du bogue.
correspondent
Adresse d'une personne qui a envoye un courrier au journal.
affects Bogues qui affectent ce paquet.
bugs Liste de bogues dans lesquels chercher.
users Utilisateurs a utiliser pour la recherche d'etiquettes
utilisateur (<<usertags>>).
archive Rechercher des bogues archives ou des bogues normaux; la
valeur par defaut est 0 (c'est-a-dire ne chercher que les
bogues normaux). Une valeur particuliere, both, permet de
rechercher a la fois parmi les bogues archives et non
archives.
Par exemple, pour selectionner l'ensemble des bogues envoyes par
undeveloppeur@example.com qui ont l'etiquette wontfix, on
utilisera:
bts select submitter:undeveloppeur@example.com tag:wontfix
Si une clef est utilisee plusieurs fois alors les bogues
selectionnes sont ceux qui correspondent a une des valeurs
fournies; par exemple:
bts select package:toto severity:wishlist severity:minor
renvoie tous les bogues du paquet toto de severite wishlist ou
minor.
status [bogue | file:fichier | fields:champ[,champ ...] | verbose] ...
Utiliser l'interface SOAP pour fournir les informations d'etat pour
les bogues indiques (ou lus dans les fichiers fournis; utilisez -
pour indiquer l'entree standard).
Par defaut, tout les champs existants du bogue sont affiches.
Si verbose est fournie, les champs vides sont egalement affiches.
Si fields est fournie, seuls ces champs seront affiches. Aucune
verification de validite n'est realisee sur les champs indiques.
clone bogue nouvel_ID [nouvel_ID ...]
La commande de controle clone vous permet de dupliquer un rapport
de bogue. Cela est utile dans le cas ou un rapport de bogue unique
indique en fait que plusieurs bogues distincts se produisent. Les
<<nouveaux ID>> sont des nombres negatifs, separes par des espaces,
qui peuvent etre utilises dans les commandes de controle suivantes
pour se referer aux rapports de bogue nouvellement dupliques. Un
nouveau rapport de bogue est genere pour chaque nouvel identifiant.
done bogue [version]
Fermer le bogue. Le mode interactif est force puisqu'un message de
fermeture doit contenir une explication. La version du paquet dans
laquelle le bogue a ete corrige doit si possible etre indiquee.
reopen bogue [rapporteur]
Reouvrir un bogue, avec rapporteur optionnel.
archive bogue
Archiver un bogue qui a deja ete archive, mais ne l'est plus. Le
bogue doit satisfaire a tous les criteres pour les bogues archives,
sauf celui de la periode d'attente.
unarchive bogue
Desarchiver un bogue qui est deja archive.
retitle bogue titre
Changer le titre du bogue.
summary bogue [num'ero_message]
Selectionner un numero de message qui doit etre utilise comme
resume d'un bogue.
Si aucun numero de message n'est fourni, le resume est supprime.
submitter bogue [bogue ...] adresse-du-rapporteur
Changer l'adresse electronique du rapporteur du ou des bogues, ou !
signifie <<utiliser l'adresse electronique courante en tant que
nouvelle adresse du rapporteur>>.
reassign bogue [bogue ...] paquet [version]
Reassigner un bogue ou un ensemble de bogues a un paquet different.
Le champ version est optionnel; veuillez consulter les explications
sur http://www.debian.org/Bugs/server-control
<http://www.debian.org/Bugs/server-control>.
found bogue [version]
Indiquer qu'un bogue a ete decouvert dans une version particuliere
d'un paquet.
notfound bogue version
Enlever l'indication concernant la version dans laquelle ce bogue a
ete decouvert.
fixed bogue version
Indiquer qu'un bogue a ete corrige dans une version particuliere
d'un paquet, sans changer l'etat ouvert ou ferme du bogue.
notfixed bogue version
Enlever l'indication que ce bogue est corrige dans une version
donnee.
Cette commande est equivalente a la sequence <<found bogue
version>>, <<notfound bogue version>>.
block bogue by|with bogue [bogue ...]
Enregistrer que la resolution d'un bogue est bloquee par un
ensemble d'autres bogues.
unblock bogue by|with bogue [bogue ...]
Enregistrer que la resolution d'un bogue n'est plus bloquee par un
ensemble d'autres bogues.
merge bogue bogue [bogue ...]
Fusionner plusieurs bogues.
forcemerge bogue bogue [bogue ...]
Forcer la fusion d'un ensemble de bogues entre eux. Le premier
bogue est le bogue maitre et sa configuration (cette configuration
qui doit correspondre pour les fusions normales avec merge) est
donnee a tous les bogues qui suivent.
unmerge bogue
Annuler la fusion d'un bogue.
tag bogue [+|-|=] 'etiquette ['etiquette ..]
tags bogue [+|-|=] 'etiquette ['etiquette ..]
Ajouter ou retirer une 'etiquette a un bogue. L'etiquette peut etre
indiquee par son nom exact ou etre abregee en la plus courte
sous-chaine unique. (Ainsi fixed va ajouter l'etiquette fixed et
non fixed-upstream, par exemple, mais fix ne sera pas accepte.)
Plusieurs etiquettes peuvent etre indiquees simultanement. Les deux
commandes (tag et tags) sont identiques. Il est necessaire
d'indiquer au moins une etiquette, a moins que l'argument = ne soit
utilise; la commande
bts tags <bogue> =
va supprimer toutes les etiquettes du bogue indique.
Comme cas particulier, l'etiquette non officielle gift est prise en
charge en plus des etiquettes officielles. gift est utilisee comme
raccourci pour l'etiquette utilisateur (<<usertag>>) gift;
consultez <http://wiki.debian.org/qa.debian.org/GiftTag>. L'ajout
ou la suppression de l'etiquette gift ajoutera ou supprimera
l'etiquette utilisateur gift, pour l'utilisateur
<<debian-qa@lists.debian.org>>.
affects bogue [+|-|=] paquet [paquet ...]
Indiquer qu'un bogue affecte un paquet autre que celui pour lequel
il est enregistre; le bogue sera liste par defaut dans la liste des
bogues de l'autre paquet. Ce n'est generalement a utiliser que si
le bogue est suffisamment important et si de nombreux bogues sont
remontes sur le mauvais paquet par des utilisateurs.
user adresse
Indiquer l'adresse electronique d'un utilisateur avant d'utiliser
la commande usertags.
usertag bogue [+|-|=] 'etiquette ['etiquette ...]
usertags bogue [+|-|=] 'etiquette ['etiquette ...]
Ajouter ou retirer une 'etiquette utilisateur a un bogue. Le nom
exact de celle-ci doit etre utilise; il n'y a ni valeur par defaut
ni verification de la validite des noms d'etiquette. Plusieurs
etiquettes peuvent etre indiquees simultanement. Les deux commandes
(usertag et usertags) sont identiques. Il est necessaire d'indiquer
au moins une 'etiquette utilisateur, a moins que l'argument = ne
soit utilise; la commande
bts usertags <bogue> =
va supprimer toutes les etiquettes utilisateur du bogue indique.
claim bogue [adresse]
Enregistrer que vous avez reclame un bogue (par exemple pour une
bug squashing party). adresse doit etre une chaine unique
permettant d'identifier les bogues que vous avez reclame; une
adresse electronique est souvent utilisee.
Si aucune adresse n'est fournie, les variables d'environnement
DEBEMAIL et EMAIL sont utilisees (dans cet ordre).
unclaim bogue [adresse]
Supprimer votre revendication pour un bogue.
Si aucune adresse n'est fournie, les variables d'environnement
DEBEMAIL et EMAIL sont utilisees (dans cet ordre).
severity bogue s'ev'erit'e
Changer la s'ev'erit'e d'un bogue. Les severites possibles sont:
wishlist, minor, normal, important, serious, grave et critical.
Cette severite peut etre abregee en une sous-chaine unique.
forwarded bogue adresse
Marquer le bogue comme transmis a l'adresse donnee (normalement une
adresse electronique ou une URL pour un systeme de suivi amont).
notforwarded bogue
Marquer le bogue comme n'ayant pas ete transmis.
package [paquet ...]
Les commandes suivantes ne vont s'appliquer qu'aux bogues touchant
les paquets indiques; il s'agit d'un mecanisme de surete pour le
BTS. Si aucun paquet n'est liste, cette verification est desactivee
a nouveau.
limit [clef[:valeur]] ...
Les commandes suivantes ne vont s'appliquer qu'aux bogues
correspondant aux criteres indiques; il s'agit d'un mecanisme de
surete pour le BTS. Si aucune valeur n'est indiquee, les limites
pour cette clef sont desactivees. Si aucune clef n'est indiquee,
les limites sont remises a zero.
submitter
Adresse electronique de l'auteur du bogue.
date Date a laquelle le bogue a ete soumis.
subject Sujet du bogue.
msgid Identifiant du message du rapport de bogue initial.
package Nom d'un paquet binaire.
source Nom d'un paquet source.
tag Etiquettes du bogue.
severity
Severite du bogue.
owner Proprietaire du bogue.
affects Bogues qui affectent ce paquet.
archive Rechercher des bogues archives ou des bogues normaux; la
valeur par defaut est 0 (c'est-a-dire ne chercher que les
bogues normaux). Une valeur particuliere, both, permet de
rechercher a la fois parmi les bogues archives et non
archives.
Par exemple, pour limiter l'ensemble des bogues pour lesquels vont
s'appliquer les commandes de controle qui suivent a ceux envoyes
par undeveloppeur@example.com qui ont l'etiquette wontfix, on
utilisera:
bts limit submitter:undeveloppeur@example.com tag:wontfix
Si une clef est utilisee plusieurs fois alors les bogues
selectionnes sont ceux qui correspondent a une des valeurs
fournies; par exemple:
bts limit package:toto severity:wishlist severity:minor
n'applique les commandes de controle qui suivent qu'aux bogues du
paquet toto avec pour severite wishlist ou minor.
owner bogue adresse-du-propri'etaire
Changer l'adresse electronique du <<proprietaire>> du bogue, ou !
signifie <<utiliser l'adresse electronique courante comme nouvelle
adresse de proprietaire>>.
Le proprietaire d'un bogue accepte la responsabilite de s'en
occuper. Cependant, le proprietaire d'un bogue ne recoit pas
automatiquement les mails correspondants; il faut utiliser la
commande subscribe pour cela.
noowner bogue
Marquer un bogue comme n'ayant pas de <<proprietaire>>.
subscribe bogue [adresse]
Abonner l'adresse electronique donnee au rapport de bogue indique.
Si aucune adresse n'a ete fournie, la variable d'environnement
DEBEMAIL ou EMAIL (dans cet ordre) est utilisee. Si aucune n'est
definie, ou si ! est donne comme adresse electronique, votre
adresse par defaut va etre utilisee.
Apres avoir execute cette commande, vous allez recevoir une
confirmation d'abonnement a laquelle vous devez repondre. En etant
abonne a un rapport de bogue, vous allez recevoir tous les messages
et notifications pertinents. Utilisez la commande unsubscribe pour
vous desabonner.
unsubscribe bogue [adresse]
Desabonner l'adresse electronique utilisee du rapport de bogue
indique. Comme pour la commande subscribe decrite ci-dessus, si
aucune adresse n'a ete fournie, la variable d'environnement
DEBEMAIL ou EMAIL (dans cet ordre) est utilisee. Si aucune n'est
definie, ou si ! est donne comme adresse electronique, votre
adresse par defaut va etre utilisee.
Apres avoir execute cette commande, vous allez recevoir une
confirmation de desabonnement a laquelle vous devez repondre.
Utilisez la commande subscribe, evidemment, pour vous abonner.
reportspam bogue ...
La commande reportspam vous permet de signaler un rapport de bogue
comme contenant du pourriel. Cela evite de passer par la page web
du rapport de bogue pour ce faire.
spamreport bogue ...
spamreport est synonyme de reportspam.
cache [options] [adresse_resp.] | paquet | src:paquet |
from:rapporteur]
cache [options] [release-critical | release-critical/... | RC]
Creer ou mettre a jour le cache des rapports de bogue pour
l'adresse electronique ou le paquet indique. Par defaut, cela
telecharge tous les bogues appartenant a l'adresse electronique
stockee dans la variable d'environnement DEBEMAIL (ou dans la
variable d'environnement EMAIL si DEBEMAIL n'est pas definie).
Cette commande peut etre repetee pour mettre en cache des bogues
appartenant a plusieurs personnes ou touchant plusieurs paquets. Si
plusieurs paquets ou adresses sont fournis, les bogues
correspondant a l'un des parametres seront mis en cache; ceux
correspondant a plusieurs parametres ne seront telecharges qu'une
seule fois. Les bogues mis en cache sont stockes dans
~/.devscripts_cache/bts/.
Vous pouvez utiliser le cache grace a l'option -o. Par exemple:
bts -o bugs
bts -o show 12345
Ainsi, une fois que le cache est mis en place, bts va mettre a jour
les fichiers contenus dans celui-ci au coup par coup quand il
telecharge des informations depuis le BTS avec la commande show. Il
est donc possible de mettre en place un cache, et de le mettre a
jour une fois par semaine, tout en laissant les mises a jour
automatiques se faire pour les bogues auxquels vous accedez
frequemment pendant la semaine.
Certaines options modifient le comportement de la commande cache.
La premiere est --cache-mode, qui controle a quel point bts
telecharge les liens references depuis la page du bogue, ce qui
inclut des choses penibles comme les messages de confirmation, les
messages au robot de controle, et la version mbox du rapport de
bogue. Trois valeurs sont acceptees: min (le minimum), mbox
(telecharger le minimum plus la version mbox du rapport de bogue)
ou full. La seconde option qui modifie le comportement de la
commande cache est --force-refresh ou -f, qui force le
telechargement, meme si le rapport de bogue mis en cache est a
jour.L'option --include-resolved indique si les rapports de bogue
marques comme etant resolus doivent etre telecharges lors de la
mise en cache.
Toutes ces options sont configurables dans le fichier de
configuration, comme decrit ci-dessous. Elles peuvent aussi bien
etre indiquees apres la commande cache qu'au debut de la ligne de
commande.
Enfin, -q ou --quiet supprime les messages indiquant que le cache
est a jour et utiliser cette option deux fois va supprimer tous les
messages a propos du cache (a l'exception des messages d'erreur).
Attention a la mise en cache RC: cela met vraiment LONGTEMPS! (Avec
plus de mille bogues RC et un delai de 5secondes entre chaque
bogue, vous allez avoir besoin d'un minimum d'une heure et demie,
et probablement bien plus que ca.)
cleancache paquet | src:paquet | responsable
cleancache from:rapporteur | tag:'etiquette | usertag:'etiquette | num'ero
| ALL
Supprimer le cache du paquet, responsable, etc., indique, comme
decrit plus haut dans la commande bugs, ou supprimer tout le cache
si ALL est indique. Cela est utile si vous avez un acces permanent
au reseau ou si la base de donnees a ete corrompue pour une raison
quelconque. Notez que par securite la commande ne prendra pas la
valeur de DEBEMAIL ou EMAIL par defaut.
version
Afficher la version et le copyright.
help
Afficher un court resume des commandes, de maniere similaire a
certaines parties de cette page de manuel.
VARIABLES D'ENVIRONNEMENT
DEBEMAIL
Si cela est defini, la ligne From: du message va etre configuree
pour utiliser cette adresse electronique au lieu de votre adresse
habituelle (qui serait determinee par mail).
DEBFULLNAME
Si DEBEMAIL est definie, DEBFULLNAME est examinee pour determiner
le nom complet a utiliser; sinon bts essaie de determiner un nom a
partir de votre entree passwd.
BROWSER
Si elle est definie, elle indique le navigateur a utiliser pour les
options show et bugs. Consultez la description precedente.
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:
BTS_OFFLINE
Lui attribuer la valeur yes equivaut a utiliser le parametre en
ligne de commande --offline. Cela n'affecte que les commandes show
et bugs. La valeur par defaut est no. Veuillez consulter la
description de la commande show ci-dessus pour plus d'informations.
BTS_CACHE
Lui attribuer la valeur no, equivaut a utiliser le parametre en
ligne de commande --nocache. Cela n'affecte que les commandes show
et bug. La valeur par defaut est yes. A nouveau, veuillez consulter
la commande show ci-dessus pour plus d'informations.
BTS_CACHE_MODE={min,mbox,full}
Quantite de donnees du BTS a recuperer quand le cache est demande.
Seulement le minimum, ou alors la mbox ou bien encore le tout. La
valeur par defaut est min, ce qui a la meme signification que le
parametre de l'option de ligne commande --cache-mode. Cela
n'affecte que le cache. Consultez la documentation de la commande
cache pour plus d'informations.
BTS_FORCE_REFRESH
Lui attribuer la valeur yes, equivaut a utiliser le parametre en
ligne de commande --force-refresh. Cela n'affecte que la commande
cache. La valeur par defaut est no. Veuillez consulter la commande
cache pour plus d'informations.
BTS_MAIL_READER
Si elle est definie, elle indique le client de messagerie a
utiliser a la place de mutt. Equivalent a l'option de ligne de
commande --mailreader.
BTS_SENDMAIL_COMMAND
Si elle est definie, elle indique la commande d'envoi de message a
utiliser a la place de /usr/sbin/sendmail. Equivaut a l'option de
ligne de commande --sendmail.
BTS_ONLY_NEW
Ne telecharger que les nouveaux bogues pour la mise en cache. Ne
pas verifier si les bogues deja telecharges ont ete modifies. La
valeur par defaut est no. Identique a l'option en ligne de commande
--only-new.
BTS_SMTP_HOST
Si elle est definie, elle indique un serveur SMTP a utiliser pour
envoyer les courriers au lieu d'utiliser la commande sendmail.
Equivaut a l'option en ligne de commande --smtp-host.
Notez que cette option a la priorite par rapport a
BTS_SENDMAIL_COMMAND si les deux sont utilisees, a moins que
l'option --sendmail soit utilisee.
BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD
Definir ces options equivaut a utiliser les options --smtp-username
et --smtp-password.
BTS_SMTP_HELO
Identique a l'option en ligne de commande --smtp-helo.
BTS_INCLUDE_RESOLVED
Lui attribuer la valeur no equivaut a utiliser le parametre en
ligne de commande --no-include-resolved. Cela n'affecte que la
commande cache. La valeur par defaut est yes. Veuillez consulter la
commande cache pour plus d'informations.
BTS_SUPPRESS_ACKS
Lui attribuer la valeur yes equivaut a utiliser l'option --no-ack.
La valeur par defaut est no.
BTS_INTERACTIVE
Lui attribuer la valeur yes ou force equivaut a utiliser l'option
--interactive ou --force-interactive. La valeur par defaut est no.
BTS_DEFAULT_CC
Indiquer une liste d'adresses electroniques auxquelles une copie
conforme des courriers, generes pour le robot <<control>>, doit
etre envoyee automatiquement.
BTS_SERVER
Indiquer le nom d'un serveur debbugs qui doit etre utilise a la
place de bugs.debian.org.
VOIR AUSSI
Veuillez consulter http://www.debian.org/Bugs/server-control
<http://www.debian.org/Bugs/server-control> pour plus de details sur
comment controler le BTS avec des courriers et
<http://www.debian.org/Bugs/> pour plus d'informations sur le BTS.
reportbug(1), querybts(1)
COPYRIGHT
Ce programme est Copyright (C) 2001-2003 by Joey Hess
<joeyh@debian.org>. De nombreuses modifications ont ete effectuees,
Copyright (C) 2002-2005 Julian Gilbey <jdg@debian.org> et Copyright (C)
2007 Josh Triplett <josh@freedesktop.org>.
Il est publie sous les termes de la Licence Publique Generale (GPL)
version 2 ou toute version ulterieure (a votre discretion).
TRADUCTION
Cyril Brulebois <cyril.brulebois@enst-bretagne.fr>, 2006
Thomas Huriaux <thomas.huriaux@gmail.com>, 2006