path: root/finnish/Bugs/server-request.wml

#use wml::debian::template title="Debian BTS - hakupalvelin" NOHEADER=yes NOCOPYRIGHT=true
#use wml::debian::translation-check translation="ffe142fb8e27c6752fff483899ded27505b6364e"

<h1><a name="introduction">Opastus vikajärjestelmän hakupalvelimeen</a></h1>

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

<p>Sen käyttäminen tapahtuu lähettämällä viestejä osoitteeseen <a
href="mailto:request@bugs.debian.org"><code>request@bugs.debian.org</code></a>.
<code>Aihe</code>(<code>Subject</code>)-kenttä viestissä ohitetaan
paitsi muodostettaessa vastauksen <code>Aihe</code>-kenttää.</p>

<p>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.</p>

<p>Kaikki teksti riveillä, jotka alkavat risuaidalla (<code>#</code>)
ohitetaan; palvelin lopettaa komentojen tulkitsemisen kohdatessaan 
<a href="#stopprocessing">lopetuskäskyllä</a> alkavan rivin 
(<code>quit</code>, <code>thank you</code> 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.</p>

<h1>Käytössä olevat komennot</h1>

<dl>
<dt><code>send</code> <var>vikanumero</var></dt>
<dt><code>send-detail</code> <var>vikanumero</var></dt>
<dd>
Pyytää kopioita kyseessä olevasta vikailmoituksesta.
<code>send-detail</code> lähettää myöskin kaikki <q>tylsät</q> viestit 
mukana, kuten erinäiset automaattiset kuittaukset.</dd>

<dt><code>index</code> [<code>full</code>]</dt>
<dt><code>index-summary by-package</code></dt>
<dt><code>index-summary by-number</code></dt>
<dd>
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.</dd>

<dt><code>index-maint</code></dt>
<dd>
Pyytää luetteloa ylläpitäjistä, joilla on vikoja (avoimia
tai äskettäin suljettuja) seurantajärjestelmässä.</dd>

<dt><code>index maint</code> <var>ylläpitäjä</var></dt>
<dd>
Pyytää luettelon järjestelmään tallennetuista vioista, joiden ylläpitäjä
on <var>ylläpitäjä</var>.  Hakutulos vastaa täsmälleen hakusanaa
(kirjainkoko merkitsee).  Vikaluettelo lähetetään erillisenä viestinä.</dd>

<dt><code>index-packages</code></dt>
<dd>
Pyytää luettelon paketeista, joille on tallennettu vikoja (avoimia
tai äskettäin suljettuja) seurantajärjestelmään.</dd>

<dt><code>index packages</code> <var>paketti</var></dt>
<dd>
Pyytää luettelon järjestelmään ilmoitetuista vioista, jotka koskevat
pakettia <var>paketti</var>.  Paketin nimen pitää olla täsmälleen oikein.
Vikaluettelo lähetetään erillisenä viestinä.</dd>

<dt><code>send-unmatched</code> [<code>this</code>|<code>0</code>]</dt>
<dt><code>send-unmatched</code> <code>last</code>|<code>-1</code></dt>
<dt><code>send-unmatched</code> <code>old</code>|<code>-2</code></dt>
<dd>
Pyytää kirjanpidon viesteistä, jotka eivät kuuluneet mihinkään
vikailmoitukseen tällä viikolla, edellisellä viikolla ja viikkoa sitä
ennen.  (Viikko loppuu keskiviikkona.)</dd>

<dt><code>getinfo</code> <var>tiedosto</var></dt>
<dd>
<p>
Pyytää tiedoston, joka sisältää tietoa paket(e)ista ja/tai
ylläpitäj(i/ä)stä - saatavilla olevat tiedostot ovat:
</p>

<dl>
<dt><code>maintainers</code></dt>
<dd>
Pakettien ylläpitäjien lista, jota seurantajärjestelmä käyttää. Tämä
muodostetaan tiedoista <code>Packages</code>-tiedostoissa,
ylikirjoitustiedostoista ja pseudopakettien tiedostoista.</dd>

<dt><code>override.</code><var>jakelu</var></dt>
<dt><code>override.</code><var>jakelu</var><code>.non-free</code></dt>
<dt><code>override.</code><var>jakelu</var><code>.contrib</code></dt>
<dt><code>override.experimental</code></dt>
<dd>
Tietoa pakettien tärkeysjärjestyksestä, osastoista ja 
ylläpitäjille.  Tätä tietoa käytetään luotaessa
FTP-arkiston <code>Packages</code>-tiedostot.  Tiedot on saatavilla
jokaiselle pääjakelulle koodinimien mukaan.</dd>

<dt><code>pseudo-packages.description</code></dt>
<dt><code>pseudo-packages.maintainers</code></dt>
<dd>
Lista pseudopakettien kuvauksista ja ylläpitäjistä.</dd>
</dl>
</dd>

<dt><code>refcard</code></dt>
<dd>
Pyytää postipalvelimen pikaoppaan puhtaana tekstinä.</dd>

<dt><a name="user"><code>user</code> <var>osoite</var></a></dt>
<dd>
Aseta <var>osoite</var> <q>käyttäjäksi</q> kaikissa myöhemmissä
<code>usertag</code>-komennoissa.
</dd>

<dt><a name="usertag"><code>usertag</code> <var>vikanumero</var>
    [ <code>+</code> | <code>-</code> | <code>=</code> ] <var>tagi</var>
    [ <var>tagi</var> ... ]</a></dt>
<dd>
Sallii määrittää tageja käyttäjäkohtaisesti. Komento <code>usertag</code>
toimii kuten normaali <code>tag</code>-komento paitsi että
voit käyttää mitä tahansa haluamiasi tageja. Oletuksena osoite sähköpostin
<code>From:</code>- tai <code>Reply-To:</code>-otsakkeesta käytetään
käyttäjänä <code>usertag</code>-komennossa.
</dd>

<dt><a name="usercategory"><code>usercategory</code>
     <var>kategorian-nimi</var> [ <code>[hidden]</code> ]</a></dt>
<dd>
<p>
Lisää, päivittää tai poistaa <code>käyttäjäkategorian</code>.
Oletusarvoisesti käyttäjäkategoria on näkyvillä, mutta mikäli
valinnainen argumentti <code>[hidden]</code> (piilotettu) määritetään,
niin silloin kategoria ei ole näkyvillä, mutta siihen voidaan viitata
muista käyttäjäkategoriamäärittelyistä.
</p>

<p>
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ä <code>*</code>, ja
valinnaisesti sitä voi seurata useita valintarivejä, jotka alkavat
<code>+</code>. Täydellinen muoto on seuraava:
</p>

<div>
* <var>kategorian-nimi-1</var><br />
* <var>Kategorian otsikko 2</var>
  [ <code>[</code><var>valinta-etuliite</var><code>]</code> ]<br />
&nbsp;+ <var>Valintaotsikko 1</var> <code>[</code>
        [ <var>järjestys</var><code>:</code> ]
        <var>vakunta-1</var> <code>]</code><br />
&nbsp;+ <var>Valintaotsikko 2</var> <code>[</code>
        [ <var>järjestys</var><code>:</code> ]
        <var>valinta-2</var> <code>]</code><br />
&nbsp;+ <var>Oletusvalintaotsikko</var> <code>[</code>
        [ <var>järjestys</var>: ] <code>]</code><br />
* <var>kategorian-nimi-3</var><br />
</div>

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

<p>
Valinnainen <var>valinta-etuliite</var> on etuliitteeänä jokaiselle
<var>valinnalle</var> jokaisessa kategoriaosuuden tietueessa.
Ensimmäinen <var>valinta</var>, joka täsmää saa vian näkymään sen
alla. Valinnainen <var>järjestys</var>-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ä.
</p>

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

<p>
Esimerkkikäyttö:
</p>

<pre>
    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
</pre>
</dd>

<dt><code>help</code></dt>
<dd>
Pyytää tämän ohjeen sähköpostitse puhtaana tekstinä.</dd>

<dt><a name="stopprocessing"></a><code>quit</code></dt>
<dt><code>stop</code></dt>
<dt><code>thank</code></dt>
<dt><code>thanks</code></dt>
<dt><code>thankyou</code></dt>
<dt><code>thank you</code></dt>
<dt><code>--</code></dt>
<!-- #366093, I blame you! -->
<!-- <dt><code>kthxbye</code></dt> -->
<!-- See... I documented it! -->
<dd>
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
<code>#</code>-merkkiä käyttäen on järkevää, esimerkiksi
helpottaaksesi viestisi ihmislukijoiden työtä (jotka lukevat
seurantajärjestelmän lokitiedostoja tai jotka ovat <code>CC</code>:n tai
<code>BCC</code>:n kautta vastaanottajina).</dd>

<dt><code>#</code>...</dt>
<dd>
Yksirivinen kommentti.  <code>#</code>-merkin pitää olla heti rivin
alussa.</dd>

<dt><code>debug</code> <var>taso</var></dt>
<dd>
Asettaa vianetsintätasoksi <var>taso</var>: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.</dd>

</dl>

<p>Postipalvelimesta on saatavilla <a href="server-refcard">pikaopas
www-sivuilla</a>, tiedostossa <code>bug-mailserver-refcard.txt</code>
tai myös sähköpostitse komennolla <code>refcard</code> (ks. yllä).</p>

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

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

<hr />

#use "otherpages.inc"

#use "$(ENGLISHDIR)/Bugs/footer.inc"