Opastus vikajärjestelmän hakupalvelimeen

On olemassa postipalvelin, joka osaa pyynnöstä lähettää vikailmoituksia ja luetteloja puhtaana tekstinä.

Sen käyttäminen tapahtuu lähettämällä viestejä osoitteeseen request@bugs.debian.org. Aihe(Subject)-kenttä viestissä ohitetaan paitsi muodostettaessa vastauksen Aihe-kenttää.

Viestin rungon pitäisi sisältää sarja komentoja, yksi komento per rivi. Saat vastauksen, joka näyttää oman tulkittavan viestisi jäljennökseltä, ja vastauksen jokaiseen komentoon. Komennoista ei lähetetä huomautuksia kellekään eikä tallennettuja viestejä ole julkisesti saatavilla.

Kaikki teksti riveillä, jotka alkavat risuaidalla (#) ohitetaan; palvelin lopettaa komentojen tulkitsemisen kohdatessaan lopetuskäskyllä alkavan rivin (quit, thank you tai kaksi yhdysviivaa ovat yleisempiä esimerkkejä). Tulkinta lopetetaan myös jos törmätään liian moneen tunnistamattomaan tai väärinmuotoiltuun komentoon. Jos yhtään komentoa ei onnistuta käsittelemään, palvelin palauttaa sinulle oman käyttöohjeensa.

Käytössä olevat komennot

send vikanumero
send-detail vikanumero
Pyytää kopioita kyseessä olevasta vikailmoituksesta. send-detail lähettää myöskin kaikki tylsät viestit mukana, kuten erinäiset automaattiset kuittaukset.
index [full]
index-summary by-package
index-summary by-number
Pyytää täydellistä luetteloa (täydellisine yksityiskohtineen ja sisältäen korjatut ja eteenpäin lähetetyt ilmoitukset) tai paketin tai numeron mukaan järjestettyä yhteenvetoa.
index-maint
Pyytää luetteloa ylläpitäjistä, joilla on vikoja (avoimia tai äskettäin suljettuja) seurantajärjestelmässä.
index maint ylläpitäjä
Pyytää luettelon järjestelmään tallennetuista vioista, joiden ylläpitäjä on ylläpitäjä. Hakutulos vastaa täsmälleen hakusanaa (kirjainkoko merkitsee). Vikaluettelo lähetetään erillisenä viestinä.
index-packages
Pyytää luettelon paketeista, joille on tallennettu vikoja (avoimia tai äskettäin suljettuja) seurantajärjestelmään.
index packages paketti
Pyytää luettelon järjestelmään ilmoitetuista vioista, jotka koskevat pakettia paketti. Paketin nimen pitää olla täsmälleen oikein. Vikaluettelo lähetetään erillisenä viestinä.
send-unmatched [this|0]
send-unmatched last|-1
send-unmatched old|-2
Pyytää kirjanpidon viesteistä, jotka eivät kuuluneet mihinkään vikailmoitukseen tällä viikolla, edellisellä viikolla ja viikkoa sitä ennen. (Viikko loppuu keskiviikkona.)
getinfo tiedosto

Pyytää tiedoston, joka sisältää tietoa paket(e)ista ja/tai ylläpitäj(i/ä)stä - saatavilla olevat tiedostot ovat:

maintainers
Pakettien ylläpitäjien lista, jota seurantajärjestelmä käyttää. Tämä muodostetaan tiedoista Packages-tiedostoissa, ylikirjoitustiedostoista ja pseudopakettien tiedostoista.
override.jakelu
override.jakelu.non-free
override.jakelu.contrib
override.experimental
Tietoa pakettien tärkeysjärjestyksestä, osastoista ja ylläpitäjille. Tätä tietoa käytetään luotaessa FTP-arkiston Packages-tiedostot. Tiedot on saatavilla jokaiselle pääjakelulle koodinimien mukaan.
pseudo-packages.description
pseudo-packages.maintainers
Lista pseudopakettien kuvauksista ja ylläpitäjistä.
refcard
Pyytää postipalvelimen pikaoppaan puhtaana tekstinä.
user osoite
Aseta osoite käyttäjäksi kaikissa myöhemmissä usertag-komennoissa.
usertag vikanumero [ + | - | = ] tagi [ tagi ... ]
Sallii määrittää tageja käyttäjäkohtaisesti. Komento usertag toimii kuten normaali tag-komento paitsi että voit käyttää mitä tahansa haluamiasi tageja. Oletuksena osoite sähköpostin From:- tai Reply-To:-otsakkeesta käytetään käyttäjänä usertag-komennossa.
usercategory kategorian-nimi [ [hidden] ]

Lisää, päivittää tai poistaa käyttäjäkategorian. Oletusarvoisesti käyttäjäkategoria on näkyvillä, mutta mikäli valinnainen argumentti [hidden] (piilotettu) määritetään, niin silloin kategoria ei ole näkyvillä, mutta siihen voidaan viitata muista käyttäjäkategoriamäärittelyistä.

Tämä komento on jokseenkin erityinen, koska lisättäessä tai päivitettäesssä käyttäjäkategoriaa, tulee välittömästi komennon jälkeen seurata sisältö. Jos sisältö on tyhjä, käyttäjäkategoria poistetaan. Sisältö koostuu riveistä, jotka voivat alkaa millä tahansa määrällä tyhjää. Jokainen kategoria alkaa rivillä *, ja valinnaisesti sitä voi seurata useita valintarivejä, jotka alkavat +. Täydellinen muoto on seuraava:

* kategorian-nimi-1
* Kategorian otsikko 2 [ [valinta-etuliite] ]
 + Valintaotsikko 1 [ [ järjestys: ] vakunta-1 ]
 + Valintaotsikko 2 [ [ järjestys: ] valinta-2 ]
 + Oletusvalintaotsikko [ [ järjestys: ] ]
* kategorian-nimi-3

Kategorian-nimet, joita esiintyy komennossa ja sisällössä, käytetään viittaamaan niihin, jolloin vältytään tarpeettomalta toistolta. Kategorian otsikkoja käytetään tiivistelmäraporteissa.

Valinnainen valinta-etuliite on etuliitteeänä jokaiselle valinnalle jokaisessa kategoriaosuuden tietueessa. Ensimmäinen valinta, joka täsmää saa vian näkymään sen alla. Valinnainen järjestys-parametri määrittää sijainnin kun näytetään valintatietueita. Tämä on hyödyllinen, kun käytetään hakuehtoa, joka valitsee ylijoukon aiempia, mutta halutaan näkyvän ennen niitä.

Kategorian-nimi normal (normaali) omaa erityismerkityksen olemalla oletusnäkymä, joten korvaamalla se toisella käyttäjäkategorialla paketinnimi@packages.debian.org käyttäjällä voidaan vaihtaa paketille oletusluokitusta.

Esimerkkikäyttö:

    usercategory dpkg-program [hidden]
     * Program
       + dpkg-deb [tag=dpkg-deb]
       + dpkg-query [tag=dpkg-query]
       + dselect [package=dselect]

    usercategory new-status [hidden]
     * Status [pending=]
       + Outstanding with Patch Available [0:pending+tag=patch]
       + Outstanding and Confirmed [1:pending+tag=confirmed]
       + Outstanding and More Information Needed [pending+tag=moreinfo]
       + Outstanding and Forwarded [pending+tag=forwarded]
       + Outstanding but Will Not Fix [pending+tag=wontfix]
       + Outstanding and Unclassified [2:pending]
       + From other Branch [absent]
       + Pending Upload [pending-fixed]
       + Fixed in NMU [fixed]
       + Resolved [done]
       + Unknown Pending Status []

    # Vaihda oletusnäkymä
    usercategory normal
      * new-status
      * severity

    usercategory old-normal
      * status
      * severity
      * classification
help
Pyytää tämän ohjeen sähköpostitse puhtaana tekstinä.
quit
stop
thank
thanks
thankyou
thank you
--
Lopettaa viestin käsittelyn tässä kohdassa. Tämän jälkeen voit laittaa mitä tahansa haluamaasi tekstiä ja järjestelmä ohittaa sen. Voit käyttää tätä kirjoittaessasi pidempiä kommentteja kuin #-merkkiä käyttäen on järkevää, esimerkiksi helpottaaksesi viestisi ihmislukijoiden työtä (jotka lukevat seurantajärjestelmän lokitiedostoja tai jotka ovat CC:n tai BCC:n kautta vastaanottajina).
#...
Yksirivinen kommentti. #-merkin pitää olla heti rivin alussa.
debug taso
Asettaa vianetsintätasoksi taso:n, joka on ei-negatiivinen kokonaisluku. 0 tarkoittaa ei vianetsintätietoja; 1 on yleensä riittävä. Vianetsintätulosteet näkyvät vastauksessa. Tämä ei yleensä ole hyödyllinen vikajärjestelmän normaaleille käyttäjille.

Postipalvelimesta on saatavilla pikaopas www-sivuilla, tiedostossa bug-mailserver-refcard.txt tai myös sähköpostitse komennolla refcard (ks. yllä).

Jos haluat käsitellä vikailmoituksia, käytä osoitetta control@bugs.debian.org, joka ymmärtää useita komentoja yllä olevien lisäksi. Nämä muut komennot kuvataan toisessa dokumentissa www-sivulla, tiedostossa bug-maint-mailcontrol.txt tai lähettämällä komennon help osoitteeseen control@bugs.

Mikäli luet tätä tekstitiedostosta tai sähköpostin muodossa: HTML-versio on saatavilla vianseurantajärjestelmän pääsivulta osoitteesta https://www.debian.org/Bugs/.


BTS:n muut sivut:


Debian BTS administrators <owner@bugs.debian.org>

Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd, 1994-1997 Ian Jackson.