#use wml::debian::template title="Debian BTS — komentopalvelu" NOHEADER=yes NOCOPYRIGHT=true #include "$(ENGLISHDIR)/Bugs/pkgreport-opts.inc" #use wml::debian::translation-check translation="3d1b5c8a4656b47f56cfa51e517a0a664f7fb637"
Kun request@bugs.debian.org
antaa noutaa vikailmoitustietoa ja dokumentaatiota
sähköpostitse, control@bugs.debian.org
kautta voidaan
vikailmoituksia muokata eri tavoin.
Komentopalvelu toimii kuten hakupalvelukin, paitsi että se hyväksyy muutaman lisäkomennon; itse asiassa se on sama ohjelma. Kaksi osoitetta on erotettu estämään käyttäjien tekemästä virheitä ja aiheuttamasta ongelmia yrittäessään ainoastaan hakea tietoa.
Koska komentopalvelun omat komennot myös muuttavat vikojen tilatietoa, ilmoitus komentojen käsittelystä lähetetään muutettujen vikojen pakettien ylläpitäjille. Lisäksi palveluun lähetetyt viestit ja muutosten tulokset lokitetaan vikailmoitukseen ja tulevat saataville www-sivuille.
Katsothan opastuksen
hakupalveluun, joka on saatavilla www:ssä, tiedostossa
bug-log-mailserver.txt
ja lähettämällä komento
help
kumpaan tahansa postipalveluista. Ohjeissa on
yksityiskohdat postipalveluiden käyttämisestä sekä saatavilla olevista
komennoista yleisimmät kun kumpaan tahansa osoitteeseen lähetetään
viestejä.
Pikaopas postipalvelulle on
saatavilla www:ssä tiedostosta
bug-mailserver-refcard.txt
tai sähköpostitse
komennolla refcard
.
Yleisiä | Versiointi | Monistus | Sekalaista |
reassign
vikanumero
paketti [ versio ]Tallentaa vian #vikanumero viaksi pakettiin. Tätä voidaan käyttää asettamaan paketti, jos käyttäjä unohti pseudo-otsakkeen, tai vaihtamaan pakettia. Yhtään huomautusta ei lähetetä kenellekkään (muuta kuin tavallinen tieto komentolistan käsittelystä).
Mikäli annat myös version, vianseurantajärjestelmä ottaa huomioon, että vika koskee tätä versiota uudesta paketista.
Voit asettaa vian kahdelle paketille samaan aikaan erottamalla pakettien nimet pilkulla. Huomaa, että näin tehdään vain mikäli vian voi korjata muuttamalla kumpaa tahansa paketeista. Mikäli asia ei ole näin, tulee vika kloonata ja asettaa kloonattu vika toiselle paketille.
reopen
vikanumero
[ ilmoittajan-osoite | =
| !
]Uudelleenavaa vian #vikanumero mikäli se on suljettu.
Oletuksena, tai mikäli annetaan parametri =
,
alkuperäinen ilmoittaja jää edelleen vikailmoituksen
ilmoittajaksi, joten heille lähtee kuittaus kun ilmoitus
suljetaan uudelleen.
Mikäli annetaan ilmoittajan-osoite vian ilmoittajaksi
asetetaan syötetty osoite. Mikäli haluat ryhtyä uudeksi
ilmoittajaksi uudelleenavaamallesi vialle, voit käyttää
lyhennystä !
tai syöttää oman sähköpostiosoitteesi.
On yleensä hyvä idea kertoa henkilölle kuka merkitään ilmoittajaksi vikailmoitukseen, jonka avaat uudelleen, jotta he osaavat odottaa kuittausta, jonka he saavat kun vika suljetaan uudelleen.
Mikäli vika ei ole suljettu, reopen-komento ei tee mitään, ei
edes vaihda ilmoittajaa. Avoimen vikailmoituksen ilmoittajan
vaihtamiseen tulee käyttää komentoa submitter
.
Huomaa, että se komento informoi alkuperäistä ilmoittajaa
muutoksesta.
Mikäli vika on merkitty suljetuksi tietyssä versiossa paketista,
mutta esiintyy uudelleen myöhemmällä versiolla, on parempi
käyttää komentoa found
tämän sijaan.
found
vikanumero
[ versio ]Merkitse, että #vikanumero on esiintynyt annetussa versiossa paketissa, jolle se on ilmoitettu. versio voi olla täydellinen versionumero muodossa lähdekoodipaketinnimi/versio.
Vianseurantajärjestelmä käyttää tätä tietoa yhdessä vikoja suljettaessa merkittyjen korjattujen versioiden kanssa näyttämään luettelon avoimista vioista pakettien eri versioissa. Vikaa pidetään avoimena mikäli sille ei ole korjattua versioita tai kun se on löydetty tuoreemmasta versiosta kuin missä se on merkitty korjatuksi.
Mikäli parametria versio ei anneta, korjatut versiot
tälle vialle tyhjätään. Tämä on identtinen käytös komennon
reopen
kanssa.
versio voi olla täydellinen versionumero muodossa
lähdekoodipaketinnimi/versio.
Tämä komento aiheuttaa vian merkitsemisen ei-tehdyksi jos
versiota ei anneta tai mikäli versio jossa vika
merkitään löytyneeksi on sama tai uudempi kuin versio, jossa se
oli viimeksi merkitty korjatuksi. (Jos olet varma, että haluat
merkitä vian ei-tehdyksi, käytä komentoa reopen
yhdessä komennon found
kanssa.)
Tämä komento luotiin reopen
komentoa paremmaksi,
koska oli vaikea lisätä versio tuon komennon
syntaksiin selkeällä tavalla.
notfound
vikanumero
versioPoista merkintä, että #vikanumero löytyy annetussa kohdistetun paketin versiossa versio. versio voi olla täydellinen versionumero muodossa lähdekoodipaketinnimi/versio.
Tämä eroaa vian sulkemisesta tietyssä versiossa siten, että vikaa ei luetella korjatuksi tässä versiossa. Tietoa versiosta ei siis tiedetä. Tämä on tarkoitettu korjaamaan virhemerkintöjä vikojen löytymisestä.
fixed
vikanumero
versioIlmoittaa, että vika #vikanumero on korjattu kohdistetun paketin annetussa versiossa. versio voi olla täydellinen versionumero muodossa lähdekoodipaketinnimi/versio.
Tämä ei johda vian merkitsemiseen suljetuksi, vaan ainoastaan lisää yhden version, jossa vika oli korjattu. Käytä osoitetta vikanumero-done sulkemaan vika ja merkitsemään se korjatuksi tietyssä versiossa.
notfixed
vikanumero
versioPoista merkintä, että vika #vikanumero olisi korjattu annetussa versiossa. versio voi olla täydellinen versionumero muodossa lähdekoodipaketinnimi/versio.
Tämä komento johtaa samaan tilanteeseen kuin
komento found
, jota seuraa
notfound
(found poistaa merkinnän korjauksesta
tietyssä versiossa ja notfound poistaa löytymismerkinnän) sillä
poikkeuksella, että vikaa ei uudelleenavata mikäli löytöversio
on suurempi kuin mikään olemassaolevista korjatuista versioista.
Tämä on tarkoitettu virheiden korjaamiseksi tiedoissa milloin
vika on korjattu, useimmissa tapauksissa oikeasti halutaan
käyttää komentoa found
, ei notfixed
.
submitter
vikanumero
ilmoittajan-osoite | !
Vaihtaa vian #vikanumero ilmoittajan osoitteeksi ilmoittajan-osoite.
Mikäli haluat ruveta vikailmoitukseen uudeksi ilmoittajaksi,
voit käyttää lyhennystä !
tai määrittää oman
sähköpostiosoitteesi.
Kun komento reopen
muuttaa muiden tämän vian kanssa
liitettyjen vikojen ilmoittajan, komento submitter
ei vaikuta liitettyihin vikoihin.
forwarded
vikanumero
osoiteMerkitsee, että vikanumero on edelleenlähetetty ylävirran ylläpitäjälle osoitteeseen osoite. Tämä ei itsessään edelleenlähetä ilmoitusta. Tätä voi käyttää vaihtamaan aiempi virheellinen edelleenlähetysosoite, tai taltioimaan uusi osoite vialle, jota ei aiemmin ole merkitty edelleenlähetetyksi. osoite tulisi olla URI tai mahdollisesti sähköpostiosoite. Käyttämällä URIa kun mahdollista, voidaan työkaluilla tarkkailla etävianseurantajärjestelmästä (kuten Bugzillasta) vian tilamuutoksia.
Esimerkkikäyttö:
forwarded 12345 http://bugz.illa.foo/cgi/54321
notforwarded
vikanumeroUnohtaa ajatuksen siitä, että vikanumero on edelleenlähetetty ylävirran ylläpitäjälle. Mikäli vikaa ei ole merkitty edelleenlähetetyksi, tämä komento ei tee mitään.
retitle
vikanumero
uusi-otsikko
Vaihtaa vikailmoituksen otsikoksi annetun (oletus on viestin
aihekenttä (Subject
) alkuperäisessä ilmoituksessa).
Myös kaikkien yhdistettyjen vikojen otsikot muutetaan.
severity
vikanumero
vakavuusAsettaa vikailmoituksen #vikanumero vakavuustasoksi vakavuus. Tästä ei lähetetä huomatusta vian ilmoittajalle.
Vakavuudet ovat
Katso niiden merkitykset vianseurantajärjestelmän yleisdokumentaatiosta kehittäjille.
affects
vikanumero
[ +
| -
| =
] paketti [ paketti ... ]
Indikoi, että vika vaikuttaa toiseen pakettiin. Tapauksessa,
jossa vikanumero aiheuttaa rikkinäistä käyttäytymistä
paketissa paketti, vaikka vika itsessään on tässä
paketissa, jolle vika on kohdistettu, saadaan vika näkymään
oletuksena myös toisen paketin package luettelossa.
Tätä tulisi yleensä käyttää kun vika on niin vakava, että
käyttäjät lähettävät siitä useita ilmoituksia väärälle
paketille. =
asettaa vaikutuksen annettuun
pakettiluetteloon, ja se on oletustoiminta jos paketteja ei ole
annettu. -
poistaa luetellut paketit
vaikutusluettelosta, ja +
lisää luetellut paketit
vaikutusluetteloon ollen myös oletustoiminto mikäli paketteja on
lueteltu.
summary
vikanumero
[viestin numero | tiivistelmäteksti]Valitsee viestin, jota käytetään vian tiivistelmänä. Ensimmäinen kappale, joka ei ole tämän viestin pseudo-otsakkeita eikä kontrollikappaleita, jäsennellään ja asetetaan vian tiivistelmäksi, joka näkyy vikailmoitussivun alussa. Tämä on hyödyllinen sellaisissa tapauksissa, joissa alkuperäinen ilmoitus ei kuvaa ongelmaa oikein tai viassa on useita viestejä tehden vaikeaksi identifioida todellinen ongelma.
Jos viestin numero numbera ei anneta, tiivistelmä poistetaan. Viestin numero on viestin järjestysnumero, joka luetellaan vikailmoitus-skriptin tulosteessa. Jos viestin numero arvo 0 annetaan, käytetään nykyistä viestiä (eli viestiä, joka lähetettiin control@bugs.debian.org-osoitteeseen ja sisältää tiivistelmän hallintakomennon).
Jos viestin numero ei ole numeerinen eikä myöskään tyhjä merkkijono, sen oletetaan olevan teksti, joka asetetaan tiivistelmäksi.
outlook
vikanumero
[viestin numero | näkymäteksti]Valitsee viestin, jota käytetään näkymänä vian korjaamisesta (tai vian korjaamisen nykyisestä tilasta). Ensimmäinen kappale, joka ei ole tämän viestin pseudo-otsakkeita eikä kontrollikappaleita, jäsennellään ja asetetaan vian näkymäksi, joka näkyy vikailmoitussivun alussa. Tämä on hyödyllinen työn koordinointiin muiden kanssa, jotka työskentelevät vian korjaamiseksi (esimerkiksi vianliiskausjuhlissa).
Jos viestin numero numbera ei anneta, näkymä poistetaan. Viestin numero on viestin järjestysnumero, joka luetellaan vikailmoitus-skriptin tulosteessa. Jos viestin numero arvo 0 annetaan, käytetään nykyistä viestiä (eli viestiä, joka lähetettiin control@bugs.debian.org-osoitteeseen ja sisältää näkymän hallintakomennon).
Jos viestin numero ei ole numeerinen eikä myöskään tyhjä merkkijono, sen oletetaan olevan teksti, joka asetetaan näkymäksi.
clone
vikanumero UusiID
[ uudet IDt ... ]
Kloonaushallintakomento sallii vikailmoituksen monistamisen. Se
on hyödyllinen silloin kun yksittäinen vikailmoitus itse asiassa
aiheutuu useista erillisistä kohdatuista vioista. Uudet
IDt
ovat välilyönnillä eroteltuja negatiivisia lukuja,
joilla voidaan myöhemmissä komennoissa viitata uusiin
monistettuihin vikailmoituksiin. Uusi ilmoitus luodaan jokaista
uutta ID:tä kohti.
Esimerkkikäyttö:
clone 12345 -1 -2 reassign -1 foo retitle -1 foo: foo sucks reassign -2 bar retitle -2 bar: bar sucks when used with foo severity -2 wishlist clone 123456 -3 reassign -3 foo retitle -3 foo: foo sucks merge -1 -3
merge
vikanumero
vikanumero ...Yhdistä kaksi tai useampi vikailmoitusta. Kun viat on yhdistetty, vian avaamiset, sulkemiset, edelleenlähetysmerkintöjen asettamiset ja poistamiset sekä paketin vaihtaminen mille tahansa yhdistetyistä vioista aiheuttaa saman vaikutukset kaikkiin yhdistettyihin vikailmoituksiin.
Ennenkuin viat voidaan yhdistää, niiden tulee olla täsmälleen
samassa tilassa: joko kaikki avoinna tai kaikki suljettuina,
edelleenlähetysosoitteena sama osoite tai mikään ei
edelleenlähetettynä, kaikki kohdistettu samaan pakettiin tai
paketteihin (tarkka merkkijonovertailu vikojen kohdistettujen
pakettien välillä) sekä kaikilla sama vakavuusaste. Mikäli
vioilla ei ole sama tila, tulee ensin käyttää komentoja
reassign
, reopen
ja niin edelleen
ennen kuin ne voidaan yhdistää komennolla merge
.
Vikojen otsikkojen ei tarvitse täsmätä, ja yhdistäminen ei
vaikuta otsikoihin. Tagienkaan ei tarvitse täsmätä, vaan ne
liitetään yhteen.
Mikäli yksikin merge
-komennolle lueteltu vika on jo
yhdistetty jonkun toisen vian kanssa, niin silloin kaikki
vikailmoitukset yhdistetään. Yhdistäminen on kuin yhtäsuuruus:
se on refleksiivinen, transitiivinen sekä symmetrinen.
Ilmoitusten yhdistäminen aiheuttaa huomautuksen ilmaantumisen jokaisen vikailmoituksen lokissa. Www-sivuilla tämä sisältää linkit muihin yhdistettyihin vikoihin.
Yhdistetyt ilmoitukset vanhenevat yhdessä ja vain kun kaikki ilmoitukset erikseen täyttävät vanhenemisen ehdot.
forcemerge
vikanumero
vikanumero ...Väkisin yhdistää kaksi tai useampia vikailmoituksia. Ensimmäisenä luetellun vian asetuksien, joiden täytyy olla yhtenevät tavallisessa yhdistämisessä, asetetaan myöhemmin luetelluille vioille. Jotta vältetään virheellisiä vikojen liittämisiä, vikojen tulee kohdistua samaan pakettiin. Aiempi kuvaus kertoo, mitä liittäminen tarkoittaa.
Huomaa, että näin on mahdollista sulkea vikoja yhdistämällä. Näin tehdessäsi olet itse velvollinen huomauttamaan ilmoittajia sopivalla sulkemisviestillä.
unmerge
vikanumeroIrrottaa vikailmoituksetn mistä tahansa muista ilmoituksista, joihin se on saatettu yhdistää. Mikäli ilmoitus on lueteltu liitetyksi useiden muiden kanssa, tällöin nämä muut jäävät yhdistetyksi toisiinsa ja vain niiden liitos tähän eksplisiittisesti mainittuun vikaan poistuu.
Mikäli useita vikailmoituksia on yhdistetty ja haluat erottaa ne kahdeksi erilliseksi ryhmäksi, tulee sinun ensin irrottaa kaikki ilmoitukset toisessa uusista ryhmistä erikseen ja sitten liittää ne halutuksi uudeksi ryhmäksi.
Voit irrottaa vain yhden ilmoituksen
jokaisella unmerge
-komennolla. Mikäli haluat
irrottaa useampia kuin yhden vian, voit yksinkertaisesti antaa
useita unmerge
-komentoja viestissäsi.
tags
vikanumero
[ +
| -
| =
]
tagi
[ tagi ... ]
[ +
| -
| =
tagi ... ]
Asettaa tageja vikailmoitukseen #vikanumero. Tästä ei
lähetetä huomautusta vian ilmoittajalle. Kun toiminnoksi annetaan
+
, niin jokainen annettu tagi tag
lisätään, -
tarkoittaa, että jokainen annettu
tagi tag poistetaan, ja =
tarkoittaa,
että nykyiset tagit ohitetaan ja ilmoituksen tageiksi asetetaan
täsmälleen annettu luettelo. Välissä
olevat +
, -
tai =
vaihtavat toimintoa perässä luetelluille tageille.
Oletustoiminto on lisätä tageja.
Esimerkkikäyttö:
\# sama kuin "tags 123456 + patch" tags 123456 patch \# sama kuin "tags 123456 + help security" tags 123456 help security \# lisää tagit "fixed" ja "pending" tags 123456 + fixed pending \# poista tagi "unreproducible" tags 123456 - unreproducible \# aseta tageiksi täsmälleen "moreinfo" ja "unreproducible" tags 123456 = moreinfo unreproducible \# poista tagi "moreinfo" ja lisää tagi "patch" tags 123456 - moreinfo + patch
Tällä hetkellä käytössä on seuraavat
tagit:
Niiden merkitykset on annettu vianseurantajärjestelmän yleisissä kehittäjien ohjeissa.
block
vikanumero by
vika ...unblock
vikanumero
by
bug ...close
vikanumero [
korjattu-versio ] (vanhentunut)Sulje vikailmoitus #vikanumero.
Viasta ilmoittaneelle henkilölle lähetetään huomautus, mutta
(toisin kuin lähetettäessä postia
osoitteeseen vikanumero-done@bugs.debian.org
)
viestin tekstiä, jolla vika suljetaan, ei
sisällytetä huomautukseen. Ylläpitäjän, joka sulkee vian, tulee
varmistaa, luultavasti lähettämällä erillinen viesti, että
viasta ilmoittanut henkilö tietää miksi vikailmoitus suljetaan.
Tämä komento on tämän vuoksi vanhentunut. Katso kehittäjien
ohjeista kuinka sulkea viat
oikein.
Mikäli annat korjattu-version, vianseurantajärjestelmä merkitseen vian korjatuksi paketin annetussa versiossa.
package
[ paketinnimi ... ]Rajoittaa myöhemmät komennot siten, että ne koskevat vain vikoja, jotka on ilmoitettu kohdistuvan lueteltuihin paketteihin. Voit luetella yhden tai usemman paketin. Mikäli et luettele yhtään pakettia, myöhemmät komennot koskevat kaikkia vikoja. Tätä kannattaa käyttää varmistuskeinona siltä varalta, että vahingossa käytät vääriä vikanumeroita.
Esimerkkikäyttö:
package foo reassign 123456 bar 1.0-1 package bar retitle 123456 bar: bar sucks severity 123456 normal package severity 234567 wishlist
owner
vikanumero
osoite | !
Asettaa osoitteen vian
#vikanumero omistajaksi
. Vian omistaja on
vastuussa vian korjauksesta. Tämä on hyödyllinen jaettaessa
työtä silloin kun paketilla on ryhmän verran ylläpitäjiä.
Mikäli haluat tulla vian omistajaksi itse, voit käyttää lyhennettä
!
tai syöttää oman sähköpostiosoitteesi.
noowner
vikanumeroarchive
vikanumerounarchive
vikanumeroarchive
-komennolla olettaen, että muut
kuin aikaan perustuvat arkistointivaatimukset täyttyvät.
Arkistosta palautusta ei tulisi käyttää triviaalien muutosten
tekemiseen arkistoituihin vikoihin, kuten lähettäjän
vaihtamiseen. Toiminnon ensisijainen tarkoitus on mahdollistaa
arkistoitujen vikojen uudelleenavaaminen ilman
vianseurantajärjestelmän ylläpitäjien apua.
#
...#
täytyy olla rivin
ensimmäinen merkki. Kommenttiteksti sisältyy kuittaukseen, joka
lähetetään komennon lähettäjälle sekä asiaan kuuluville
ylläpitäjille, joten tällä tavoin voi dokumentoida syyt
komennoillesi.
quit
stop
thank
thanks
thankyou
thank you
--