                 Sostavlenie soobschenij o probleme vo FreeBSD

  Dag-Erling Smorgrav

   Tekst predostavil  

  Mark Linimon

   Izdanie: e5712d4822

   FreeBSD `eto zaregistrirovannaya torgovaya marka FreeBSD Foundation.

   IBM, AIX, OS/2, PowerPC, PS/2, S/390 i ThinkPad `eto torgovye marki
   International Business Machines Corporation v Soedinennyh SHtatah, drugih
   stranah, ili po vsemu miru.

   Intel, Celeron, EtherExpress, i386, i486, Itanium, Pentium i Xeon `eto
   torgovye marki ili zaregistrirovannye torgovye marki Intel Corporation ili
   ee dochernih kompanij v Soedinennyh SHtatah i drugih stranah.

   Sparc, Sparc64, i UltraSPARC `eto torgovye marki SPARC International, Inc
   v Soedinennyh SHtatah i drugih stranah. Produkty s torgovoj markoj SPARC
   osnovany na arhitekture, razrabotannoj Sun Microsystems, Inc.

   Sun, Sun Microsystems, Java, Java Virtual Machine, JDK, JRE, JSP, JVM,
   Netra, Solaris, StarOffice, SunOS `eto torgovye marki ili
   zaregistrirovannye torgovye marki Sun Microsystems, Inc. v Soedinennyh
   SHtatah i drugih stranah.

   Mnogie iz oboznachenij, ispol'zuemye proizvoditelyami i prodavcami dlya
   oboznacheniya svoih produktov, zayavlyayutsya v kachestve torgovyh marok.
   Kogda takie oboznacheniya poyavlyayutsya v `etom dokumente, i Proektu
   FreeBSD izvestno o torgovoj marke, k oboznacheniyu dobavlyaetsya znak
   <<TM>> ili <<(R)>>.

   2014-06-13 14:53:24 +0000 Taras Korenko.
   Annotaciya

   `Eta stat'ya opisyvaet, kak nailuchshim obrazom sformulirovat' i otpravit'
   soobschenie o probleme v Proekt FreeBSD.

   [ Po razdelam / Odnim fajlom ]

     ----------------------------------------------------------------------

   Soderzhanie

   1. Vvedenie

   2. Kogda nuzhno otpravlyat' soobschenie o probleme

   3. Podgotovka

   4. Napisanie soobscheniya o probleme

   5. Otslezhivanie

   6. Problemy vzaimodejstviya s GNATS

   7. Dopolnitel'naya literatura

   Predmetnyj ukazatel'

1. Vvedenie

   Odnoj iz samyh razocharovyvayuschih praktik, kotoruyu mozhno poluchit' v
   kachestve pol'zovatelya programmnogo obespecheniya, yavlyaetsya otpravka
   soobscheniya o probleme, kotoroe vskore zakryvaetsya s kratkim i nichemu
   ne pomogayuschim ob"yasneniem tipa <<`eto ne problema>> ili <<nepravil'noe
   PR>>. Podobnym zhe obrazom odnoj iz samyh razocharovyvayuschih praktik,
   kotoruyu mozhno poluchit' v kachestve razrabotchika programmnogo
   obespecheniya, yavlyaetsya poluchenie massy soobschenij o problemah,
   kotorye na samom dele ne yavlyayutsya soobscheniyami o problemah, a
   zaprosami na poluchenie podderzhki, ili kotorye soderzhat malo ili
   voobsche ne soderzhat nikakoj informacii o suti problemy ili sposobe ee
   vosproizvedeniya.

   V `etom dokumente delaetsya popytka opisat' to, kak sostavlyat' horoshie
   soobscheniya o problemah. CHto zhe, sprosite vy, yavlyaetsya horoshim
   soobscheniem o probleme? Nu, esli perejti pryamo k suti, to horoshim
   soobscheniem ob probleme yavlyaetsya to, kotoroe mozhet byt' bystro
   proanalizirovano i otrabotano, k oboyudnomu udovletvoreniyu kak
   pol'zovatelya, tak i razrabotchika.

   Hotya v osnovnom stat'ya fokusiruetsya na soobscheniyah o problemah vo
   FreeBSD, bol'shej chast'yu ona dolzhna horosho podhodit' i drugim
   programmnym proektam.

   Zamet'te, chto `eta stat'ya organizovana po tematicheskomu principu, a ne
   hronologicheski, tak chto vy dolzhny prochest' dokument celikom prezhde,
   chem posylat' soobschenie o probleme, i ne vosprinimat' stat'yu kak
   poshagovoe rukovodstvo.

2. Kogda nuzhno otpravlyat' soobschenie o probleme

   Imeetsya mnogo klassov oshibok, i ne vse oni dolzhny privodit' k
   poyavleniyu soobscheniya o probleme. Konechno zhe, net ideal'nyh lyudej, i
   budut momenty, kogda vy reshite, chto nashli oshibku v programme, a na
   samom dele vy nepravil'no ponyali sintaksis komandy ili sdelali opechatku
   v konfiguracionnom fajle (hotya samo po sebe `eto inogda govorit o plohoj
   dokumentacii ili nepravil'noj obrabotke oshibok v prikladnoj programme).
   Est' esche mnogo sluchaev, kogda posylka soobscheniya o probleme yavno ne
   yavlyaetsya pravil'nym dejstviem, a tol'ko privodit k razocharovaniyu vas
   i razrabotchikov. I naoborot, est' sluchai, kogda mozhet byt' nuzhno
   poslat' soobschenie o chem-to, ne yavlyayuschemsya oshibkoj - k primeru,
   zapros na dorabotku ili rasshirenie funkcional'nosti.

   No kak zhe opredelit', chto yavlyaetsya oshibkoj, a chto net? Prostym
   pravilom, kotoromu nuzhno sledovat', yavlyaetsya sleduyuschee - vasha
   problema ne yavlyaetsya oshibkoj, esli ona formuliruetsya kak vopros
   (obychno v forme <<Kak sdelat' X?>> ili <<Gde mozhno najti Y?>>). Ne
   vsegda `eto tak odnoznachno, no pravilo voprosa pokryvaet bol'shinstvo
   sluchaev. Esli Vam nuzhen otvet, luchshe vsego zadat' svoj vopros v Spisok
   rassylki, posvyaschionnyj voprosam i otvetam pol'zovatelej FreeBSD.

   Vot nekotorye sluchai, v kotoryh mozhet okazat'sya poleznym otpravit'
   soobschenie o chem-to, chto ne yavlyaetsya oshibkoj:

     * Uvedomlenie ob obnovlenii programmnogo obespecheniya, kotoroe
       podderzhivaetsya storonnimi razrabotchikami (v osnovnom porty, no
       takzhe i komponenty bazovoj sistemy, razrabatyvaemye storonnimi
       organizaciyami, takie, kak BIND ili razlichnye utility GNU).

       Dlya ne podderzhivaemyh nikem portov (peremennaya MAINTAINER soderzhit
       ports@FreeBSD.org), takie uvedomleniya o obnovlenii budut zamecheny
       zainteresovavshimsya kommitterom i vas mogut poprosit' predostavit'
       patch dlya obnovleniya porta; predostavlenie patcha do togo, kak vas
       poprosyat ob `etom sil'no uvelichit shansy togo, chto port budet
       obnovlion vovremya.

       Esli port podderzhivaetsya, PR-y, ukazyvayuschie o poyavlenii novyh
       uluchshennyh (upstream) relizov obychno ne ochen' polezny, tak kak oni
       pribavlyayut mnogo vspomogatel'noj raboty dlya kommitterov, a
       m`ejntejner navernyaka uzhe znaet o novoj versii. Oni uzhe navernyaka
       rabotali s razrabotchikami nad nej ili oni vozmozhno testiruyut eio,
       chtoby ubedit'sya v otsutstvii regressii i t.p.

       V lyubom sluchae, sledovanie processu, opisannomu v Rukovodstve po
       sozdaniyu portov dast nailuchshie rezul'taty. (Takzhe mozhno
       oznakomit'sya s stat'ej Kontribuciya v kollekciyu portov FreeBSD.)

   Oshibka, kotoruyu nel'zya vosproizvesti, vryad li budet ispravlena. Esli
   oshibka voznikla tol'ko edinozhdy, i vy ne mozhete ee vosproizvesti, k
   tomu zhe nikto s nej bol'she ne stalkivalsya, net nikakih shansov, chto
   razrabotchiki smogut ee vosproizvesti ili ponyat', chto delaetsya
   nepravil'no. `Eto ne znachit, chto takogo ne sluchaetsya, no `eto znachit,
   chto shansov u vashego soobscheniya dojti kogda-libo do stadii
   ispravleniya oshibki ochen' maly. CHasto `eti vidy oshibok voznikayut
   iz-za neudovletvoritel'noj raboty zhiostkih diskov, peregrevshihsya
   processorov. Vsegda, kogda `eto vozmozhno vy dolzhny otslezhivat' takie
   sluchai pered posylkoj soobscheniya ob oshibke.

   Teper', chtoby opredelit' komu vy dolzhny otpravit' vashe soobschenie ob
   oshibke, vy dolzhny ponimat', chto programmnoe obespechenie, kotoroe
   vhodit vo FreeBSD, sostavlyaetsya iz neskol'kih razlichnyh chastej:

     * Kod v bazovoj sisteme, kotoryj pishetsya i podderzhivaetsya
       kontrib'yutorami FreeBSD. Takoj, kak yadro, biblioteka C, drajvera
       ustrojstv (vhodyat v kategoriyu kern); utility (bin); stranicy
       spravochnika i dokumentaciya (docs); veb-stranicy (www). Vse oshibki v
       `etih oblastyah dolzhny byt' soobscheny razrabotchikam FreeBSD.

     * Kod v bazovoj sisteme, kotoryj pishetsya i podderzhivaetsya drugim,
       importiruetsya vo FreeBSD i adaptiruetsya. Primery vklyuchayut v
       sebya: bind, gcc(1) i sendmail(8). Bol'shinstvo oshibok, popadayuschie
       v dannye oblasti dolzhny byt' soobscheny razrabotchikam FreeBSD, no v
       nekotoryh sluchayah oni dolzhny byt' otpravleny iznachal'nym
       razrabotchikam, esli problemy ne yavlyayutsya specifichnymi dlya
       FreeBSD. Obychno oshibki takogo roda popadayut pod kategorii bin ili
       gnu.

     * Otdel'nye prilozheniya, ne vhodyaschie v bazovuyu sistemu, no
       yavlyayuschiesya chast'yu Kollekcii Portov FreeBSD (kategoriya ports).
       Bol'shinstvo `etih prilozhenij ne pishetsya razrabotchikami FreeBSD;
       chto predostavlyaet FreeBSD, tak `eto tol'ko lish' infrastrukturu dlya
       ustanovki prilozheniya. Sledovatel'no, vy dolzhny otpravlyat'
       soobschenie ob oshibke razrabotchikam FreeBSD tol'ko togda, kogda vy
       uvereny v tom, chto problema specifichna dlya FreeBSD - inache
       otpravlyajte eio avtoram programmnogo obespecheniya.

   Zatem vy dolzhny ubedit'sya, dejstvitel'no li problema suschestvuet.
   Suschestvuet vsego neskol'ko veschej, kotorye razdrazhayut razrabotchika
   bol'she, chem poluchenie soobscheniya ob oshibke, kotoruyu on uzhe
   ispravil.

   Esli problema v bazovoj sisteme, to vam nuzhno snachala prochest' razdel
   versii FreeBSD iz FAQ, esli vy eschio ne znakomy s dannoj temoj. Dlya
   FreeBSD vozmozhno ispravlyat' problemy tol'ko dlya nekotoryh nedavnih
   vetok bazovoj sistemy, po`etomu otpravka soobscheniya ob oshibke dlya
   bolee staroj versii privediot k tomu, chto razrabotchik posovetuet vam
   obnovit'sya do podderzhivaemoj versii, chtoby posmotret' prisutstvuet li v
   nej problema. Komanda oficerov bezopasnosti podderzhivaet spisok
   podderzhivaemyh versij..

   Esli problema svyazana s portami, pomnite, chto vy snachala dolzhny
   obnovit'sya do samoj poslednej versii Kollekcii Portov i proverit',
   suschestvuet li v nej problema. Iz-za bystryh vnesenij izmenenij v `eti
   prilozheniya, neosuschestvimym dlya FreeBSD yavlyaetsya podderzhka
   chego-libo, krome samyh poslednih versij, i problemy so ustarevshimi
   versiyami prilozhenij prosto ne mogut byt' ispravleny.

3. Podgotovka

   Nuzhno sledovat' horoshemu pravilu vsegda snachala vypolnyat'
   dopolnitel'nye issledovaniya pered tem, kak poslat' soobschenie o
   probleme. Mozhet byt', o vashej probleme uzhe soobscheno; mozhet byt', ona
   nedavno obsuzhdalas' ili obsuzhdaetsya v spiskah rassylki; ona mozhet byt'
   uzhe ispravlena v bolee novoj versii, chem ta, chto vy ispol'zuete.
   Po`etomu vy dolzhny proverit' vse obychnye mesta do togo, kak poslat'
   vashe soobschenie o probleme. Dlya FreeBSD `eto znachit:

     * FreeBSD FAQ (Otvety na chasto zadavaemye voprosy). FAQ soderzhit
       otvety na voprosy iz samyh raznyh kategorij, v chastnosti, apparatnoj
       sovmestimosti, pol'zovatel'skih programm i konfiguracii yadra.

     * Spiski rassylki-esli Vy ne podpisany na nih, vospol'zujtes' poiskom v
       arhivah na sajte FreeBSD. Esli vasha problema ne obsuzhdalas' v
       spiskah rassylki, vy mozhete popytat'sya opublikovat' soobschenie o
       nej i podozhdat' neskol'ko dnej, poka kto-nibud' ne smozhet uvidet'
       to, chto vy ne zametili.

     * Kak variant, ves' veb-ispol'zujte vashu lyubimuyu poiskovuyu sistemu
       dlya poiska kakih-libo ssylok po vashej probleme. Vy mozhete dazhe
       uvidet' ssylki na arhivy spiskov rassylki ili telekonferencij, o
       kotoryh vy ne znali ili ne dumali tam iskat'.

     * Sleduyuschim punktom dolzhna byt' baza dannyh PR FreeBSD (GNATS). Esli
       tol'ko vasha problema ne nova ili redka, est' nekotoryj shans, chto o
       nej uzhe soobscheno.

     * I samoe vazhnoe, vy dolzhny posmotret' ne zatragivaet li dokumentaciya
       v bazovoj sisteme vashu problemu.

       Dlya osnovnogo koda FreeBSD vy dolzhny tschatel'no izuchit'
       soderzhimoe fajla /usr/src/UPDATING ili ego tekuschuyu versiyu po
       adresu http://svnweb.freebsd.org/base/head/UPDATING?view=log. (Esli vy
       perehodite s odnoj versii na druguyu, osobenno esli vy obnovlyaetes'
       do FreeBSD-CURRENT, to v `etom fajle vy mozhete najti mnogo vazhnoj
       informacii).

       Esli zhe vasha problema svyazana s kollekciej portov FreeBSD, vy
       dolzhny obratit'sya k fajlu /usr/ports/UPDATING (izmeneniya,
       kasayuschiesya individual'nyh portov) ili k /usr/ports/CHANGES
       (izmeneniya, kasayuschiesya vsej kollekcii portov). Oni takzhe
       dostupny cherez interfejs svnweb:
       http://svnweb.freebsd.org/ports/head/UPDATING?view=log i
       http://svnweb.freebsd.org/ports/head/CHANGES?view=log.

4. Napisanie soobscheniya o probleme

   Teper', posle togo, kak vy reshili, chto vash vopros podpadaet pod
   kategoriyu soobscheniya o probleme, i `eto problema FreeBSD, samoe vremya
   napisat' sobstvenno soobschenie o probleme (PR). Prezhde chem my
   uglubimsya v chastnosti ispol'zovaniya programmy dlya sozdaniya i otpravki
   PR, vot neskol'ko sovetov, kotorye pomogut vam sdelat' PR bolee
   `effektivnym.

  4.1. Kak pisat' horoshie soobscheniya o problemah

     * Osnovnym yazykom obscheniya razrabotchikov FreeBSD yavlyaetsya
       anglijskij. Baza dannyh po problemam takzhe vedetsya na anglijskom.
       Esli vy ispytyvaete problemy s formulirovkoj opisaniya problemy
       po-anglijski, svyazhites' so svoimi sootechestvennikami, kotorye
       pomogut vam sostavit' PR.

     * Ne ostavlyajte pole <<Synopsis>> (kratkoe opisanie) pustym.
       Soobscheniya o problemah popadayut kak v spiski rassylki, kotorye
       zatem rashodyatsya po vsemu miru (v nih pole <<Synopsis>> opredelyaet
       temu pis'ma), tak i v bazu dannyh. Prosmatrivayuschij `etu bazu, kak
       pravilo, projdet mimo PR s pustym kratkim opisaniem. Ne zabud'te, chto
       PR ostaetsya v baze do teh por, poka kto-libo ne zakroet ego;
       soobschenie-anonim, skoree vsego, prosto poteryaetsya na obschem fone.

     * Izbegajte tumannyh opisanij v pole <<Synopsis>>. Ne stoit
       predpolagat', chto chitayuschij vashe soobschenie vladeet kontekstom;
       po`etomu, chem podrobnee vy opishete situaciyu, tem luchshe. V
       chastnosti, k kakoj chasti sistemy otnositsya vasha problema?
       Proyavlyaetsya li ona na `etape ustanovki ili vo vremya normal'noj
       raboty? Naprimer, vmesto stroki Synopsis: portupgrade is broken
       sledovalo by napisat' chto-to vrode Synopsis: port
       ports-mgmt/portupgrade coredumps on -current. V sluchae portirovannyh
       prilozhenij v pole <<Synopsis>> polezno ukazyvat' ne tol'ko imya
       porta, no i kategoriyu.

     * Esli u vas est' gotovyj patch, skazhite ob `etom. PR, soderzhaschij
       patch, imeet kuda bol'she shansov byt' rassmotrennym. V `etom sluchae
       dobav'te stroku [patch] (vklyuchaya kvadratnye skobki) v nachalo polya
       <<Synopsis>> (hotya ispol'zovanie imenno `etoj formy neobyazatel'no,
       ona yavlyaetsya standartom de-fakto).

     * Esli vy otvechaete za ishodnye teksty, soobschite ob `etom. Esli vy
       otvechaete za chast' ishodnyh tekstov (naprimer, port), vy mozhete
       dobavit' v nachalo polya <<Synopsis>> stroku [maintainer update]
       (vklyuchaya kvadratnye skobki), a takzhe ustanovit' klass vashego PR
       (pole <<Class>>) v maintainer-update. V `etom sluchae kommitteru,
       obrabatyvayuschemu vash PR, ne pridiotsya lishnij raz proveryat'.

     * Bud'te tochny v formulirovkah. CHem bol'she informacii vy mozhete
       predostavit' o probleme, tem bol'she u vas shansov poluchit' otvet.

          * Vklyuchite informaciyu o versii FreeBSD, kotoruyu vy ispol'zujte
            (suschestvuet special'noe pole dlya ego vklyucheniya, smotrite
            nizhe) i na kakoj arhitekture. Soobschite, ispol'zuete li vy
            release versiyu (ustanovili s kompakt-diska libo zagruzili) ili
            skachali eio s pomosch'yu Subversion (i esli tak, to soobschite
            nomer revizii). Esli vy ispol'zuete FreeBSD-CURRENT, to pervyj
            vopros, kotoryj vam mogut zadat', budet pro nomer revizii, tak
            kak ispravleniya dlya `etoj vetki (osobenno v sluchae ser'ioznyh
            problem) imeyut tendenciyu poyavlyat'sya slishkom bystro.

          * Vklyuchite informaciyu o tom, kakie global'nye opcii vy ukazali v
            make.conf. Na zametku: Ob"yavlenie opcij napodobie -02 i drugih,
            opisannyh v gcc(1) vo mnogih sluchayah mozhet byt' prichinoj
            oshibok. Hotya i razrabotchiki FreeBSD budut prinimat' patchi, u
            nih ne budet zhelaniya issledovat' takie sluchai iz-za
            otsutstviya vremeni i dobrovol'cev, i vmesto `etogo oni mogut
            otvetit', chto `eto ne podderzhivaetsya.

          * Esli problemu mozhno legko povtorit', vklyuchite neobhodimuyu
            informaciyu, chtoby razrabotchik smog vosproizvesti ee
            samostoyatel'no. Esli problema proyavlyaetsya pri nekotoryh
            vvodimyh dannyh, to, po vozmozhnosti, privedite ih vmeste s
            poluchaemym i ozhidaemym vyvodom. Esli zhe vvodimyh dannyh mnogo
            ili zhe ih nel'zya razglashat', to poprobujte vydelit' iz nih
            lish' nebol'shoj fragment, privodyaschij k vozniknoveniyu
            problemy, i vklyuchite ego v PR.

          * Esli vasha problema svyazana s yadrom, bud'te gotovy predostavit'
            sleduyuschuyu informaciyu (vam ne obyazatel'no vklyuchat' eio
            vsyu, ona pojdiot lish' na zapolnenie bazy dannyh, no vy dolzhny
            vklyuchit' informaciyu, kotoraya po vashemu mneniyu aktual'na):

               * Vashu konfiguraciyu yadra, vklyuchaya to, kakie ustrojstva u
                 vas ustanovleny

               * Vklyucheny li u vas opcii otladki (naprimer, WITNESS), i
                 esli tak, to suschestvuet li problema posle izmeneniya
                 znacheniya `etoj opcii

               * Polnyj vyvod obratnoj trassirovki (backtrace), paniki ili
                 inogo konsol'nogo vyvoda, ili zhe zapisi iz
                 /var/log/messages, esli oni byli sgenerirovany

               * Vyvod komandy pciconf -l, a takzhe sootvetstvuyuschie chasti
                 vyvoda dmesg, v sluchae, esli problema svyazana s konkretnym
                 oborudovaniem

               * Prochli li vy src/UPDATING, opisana li tam vasha problema
                 (kto-nibud' sprosit obyazatel'no)

               * Zapuskaetsya li drugoe yadro (`eto dlya teh sluchaev, kogda
                 prichinoj sboya stalo oborudovanie, naprimer otkazyvayuschie
                 vinchestery ili peregrevshiesya processory, chto mozhet
                 maskirovat' problemy yadra)

          * Esli zhe vasha problema svyazana s portami, to predostav'te
            sleduyuschuyu informaciyu (vam ne obyazatel'no vklyuchat' eio
            vsyu, ona pojdet lish' na zapolnenie bazy dannyh, no vy dolzhny
            vklyuchit' informaciyu, kotoraya po vashemu mneniyu aktual'na):

               * Kakie porty vy ustanavlivali

               * Imeyutsya li kakie-libo peremennye okruzheniya, kotorye
                 perepisyvayut pervonachal'no-ustanovlennye v bsd.port.mk,
                 takie kak, PORTSDIR)

               * Prochli li vy ports/UPDATING, i opisana li tam vasha
                 problema (kto-nibud' sprosit obyazatel'no)

     * Izbegajte nechetkih zaprosov o novyh vozmozhnostyah. Soobschenie tipa
       <<kto-to obyazatel'no dolzhen sdelat' tak, chtoby takaya-to utilita
       vela sebya tak-to>> imeet kuda men'she shansov vstretit' pozitivnyj
       otklik, chem bolee chetko sformulirovannyj zapros. Pomnite, chto
       ishodnye teksty dostupny vsem, tak chto esli vam nuzhna realizaciya
       kakogo-to novogo svojstva, luchshij sposob- vzyat'sya za rabotu
       samomu! Ne zabud'te takzhe, chto takie momenty luchshe obsuzhdat' v
       spiskah rassylki, takih kak freebsd-questions, chem delat' `eto
       posredstvom bazy dannyh PR.

     * Ubedites', chto vasha problema esche nikem ne opisana. My uzhe
       govorili ob `etom, no stoit povtorit'sya. Potrat'te paru minut na
       sostavlenie zaprosov k baze PR:
       http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query. (Nesmotrya na
       povtory, ob `etom postoyanno zabyvayut)

     * Soobschajte ob odnoj probleme v odnom PR. Izbegajte opisaniya dvuh i
       bolee problem v odnom soobschenii (isklyucheniem yavlyayutsya
       vzaimosvyazannye problemy). Oformlyaya patchi, ne pytajtes' v nih
       dobavlyat' mnozhestvo funkcional'nyh vozmozhnostej ili ispravlyat' imi
       neskol'ko oshibok v odnom i tom zhe soobschenii o probleme (opyat'
       zhe, za isklyucheniem vzaimosvyazannyh problem) - dlya takih PR-ov
       potrebuetsya znachitel'no bol'she vremeni na obrabotku.

     * Izbegajte polemiki. Esli vashe soobschenie kasaetsya oblasti ili
       sposobov realizacii, kotorye ranee vyzvali raznoglasiya, vam stoit
       byt' gotovym predostavit' ne tol'ko patchi, no i vnyatnye argumenty,
       pochemu sleduet postupat' imenno tak (to est', `eto <<Pravil'nyj
       Put'>>). Kak otmechalos' vyshe, akkuratnyj poisk po arhivu spiskov
       rassylki http://www.FreeBSD.org/search/search.html#mailinglists
       nikogda ne pomeshaet.

     * Bud'te vezhlivy. Pochti kazhdyj iz teh, kto mozhet zanimat'sya vashim
       soobscheniem, yavlyaetsya dobrovol'cem. Nikomu ne ponravyatsya
       ukazaniya, kak i chto delat', kogda on i tak zanimaetsya `etim, da
       esche i po kakim-libo prichinam, otlichnym ot finansovyh. Voobsche
       govorya, `etogo podhoda sleduet priderzhivat'sya, imeya delo s lyubym
       proektom s Otkrytymi Ishodnymi tekstami (Open Source).

  4.2. Prezhde vsego

   Esli vy ispol'zujte utilitu send-pr(1) prover'te, chto peremennaya vashego
   okruzheniya VISUAL (ili EDITOR, esli VISUAL ne zadana) zadana
   podhodyaschim obrazom.

   Sleduet takzhe proverit' rabotosposobnost' sistemy `elektronnoj pochty.
   Utilita send-pr(1) ispol'zuet pochtovuyu sistemu dlya otpravki i
   otslezhivaniya soobscheniya o probleme. Esli s mashiny, na kotoroj vy
   zapuskaete send-pr(1), nel'zya otpravit' pochtu, soobschenie ne popadiot v
   bazu dannyh GNATS. O nastrojke `elektronnoj pochty vo FreeBSD mozhno
   prochitat' v glave <<`Elektronnaya pochta>> Rukovodstva po FreeBSD po
   adresu http://www.FreeBSD.org/doc/ru_RU.KOI8-R/books/handbook/mail.html.

   Ubedites', chto vash pochtovyj klient ne iskazit soobschenie po puti v
   GNATS. V chastnosti, esli vash pochtovyj klient avtomaticheski perenosit
   stroki, izmenyaet simvoly tabulyacii na probely ili predotvraschaet
   interpretaciyu simvolov novoj stroki, lyuboj patch, kotoryj vy prishliote
   okazhetsya neprigodnym. Dlya teksta my hoteli by, chtoby vy delali
   strochki razmerom primerno v 70 simvolov dlya chitabel'nosti PR na veb
   stranice.

   Primernye soobrazheniya dolzhny uchityvat'sya pri otpravke soobscheniya ob
   oshibke cherez veb-formu vmesto send-pr(1). Pomnite, chto operacii
   kopirovaniya-vstavki mogut imet' storonnie `effekty v formatirovanii
   teksta. V opredelionnyh sluchayah mozhet byt' neobhodimo ispol'zovat'
   uuencode(1) dlya garantii togo, chto patchi pridut ne izmenionnymi.

   I nakonec, esli vashe soobschenie budet ob"iomnym, vy dolzhny prigotovit'
   ego v offline, chtoby nichego ne poteryalos' v sluchae, esli budet
   problema pri ego otpravke. `Eto osobenno kasaetsya veb-formy.

  4.3. Vlozhenie patchej ili fajlov

   Nizhesleduyuschee primenimo k peredache soobscheniya o probleme
   posredstvom `elektronnoj pochty:

   Programma send-pr(1) predusmatrivaet prisoedinenie fajlov k soobscheniyu o
   probleme. Vy mozhete vlozhit' skol'ko ugodno fajlov, no kazhdyj s
   unikal'nym imenem (imeetsya v vidu imya fajla bez marshruta). Prosto
   ispol'zujte parametr komandnoj stroki -a dlya zadaniya imen fajlov,
   kotorye vy hotite prisoedinit':

 % send-pr -a /var/run/dmesg -a /tmp/errors

   Ne bespokojtes' o binarnyh fajlah, oni budut avtomaticheski perekodirovany
   dlya togo, chtoby ne povredit' rabote vashej pochtovoj programmy.

   Esli vy vkladyvaete patch, obyazatel'no ispol'zujte parametr -c ili -u
   vmeste s komandoj diff(1) dlya sozdaniya kontekstnogo ili unificirovannogo
   diff-fajla (unificirovannyj format predpochtitelen), i obyazatel'no
   ukazhite tochnye nomera SVN revizij fajlov, kotorye vy izmenyali, chtoby
   razrabotchiki, kotorye budut chitat' vashe soobschenie, smogli legko ego
   primenit'. Dlya problem, svyazannyh s yadrom ili s bazovymi utilitami,
   predpochtitel'nee budet patch otnositel'no vetki FreeBSD-CURRENT (ili
   Subversion-vetki HEAD), tak kak ves' novyj kod dolzhen byt' snachala
   protestirovan v nej. Posle zaversheniya testirovaniya kod budet
   integrirovan v vetv' FreeBSD-STABLE.

   Esli vy vstavlyaete patch v telo soobscheniya, uchtite, chto nekotorye
   pochtovye programmy imeyut tendenciyu zamenyat' tabulyacii seriej
   probelov, chto polnost'yu razrushit, naprimer, chast' fajla sborki
   (Makefile).

   Ne otsylajte patchi v vide vlozhenij, ispol'zuya
   Content-Transfer-Encoding: quoted-printable. `Eto vypolnit `ekranirovanie
   (escaping) simvolov i ves' patch budet bespoleznym.

   Sleduet takzhe zametit', chto vklyuchenie nebol'shih patchej v soobschenie
   o probleme yavlyaetsya priemlemoj praktikoj, v osobennosti esli oni
   reshayut problemu, opisannuyu v soobschenii, bol'shie zhe patchi, a v
   osobennosti novyj kod, kotoryj mozhet trebovat' znachitel'nogo prosmotra
   pered tem, kak on budet vnesen v derevo ishodnyh tekstov, dolzhny byt'
   razmescheny na web- ili ftp-servere, a v soobschenie o probleme dolzhen
   byt' vklyuchion tol'ko URL ukazyvayuschij na `etot patch. Ochen' chasto
   patchi, peresylaemye po `elektronnoj pochte, a v osobennosti esli
   zadejstvovana GNATS, byvayut iskazheny, i, kak sledstvie, chem bol'she
   patch, tem trudnee budet dlya zainteresovannyh lyudej privesti ego k
   normal'nomu vidu. Takzhe to, chto patch budet razmeschion otdel'no ot
   soobscheniya o probleme, daiot vozmozhnost' izmenyat' ego ne otsylaya
   polnyj patch v dopolnenie k iznachal'nomu soobscheniyu o probleme. I
   nakonec, bol'shie patchi prosto uvelichivayut razmer bazy dannyh, tak kak
   zakrytye soobscheniya ob oshibkah na samom dele ne udalyayutsya, a
   sohranyayutsya i pomechayutsya, kak closed.

   Vy dolzhny takzhe pomnit', chto poka vy yavno ne ukazhete obratnogo v
   vashem soobschenii o probleme ili v samih patchah, budet predpolagat'sya,
   chto oni podpadayut pod te zhe usloviya licenzirovaniya, chto i
   original'nyj fajl, izmenennyj vami.

  4.4. Zapolnenie shablona

   Sleduyuschie neskol'ko abzacev primenimy tol'ko k sposobu podachi PR
   cherez `elektronnuyu pochtu:

   Posle zapuska utility send-pr(1) vam budet predstavlen shablon
   soobscheniya o probleme. SHablon sostoit iz spiska polej, nekotorye iz
   kotoryh uzhe zapolneny, a nekotorye soderzhat kommentarii,
   ob"yasnyayuschie naznachenie polya ili perechislyayuschie podhodyaschie
   znacheniya. Ne bespokojtes' o kommentariyah; oni budut avtomaticheski
   udaleny, esli vy ih ne izmenyali (ili udalite ih sami).

   Vverhu shablona, nizhe strok SEND-PR: nahodyatsya zagolovki pochtovogo
   soobscheniya. Vam obychno ne nuzhno ih izmenyat', esli tol'ko vy ne
   posylaete soobschenie o probleme s mashiny ili ot uchetnoj zapisi,
   kotoraya mozhet posylat', no ne mozhet poluchat' `elektronnuyu pochtu, v
   sluchae chego vy mozhete zadat' v polyah From: i Reply-To: vashi real'nye
   adresa `elektronnoj pochty. Vy mozhete takzhe poslat' samomu sebe (ili
   komu-to esche) kopiyu soobscheniya o probleme, dobaviv odin ili bol'shee
   kolichestvo adresov k zagolovku Cc:.

   V shablone vy najdete dva odnostrochnyh polya:

     * Submitter-Id: Ne menyajte ego. Znachenie po umolchaniyu current-users
       pravil'no, dazhe esli vy ispol'zuete FreeBSD-STABLE.

     * Confidential: Predvaritel'no zapolneno kak no, ego izmenenie ne imeet
       znacheniya, tak kak net takogo ponyatiya, kak konfidencial'noe
       soobschenie o probleme - baza dannyh PR rasprostranyaetsya po vsemu
       miru.

   Dalee opisany obschie polya dlya pochtovogo i veb interfejsa:

     * Originator: Pozhalujsta, ukazhite vashe real'noe imya, za kotorym
       opcional'no sleduet adres vashej `elektronnoj pochty v uglovyh
       skobkah. Obychno, send-pr(1) zapolnyaet pole Originator soderzhimym
       polya gecos iz uchetnoj zapisi tekuschego pol'zovatelya.

  Primechanie:

       Predostavlennyj vami adres `elektronnoj pochty stanet publichnoj
       informaciej i mozhet stat' dostupnym spameram. Po`etomu sovsem ne
       lishnimi budut mery po bor'be so spamom na vashej storone, ili zhe
       mozhno vospol'zovat'sya vremennym adresom `elektronnoj pochty. Odnako,
       esli vy ukazhete nesuschestvuyuschij pochtovyj adres, to u nas ne
       budet vozmozhnosti utochnyat' detali po vashemu PR.

     * Organization: Vse, chto vy zahotite zdes' ukazat'. `Eto pole ne
       soderzhit znachitel'noj informacii.

     * Synopsis: Zapolnyaetsya kratkim i tochnym opisaniem problemy. Kratkoe
       opisanie ispol'zuetsya v kachestve temy soobscheniya `elektronnoj
       pochty o probleme, i ispol'zuetsya pri vydache spiskov i vyborkah
       soobschenij o problemah; soobscheniya o problemah s neponyatnymi
       kratkimi opisaniyami chasche vsego ignoriruyutsya.

       Povtorim: esli k vashemu soobscheniyu o probleme prilozhen patch, to,
       pozhalujsta, nachnite kratkoe opisanie s [patch] (vklyuchaya
       kvadratnye skobki); esli PR prinadlezhit k kategorii ports i vy
       yavlyaetes' ego mejntejnerom, to nachnite opisanie s [maintainer
       update] (vklyuchaya kvadratnye skobki) i ustanovite klass problemy
       (pole <<Class>>) v maintainer-update.

     * Severity: Odno iz non-critical, serious ili critical. Ne
       pereuserdstvujte; izbegajte pometki vashej problemy kak critical, esli
       tol'ko `eto ne dejstvitel'no kritichnaya problema (povrezhdenie
       dannyh, suschestvennaya poterya funkcional'nosti v -CURRENT), ili
       serious, esli tol'ko `eto ne kasaetsya mnogih pol'zovatelej (paniki
       yadra, blokirovki (freezes), problemy s konkretnymi drajverami
       ustrojstv ili s sistemnymi utilitami). Razrabotchiki FreeBSD ne
       obyazatel'no budut rabotat' nad vashej problemoj bystree, esli vy
       ustanovite slishkom vysokij uroven' vazhnosti, t.k. suschestvuet mnogo
       drugih lyudej, kotorye sdelali tozhe samoe - nekotorye razrabotchiki
       vsio zhe udelyat `etomu polyu nemnogo vnimaniya i perejdut k
       sleduyuschemu soobscheniyu imenno iz-za `etogo polya.

  Primechanie:

       Bol'shinstvo problem s bezopasnost'yu ne sleduet otpravlyat' v GNATS,
       potomu chto vsya `eta informaciya stanovitsya publichnoj. Pozhalujsta,
       napravlyajte podobnye otchety na `elektronnyj adres Gruppa Oficerov
       Bezopasnosti <security-officer@FreeBSD.org>.

     * Priority: Odno iz low, medium ili high. high dolzhen ispol'zovat'sya
       dlya problem, kotorye zatronut konkretno kazhdogo pol'zovatelya
       FreeBSD, a medium dlya chego-to, chto zatronet mnogih pol'zovatelej.

  Primechanie:

       Vvidu massovyh zloupotreblenij `eto pole poteryalo svoe znachenie.

     * Category: Vyberite sootvetstvuyuschuyu kategoriyu.

       Pervym delom neobhodimo reshit', k kakoj chasti sistemy otnositsya
       vasha problema. Pomnite: FreeBSD - zavershennaya operacionnaya
       sistema, kotoraya ustanavlivaet yadro, standartnye biblioteki,
       mnozhestvo drajverov periferijnogo oborudovaniya, a takzhe - bol'shoj
       nabor sistemnyh utilit (<<bazovaya sistema>>). V dopolnenie k `etomu,
       v kollekcii portov imeyutsya tysyachi prilozhenij. Sledovatel'no,
       opredelites': obnaruzhennaya vami problema nahoditsya v bazovoj
       sisteme ili v chem-to, ustanovlennym cherez kollekciyu portov.

       Vot opisanie osnovnyh kategorij:

          * Esli problema v yadre, v bibliotekah (takih kak standartnaya
            biblioteka S libc) ili v drajvere iz bazovoj sistemy, to
            ispol'zujte kategoriyu kern. (Est' neskol'ko isklyuchenij,
            opisannyh nizhe). V obschem, `eto vsio, chto opisano v razdelah
            2, 3 ili 4 spravochnika.

          * Esli problema s binarnoj programmoj, naprimer s sh(1) ili
            mount(8), to vam prezhde vsego neobhodimo opredelit'
            prinadlezhnost' programmy k bazovoj sisteme ili k ustanovke iz
            kollekcii portov. Esli vy ne uvereny, vypolnite komandu whereis
            imya programmy. V FreeBSD dlya kollekcii portov suschestvuet
            dogovorennost': ustanovka vedetsya v /usr/local, odnako `eto
            mozhet byt' pereopredeleno sistemnym administratorom. Dlya takih
            programm sleduet ispol'zovat' kategoriyu ports (dazhe esli
            kategoriya porta www; sm. nizhe). Esli programma raspolagaetsya v
            /bin, /usr/bin, /sbin ili v /usr/sbin, to `eto chast' bazovoj
            sistemy, i vam sleduet ispol'zovat' kategoriyu bin. (Neskol'ko
            programm, naprimer gcc(1), na samom dele ispol'zuyut kategoriyu
            gnu, no ne bespokojtes' ob `etom sejchas.) Programmy `etoj
            kategorii opisany v razdelah 1 i 8 spravochnoj sistemy.

          * Esli vy uvereny, chto v startovyh skriptah (rc) ili v kakom-to
            inom neispolnyaemom konfiguracionnom fajle prisutstvuet oshibka,
            togda vernoj kategoriej budet conf (configuration). `Eti
            suschnosti opisyvayutsya v razdele 5 spravochnoj sistemy.

          * Esli vy nashli problemu v nabore dokumentacii (stat'i, knigi,
            stranicy spravochnoj sistemy), pravil'nym vyborom budet docs.

          * Esli vy nablyudaete problemu na stranicah sajta FreeBSD, to
            pravil'nym vyborom budet www.

  Primechanie:

            Esli problema s chem-to iz porta, nazyvaemogo www/someportname ,
            to ona vse zhe prinadlezhit k kategorii ports.

       Dalee predstavleny bolee specializirovannye kategorii.

          * Esli problema prinadlezhit k kern, no v to zhe vremya imeet delo
            s podsistemoj USB, to pravil'nym vyborom budet usb.

          * Esli problema prinadlezhit k kern i najdena v potokovyh
            bibliotekah, pravil'nym vyborom budet threads.

          * Esli problema prinadlezhit k bazovoj sisteme i kasaetsya
            soblyudeniya standartov, takih kak POSIX(R), pravil'nym vyborom
            budet standards.

          * Esli problema svyazana s oshibkami vnutri Java Virtual MachineTM
            (JVMTM), dazhe esli JavaTM byla ustanovlena iz kollekcii portov,
            vam sleduet vybrat' kategoriyu java. Bolee obschie problemy s
            portami JavaTM popadayut pod kategoriyu ports.

       Dalee perechisleny ostal'nye kategorii.

          * Esli vy uvereny, chto problema proyavlyaetsya tol'ko na
            ispol'zuemoj vami processornoj arhitekture, vyberite odnu iz
            arhitekturno-specifichnyh kategorij: `eto i386 dlya
            Intel-sovmestimyh mashin v 32-bitnom rezhime; amd64 dlya AMD
            mashin v 64-bitnom rezhime (syuda takzhe vhodyat
            Intel-sovmestimye mashiny rabotayuschie v rezhime EMT64); i menee
            rasprostranennye arm, ia64, powerpc i sparc64.

  Primechanie:

            Lyudi chasto oshibayutsya v vybore kategorii. Esli vy ne uvereny
            v pravil'nosti vybora, to luchshe ne gadat', a vybrat' misc.

            Primer 1. Pravil'noe ispol'zovanie kategorii

            U vas prostoj PK, i vy podozrevaete, chto stolknulis' s
            problemoj, specifichnoj dlya konkretnogo chipseta ili materinskoj
            platy: vernaya kategoriya - i386.

            Primer 2. Nepravil'noe ispol'zovanie kategorii

            Esli vy nablyudaete problemu s periferijnoj kartoj rasshireniya
            na rasprostranennoj shine ili nepoladki s konkretnogo tipa
            zhestkim diskom: v `etom sluchae vozmozhno, chto neispravnost'
            nablyudaetsya na bolee chem odnoj arhitekture, i vernym vyborom
            budet kern.

          * Esli vy ne znaete v chem problema (ili vam kazhetsya, chto
            opisanie ne popadaet ni pod kakuyu iz vysheoboznachennyh),
            ispol'zujte kategoriyu misc. Pered tem, kak napisat' PR, mozhno
            dlya nachala sprosit' pomoschi v Spisok rassylki, posvyaschionnyj
            voprosam i otvetam pol'zovatelej FreeBSD. Vozmozhno, tam vam
            podskazhut, kakuyu iz suschestvuyuschih kategorij sleduet
            vybrat'.

       Vot tekuschij perechen' kategorij (vzyat iz
       http://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories):

          * advocacy: problemy, svyazannye s obschestvennym mneniem o
            FreeBSD. Vyshlo iz upotrebleniya.

          * amd64: problemy, specifichnye dlya platformy AMD64.

          * arm: problemy, specifichnye dlya platformy ARM.

          * bin: problemy s pol'zovatel'skimi programmami iz bazovoj sistemy.

          * conf: problemy s fajlami nastrojki, ispol'zuemymi po umolchaniyu
            znacheniyami i prochee.

          * docs: problemy so stranicami spravochnoj sistemy ili onlajnovoj
            dokumentaciej.

          * gnu: problemy s portirovannym programmnym obespecheniem GNU,
            takim kak gcc(1) ili grep(1).

          * i386: problemy, specifichnye dlya platformy i386TM.

          * ia64: problemy, specifichnye dlya platformy ia64.

          * java: problemy, svyazannye s virtual'noj mashinoj JavaTM.

          * kern: problemy s yadrom ili s bibliotekami v bazovoj sisteme, ili
            s drajverami ustrojstv, ne svyazannymi s kakoj-libo konkretnoj
            platformoj.

          * misc: vse, chto ne podpadaet ni pod kakuyu druguyu kategoriyu.
            (Nado otmetit', chto net pochti nichego, chtoby dejstvitel'no
            sootvetstvovalo `etoj kategorii, za isklyucheniem problem s
            relizami i s infrastrukturoj sborki. Vremennye otkazy pri
            postroenii vetki HEAD ne prinadlezhat k dannoj kategorii. Takzhe
            nado otmetit', chto problemy `etoj kategorii imeyut tendenciyu
            teryat'sya legche vsego).

          * ports: problemy, svyazannye s kollekciej portov.

          * powerpc: problemy, specifichnye dlya platformy PowerPC(R).

          * sparc64: problemy, specifichnye dlya platformy Sparc64(R).

          * standards: problemy, svyazannye s sootvetstviem standartam.

          * threads: problemy, kasayuschiesya realizacii tredov vo FreeBSD
            (osobenno vo FreeBSD-CURRENT).

          * usb: problemy, otnosyaschiesya k realizacii USB vo FreeBSD.

          * www: izmeneniya ili uluchsheniya sajta FreeBSD

     * Class: Vyberite odno iz sleduyuschego:

          * sw-bug: oshibki v programmnom obespechenii.

          * doc-bug: oshibki v dokumentacii.

          * change-request: zaprosy na rasshirenie funkcij ili izmenenie v
            suschestvuyuschih.

          * update: obnovleniya portov ili drugogo programmnogo obespecheniya
            storonnih razrabotchikov.

          * maintainer-update: obnovleniya v portah, dlya kotoryh vy
            yavlyaetes' otvetstvennoj personoj.

     * Release: Ispol'zuemaya vami versiya FreeBSD. Ono zapolnyaetsya
       avtomaticheski programmoj send-pr(1) i trebuet izmeneniya, esli tol'ko
       vy otsylaete soobschenie o probleme s sistemy, otlichayuschejsya ot
       toj, gde vy stolknulis' s problemoj.

   I nakonec, posledovatel'nost' mnogostrochnyh polej:

     * Environment: Ono dolzhno maksimal'no tochno opisyvat' okruzhenie, v
       kotorom vstrechaetsya problema. Syuda vklyuchaetsya versiya
       operacionnoj sistemy, versiya konkretnoj programmy ili fajla,
       soderzhaschego problemu, i lyubaya drugaya informaciya, takaya, kak
       konfiguraciya sistemy, drugoe programmnoe obespechenie, kotoroe
       vliyaet na problemu, i tak dalee-prosto vse, chto razrabotchik dolzhen
       znat' dlya sozdaniya uslovij poyavleniya problemy.

     * Description: Polnoe i tochnoe opisanie problemy, s kotoroj vy
       stolknulis'. Popytajtes' izbezhat' svoih predpolozhenij o prichinah
       problemy, esli tol'ko vy ne uvereny, chto pravy, tak kak vy mozhete
       privesti razrabotchika k nepravil'nym predpolozheniyam o probleme.

     * How-To-Repeat: Posledovatel'nost' dejstvij, kotorye dolzhny byt'
       vypolneny dlya povtoreniya problemy.

     * Fix: Predpochtitelen patch, ili po krajnej mere obhodnoj put' (kotoryj
       ne tol'ko pomozhet drugim lyudyam obojti tu zhe samuyu problemu, no
       takzhe pomozhet razrabotchiku ponyat' ee prichiny), odnako esli u vas
       net nikakih zdravyh idej, to luchshe ostavit' `eto pole pustym, chem
       stroit dogadki.

  4.5. Otpravka soobscheniya o probleme

   Esli vy ispol'zuete send-pr(1):

   Kak tol'ko vy zapolnite shablon, sohranite ego i vyjdete iz redaktora,
   send-pr(1) zaprosit vas s)end, e)dit or a)bort?. Vy mozhete nazhat' s dlya
   prodolzheniya i otpravki soobscheniya o probleme, e dlya povtornogo
   zapuska redaktora i vypolneniya dal'nejshih izmenenij, ili a dlya otkaza
   ot vashego soobscheniya. Esli vy vyberete poslednee, to vashe soobschenie
   o probleme ostanetsya na diske (send-pr(1) ukazhet vam imya fajla pered
   zaversheniem raboty), tak chto vy smozhete otredaktirovat' ego na svoj
   vkus ili peredat' v sistemu s luchshim podklyucheniem k seti, pered tem,
   kak poslat' ego pri pomoschi parametra -f programmy send-pr(1):

 % send-pr -f ~/my-problem-report

   Pri `etom budet prochitan ukazannyj fajl, budet provereno soderzhimoe,
   ubrany kommentarii i soobschenie budet otoslano.

   Esli vy ispol'zuete veb formu:

   Pered nazhatiem submit vam potrebuetsya zapolnit' proverochnoe pole
   tekstom, predstavlennym na kartinke ryadom. `Eta nepopulyarnaya mera byla
   prinyata v svyazi so zloupotrebleniyami so storony robotov i nekotoryh
   neverno sorientirovannyh individuumov. `Eto neobhodimaya mera, kotoraya
   nikomu ne nravitsya, i, pozhalujsta, ne prosite nas ubrat' eio.

   Otmetim, chto vam nastoyatel'no rekomenduetsya sohranit' vashu rabotu (PR)
   kuda-nibud' pered nazhatiem knopki submit. Rasprostranennaya
   pol'zovatel'skaya oshibka: otobrazhenie brauzerom ustarevshej proverochnoj
   kartinki iz ego k`esha. Esli `eto proizojdet v vashem sluchae, vashe
   soobschenie budet otvergnuto i vashi trudy propadut.

   Esli po kakoj-libo prichine vy ne imeete vozmozhnosti videt' proverochnuyu
   kartinku, a takzhe ne mozhete vospol'zovat'sya send-pr(1), pozhalujsta
   primite nashi izvineniya za neudobstva i prishlite vash PR `elektronnoj
   pochtoj komande <freebsd-bugbusters@FreeBSD.org>.

5. Otslezhivanie

   Posle togo, kak vashe soobschenie budet prinyato, vy poluchite po
   `elektronnoj pochte uvedomlenie, v kotorom budet ukazan nomer dlya
   otslezhivaniya, kotoryj byl naznachen vashemu soobscheniyu o probleme i
   URL, kotoryj vy mozhete ispol'zovat' dlya proverki ego sostoyaniya. V
   sluchae udachi kto-nibud' proyavit interes k vashej probleme i popytaetsya
   ee reshit', ili, kak `eto byvaet, opisat', pochemu `eto ne yavlyaetsya
   problemoj. Vy budete avtomaticheski opoveschat'sya o lyubom izmenenii
   sostoyaniya i poluchat' kopii vseh kommentariev ili patchej, kotorye budut
   prisoedinyat'sya v processe otrabotki vashego soobscheniya o probleme.

   Esli kto-to zaprosit dopolnitel'nuyu informaciyu ot vas, ili vy vspomnite
   ili obnaruzhite nechto, chto ne ukazali v nachal'nom soobschenii,
   pozhalujsta poshlite vashe dopolnenie (otklik) s pomosch'yu odnogo iz
   `etih sposobov:

     * Samyj prostoj put' `eto ispol'zovat' sootvetstvuyuschuyu ssylku
       (followup) na individual'noj veb stranichke soobscheniya ob oshibki, k
       kotoroj mozhno perejti, ispol'zuya stranichku poiska PR. Kliknuv na
       `etoj ssylke otkroetsya okno dlya otpravki email s uzhe korrektno
       zapolnennymi polyami To: i Subject: (esli vash brauzer skonfigurirovan
       dlya `etogo).

     * Ili prosto poshlite pis'mo na adres <bug-followup@FreeBSD.org>,
       vklyuchiv otslezhivaemyj nomer v teme pis'ma, chtoby sistema
       otslezhivaniya soobschenij mogla znat', k kakomu soobscheniyu o
       probleme ego prisoedinit'.

  Primechanie:

       Esli vy ne vklyuchite otslezhivaemyj nomer, GNATS rasteryaetsya i
       sozdast sovershenno novoe PR, kotoroe budet zakrepleno za
       administratorom GNATS. V rezul'tate vash otklik zateryaetsya do teh
       por poka kto-nibud' ne nachniot razgrebat' skopivshijsya musor, chto
       mozhet proizojti spustya dni ili dazhe nedeli.

       Nepravil'no:

 Subject: that PR I sent

       Pravil'no:

 Subject: Re: ports/12345: compilation problem with foo/bar

   Esli soobschenie o probleme ostaetsya otkrytym posle togo, kak problema
   byla reshena, prosto otprav'te soobschenie (tak, kak `eto opisano vyshe),
   s ukazaniem, chto soobschenie o probleme mozhet byt' zakryto, i esli `eto
   vozmozhno, ob"yasnite, kak i kogda problema byla ustranena.

6. Problemy vzaimodejstviya s GNATS

   Bol'shinstvo PR prohodyat skvoz' sistemu i prinimayutsya bystro; odnako,
   vo vremya zagruzhennosti GNATS, podtverzhdenie na vashe soobschenie o
   probleme mozhet zaderzhat'sya na 10 i bolee minut. Pozhalujsta,
   sohranyajte spokojstvie.

   Pomimo vsego prochego, tak kak GNATS poluchaet vse dannye cherez
   `elektronnuyu pochtu, stanovitsya ponyatnym, pochemu FreeBSD propuskaet
   vse soobscheniya cherez spamfil'try. Esli podtverzhdenie ne prihodit na
   protyazhenii chasa-dvuh, to, vozmozhno, chto vashe soobschenie popalo pod
   nih; esli tak, to, pozhalujsta, svyazhites' s administratorami GNATS po
   adresu <bugmeister@FreeBSD.org> i poprosite pomoschi.

  Primechanie:

   Sredi antispam mer est' odna, kotoraya sopostavlyaet soobscheniya s
   mnozhestvom zloupotreblenij, nablyudaemyh v `elektronnoj pochte s
   HTML-formatirovaniem teksta (odnako, syuda ne otnositsya prostoe
   vklyuchenie HTML v PR). My nastoyatel'no rekomenduem ne ispol'zovat'
   HTML-formatirovannyj tekst pri posylke PR: ne tol'ko iz-za veroyatnosti
   popadaniya v spamfil'try, no i iz-za zagromozhdeniya bazy dannyh. Otdajte
   predpochtenie prostomu staromu tekstovomu formatu.

   V redkih sluchayah vy mozhete stolknut'sya s oshibkoj GNATS, kogda PR
   prinyat i emu prisvoen nomer, no on ne otobrazhaetsya v spiskah PR ni na
   odnoj iz stranic veb poiska PR. Veroyatno, chto rassinhronizirovalsya
   indeks bazy s samoj bazoj. `Etot sluchaj mozhno proverit', obrativshis' k
   stranichke Query PR Database i prokontrolirovav nalichie vashego PR. Esli
   on est', pozhalujsta, izvestite administratorov GNATS
   (<bugmeister@FreeBSD.org>). Sleduet otmetit', chto perestrojka bazy
   vypolnyaetsya periodicheski po cron, i esli vam ne k spehu, to ne
   predprinimajte nikakih shagov.

7. Dopolnitel'naya literatura

   `Eto spisok informacionnyh resursov, otnosyaschihsya k pravil'nomu
   napisaniyu i obrabotke soobschenij o problemah. On, bez somneniya, ne
   polon.

     * How to Report Bugs Effectively-prekrasnoe `esse, kotoroe napisal Simon
       G. Tatham o sostavlenii poleznyh (ne specifichnyh dlya FreeBSD)
       soobschenij o problemah.

     * Problem Report Handling Guidelines-interesnyj vzglyad na obrabotku
       soobschenij o problemah samimi razrabotchikami FreeBSD.

Predmetnyj ukazatel'

  Simvoly

   soobscheniya o problemah, Sostavlenie soobschenij o probleme vo FreeBSD
