             Sostavlenie soobschenij o probleme vo FreeBSD

  Dag-Erling Smo/rgrav

  Mark Linimon

   $FreeBSD: doc/ru_RU.KOI8-R/articles/problem-reports/article.sgml,v
   1.8 2010/07/09 20:24:59 taras Exp $

   FreeBSD `eto zaregistrirovannaya torgovaya marka FreeBSD
   Foundation.

   CVSup `eto zaregistrirovannaya torgovaya marka John D. Polstra.

   IBM, AIX, EtherJet, Netfinity, 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, SPARCEngine, 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, JavaServer
   Pages, JDK, JRE, JSP, JVM, Netra, Solaris, StarOffice, Sun Blade,
   Sun Enterprise, Sun Fire, SunOS i Ultra `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)''.

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

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

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

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:

     * Zaprosy na rasshirenie funkcional'nosti. Obychno horoshej
       ideej yavlyaetsya ozvuchivanie `etogo v spiskah rassylki do
       togo, kak posylat' soobschenie o probleme.

     * 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://www.FreeBSD.org/cgi/cvsweb.cgi/src/UPDATING.
       (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 CVSweb:
       http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/UPDATING i
       http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/CHANGES.

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

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 cvsup(1) (esli tak, to kak davno vy
            obnovlyalis'). Esli vy ispol'zujte FreeBSD-CURRENT, to
            pervyj vopros, kotoryj vam mogut zadat', budet pro datu
            poslednego obnovleniya, tak kak ispravleniya dlya `etoj
            vetki imeyut tendenciyu (osobenno dlya ser'ioznyh
            problem) 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 versij
   CVS 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 HEAD CVS), t.k. 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 posredstvom CVSup.

   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.

         Zamechanie: 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.

         Zamechanie: 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.

         Zamechanie: 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.

              Zamechanie: 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
            Machine(TM) (JVM(TM)), dazhe esli Java(TM) byla
            ustanovlena iz kollekcii portov, vam sleduet vybrat'
            kategoriyu java. Bolee obschie problemy s portami Java
            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.

              Zamechanie: 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://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories):

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

          * alpha: problemy, specifichnye dlya platformy Alpha.

          * 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 i386(TM).

          * ia64: problemy, specifichnye dlya platformy ia64.

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

          * 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'.

         Zamechanie: 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.

     Zamechanie: 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.

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

            `Etot, i drugie dokumenty, mogut byt' skachany s
                ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

  Po voprosam, svyazannym s FreeBSD, prochitajte dokumentaciyu prezhde
                 chem pisat' v <questions@FreeBSD.org>.
         Po voprosam, svyazannym s `etoj dokumentaciej, pishite
                           <doc@FreeBSD.org>.
  Po voprosam, svyazannym s russkim perevodom dokumentacii, pishite v
                    rassylku <frdp@FreeBSD.org.ua>.
  Informaciya po podpiske na `etu rassylku nahoditsya na sajte proekta
                               perevoda.
