             Sostavlenie soobschenij o probleme vo FreeBSD

  Dag-Erling Smo/rgrav

   $FreeBSD: doc/ru_RU.KOI8-R/articles/problem-reports/article.sgml,v
   1.6 2006/04/05 07:18:48 bvs 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.

   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); web-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 sysutils/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] 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], 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 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

               * damp, esli byl sgenerirovan

               * 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)

     * 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 web-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 web-formy.

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

  4.3. Vlozhenie patchej ili fajlov

   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

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

   Dalee sleduet posledovatel'nosti odnostrochnyh polej:

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

     * Originator: Obychno ono zapolneno polem dopolnitel'noj
       informacii uchetnoj zapisi pol'zovatelya. Pozhalujsta,
       ukazhite vashe real'noe imya, za kotorym opcional'no sleduet
       adres vashej `elektronnoj pochty v uglovyh skobkah.

     * 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];
       esli vy yavlyaetes' otvetstvennym za dannuyu chast' koda ili
       port, mozhete nachat' opisanie s [maintainer update] i
       ustanovit' 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 (k primeru, uyazvimost' pol'zovatelya root, legko
       vosproizvodimyj ostanov sistemy), ili serious, esli tol'ko
       `eto ne kasaetsya mnogih pol'zovatelej (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.

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

     * Category: Vyberite odnu iz sleduyuschih (vzyato iz
       http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories):

          * advocacy: problemy, svyazannye s obschestvennym mneniem o
            FreeBSD. Ispol'zuetsya redko.

          * alpha: problemy, specifichnye dlya platformy Alpha.

          * amd64: problemy, specifichnye dlya platformy AMD64.

          * 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 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(TM). (Portirovannye prilozheniya, trebuyuschie dlya
            svoej raboty Java dolzhny nahodit'sya v kollekcii
            portov.)

          * kern: problemy s yadrom ili s ne svyazannymi s kakoj-libo
            platformoj drajverami ustrojstv.

          * misc: vse, chto ne podpadaet ni pod kakuyu druguyu
            kategoriyu (Nado otmetit', chto problemy `etoj kategorii
            imeyut tendenciyu teryat'sya legche vsego).

          * ports: problemy, svyazannye s derevom 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

   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.

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

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