From effa145e3560c8f39287f0bf562891914b1bbf2f Mon Sep 17 00:00:00 2001
From: Damyan Ivanov Силно препоръчваме да съобщавате за откритите от вас грешки в Дебиан чрез програмата
@@ -17,7 +17,7 @@ href="https://packages.debian.org/stable/utils/reportbug">reportbug.<
обкръжение или чрез въвеждане на Програмата ще ви преведе през целия процес на събщаване за грешката. Програмата ще ви преведе през целия процес на съобщаване за проблема. Ако имате въпроси, които интерактивната система на reportbug не успява да
отговори, можете да се консултирате с тази документация или да попитате в пощенския списък за
(и reportbug за напреднали)
- Трябва да знаете за кой пакет се отнася откритата грешката.
+ Трябва да знаете за кой пакет се отнася открития проблем.
Вижте този пример за това как да откриете тази
информация. (Можете да използвате тази информация за да
-проверите дали за грешката вече не е докладвано.)
+проверите дали проблемът не е вече докладван.)
Ако не можете да определите кой пакет е отговорен за проблема,
-изпратете e-mail до
+изпратете имейл до
пощенския списък за потребители на Дебиан и помолете за съвет. Ако проблемът засяга просто някой пакет, а някоя основна услуга на Дебиан,
+ Ако проблемът засяга не просто някой пакет, а някоя основна услуга на Дебиан,
съществуват няколко псевдо-пакета
и пощенски списъка, които можете да използвате
за да препратите съобщението си до нас.
@@ -53,48 +53,47 @@ href="mailto:debian-user@lists.debian.org">пощенския списък за
- Преди да изпратите доклада за грешката е добре да проверите дали вече е
-съобщено за подобна грешка. Всички грешки, за които е съобщено в даден пакет
+ Преди да изпратите доклада е добре да проверите дали вече е
+съобщено за подобен проблем. Всички доклади за даден пакет
можете да видите чрез полето за филтриране по пакет на
формуляра за търсене на доклади за грешки.
-подобна
-Ако за грешката вече е съобщено под #<номер>, изпратете
+Ако за проблема вече е съобщено под #<номер>, изпратете
съобщението до <номер>@bugs.debian.org, вместо да създавате
нов доклад. Не изпращайте доклади за несвързани помежду си грешки (особено такива от
-различни пакети) в един доклад. Не изпращайте доклади за несвързани помежду си проблеми (особено такива от
+различни пакети) в едно съобщение. Ако изпращате доклад за грешка, открита в Дебиан, не изпращайте копие до
-оригиналните автори на програмата, тъй като е възможно грешката да съществува
-само в Дебиан. Ако е нужно, отговорникът на пакета ще препрати доклада към.
+ Ако съобщавате за проблем, открит в Дебиан, не изпращайте копие до
+оригиналните автори на програмата, тъй като е възможно проблемът да съществува
+само в Дебиан. Ако е нужно, отговорникът на пакета ще препрати доклада.
Изпращането на доклад за грешка става чрез изпращане на съобщение до
- Изпращането на доклад за проблем става чрез изпращане на съобщение до
+ Разбира се, както при всяко съобщение, трябва да укажете ясена, описателна
-тема ( Разбира се, както при всяко съобщение, трябва да укажете ясна, описателна
+тема ( Ако желаете да изпратите копие на вашия доклад към други получатели
-(например пощенски списъци), не използвайте стандартните e-mail заглавки, а
-методът описан по-долу.Съобщаване за открита грешка в Дебиан с reportbug
+Съобщаване за проблем в Дебиан с reportbug
-Силно препоръчваме да съобщавате за откритите от вас проблеми в Дебиан чрез програмата
reportbug
.reportbug
на командния ред.
Важни неща, които трябва да изнясните преди да изпратите
-доклада за грешка
+Важни неща, които трябва да изясните преди да изпратите
+доклада
-В кой пакет е грешката?
-В кой пакет е проблемът?
+Дали за грешката вече е съобщено?
-Дали за проблема вече е съобщено?
+Изпращане на множество доклади за множество грешки
-Изпращане на множество доклади за множество проблеми
+Не изпращайте доклади за грешки на оригиналните автори
-Не изпращайте доклади за проблеми на оригиналните автори
+Изпращане на доклад за грешка по e-mail
+Изпращане на доклади по имейл
-submit@bugs.debian.org
,
-исползвайки специален формат, описан по-долу. reportbug
(виж по-горе) ще използва правилния формат за съобщенията
-за грешки. Използвайте го!submit@bugs.debian.org
и
+използване на специален формат, описан по-долу. Програмата reportbug
(виж по-горе) ще използва правилния формат за съобщенията.
+Използвайте я!Заглавки
-Subject
) в заглавките на писмото. Темата (subject) ще бъде
-използвана като начално заглавие на доклада за грешката в системата за следене,
-опитайте се да я направите съдържателна.Subject
) в заглавките на писмото. Темата ще бъде
+използвана като начално заглавие на доклада в системата за проследяване.
+Опитайте се да я направите съдържателна.
Първата част на съобщението съдържа псвевдо-заглавки, които съдържат +
Първата част на съобщението съдържа псевдо-заглавки, които съдържат информация за това за кой пакет и версия е доклада. -Псевдо-заглавията трябва да започват от първия ред на съобщението. +Псевдо-заглавките трябва да започват от първия ред на съобщението. Например:
@@ -102,7 +101,7 @@ Package: <име на пакет>
Заместете <име на пакет>
с името
-на пакета, в който е грешката.
Вторият ред на съобщението трябва да бъде:
@@ -111,17 +110,17 @@ Version: <версия на пакета>Заместете <версия на пакета>
с версията на пакета.
-Моля не добавяйте друг текст освен версията, тъй като системата за следене
-на грешки разчита именно на това поле, за да разбере кои издания са
-засегнати от грешката.
За да може системата за следене на грешки да достави съобщението до +
За да може системата за проследяване на проблеми да достави съобщението до
отговорника на пакета е необходимо редът Package
да съдържа
правилно име на пакет. Вижте този пример за
съвет как да откриете тази информация.
За други псевдо-заглавки, вижте Допълнителнои псевдо-заглавки
+href="#additionalpseudoheaders">Допълнителни псевдо-заглавкиВключете в доклада си:
@@ -135,26 +134,26 @@ href="#additionalpseudoheaders">Допълнителнои псевдо-загл покажете това.uname -a
),
-споделена C библиотека (ls -l /lib/*/libc.so.6
или
+споделена C библиотека (изпълнете в терминал ls -l /lib/*/libc.so.6
или
apt show libc6 | grep ^Version
) и всякакви други подробности за
-Вашата система Дебиан, ако е уместно. Например, ако сте имали проблем
+системата, ако сметнете, че са нужни. Например, ако сте имали проблем
със скрипт, писан на Perl, би трябвало да предоставите версията на
-интерпретатора на Perl (perl -v
или dpkg -s perl | grep
+интерпретатора на Perl (изпълнете в терминал perl -v
или dpkg -s perl | grep
^Version:
).
reportbug --template -T none -s none -S normal -b --list-cc
none -q <пакет>
-би бил полезен, тъй като съдържа информация от предоставените от отговорника на
-пакета програми и точна информация за версията.Включете всякаква информация, които смятате за важна. Няма опасност да @@ -163,14 +162,15 @@ href="#additionalpseudoheaders">Допълнителнои псевдо-загл грешката. (Ако са големи и е възможно, обмислете публикуването им на общодостъпен сайт.)
-За повече съвети за това как да помогнете на програмистите да решат проблем, +
За повече съвети за това как да помогнете на програмистите да решат проблема, прочетете документа Ефективно съобщаване за грешки.
-Доклад за грешка със заглавки и превдо-заглавки изглежда подобно:
+Доклад за проблем със заглавки и псевдо-заглавки изглежда по следния начин:
To: submit@bugs.debian.org @@ -197,9 +197,9 @@ href="#additionalpseudoheaders">Допълнителнои псевдо-загл-
Понякога е нужно да се изпрати копие на доклада за грешка до допълнителни +
Понякога е нужно да се изпрати копие на доклада до допълнителни
получатели, освен debian-bugs-dist
и отговорника на пакета,
където обикновено биват изпращани.
Subject
няма да съдържат номера на доклада.
Когато получателите отговорят, много вероятно е да запазят
submit@bugs.debian.org
в заглавките и като резултат съобщението
-им ще отвори нов доклад за грешка. Това води до дублирани доклади.
+им ще отвори нов доклад за проблем. Това води до дублирани доклади.
Правилният начин да изпратите копия е да използвате
-превдо-заглавката X-Debbugs-CC
. Добавете следния ред:
X-Debbugs-CC
. Добавете следния ред към заглавките на
+съобщението:
X-Debbugs-CC: other-list@cosmic.edu-
Това ще инструктира системата за следене на грешки да изпрати копие на доклада до адрес(а/ите) в X-Debbugs-CC
, както и до
+
Това ще инструктира системата за проследяване на проблеми да изпрати копие на
+доклада до адресите, описане в заглавката X-Debbugs-CC
, както и до
debian-bugs-dist
.
За изпращане на копие до повече от един адрес се използва само един ред
X-Debbugs-CC
, като адресите се разделят със запетая.
Избягвайте да изпращате такива копия до адреси на други доклад. Те ще бъдат +
Избягвайте да изпращате такива копия до адреси на други доклади. Те ще бъдат
прихванати от проверките за избягване на зацикляне на писма. Използването на
-X-Debbugs-CC
за тази цел е безмислено, защото номерът на
+X-Debbugs-CC
за тази цел е безсмислено, защото номерът на
доклада все едно ще бъде заместен с номера на новосъздадения доклад.
-Използвайте обикновена CC
заглавка.
CC
заглавка за изпращане на копия до други
+доклади.
Тази функция може често да бъде пълноценно комбинирана с
дискретно
изпращане на писмо (виж по-долу).
Дали докладът е за сравнително сериозна грешка или просто молба за въвеждане на функция, можете да укажете степента на критичност. Това не е задължително. -Отговорникът на пакета ще укаже или промени степента на критичност ако вие +Отговорникът на пакета ще укаже или промени степента на критичност, ако вие го пропуснете или изберете неподходяща степен.
- -За да отбележите критичността на грешката добавете следния ред в +
За да отбележите критичността на проблема, добавете следния ред в псевдо-заглавките:
@@ -253,16 +253,16 @@ Severity: <критичност>Заместете <критичност> с едно от възможните нива, както е описано в -документацията за програмисти.
+документацията за напреднали. -Присвояване на етикети
+Добавяне на етикети
-Можете да поставите етикети в доклада за открита грешка. Например, ако +
Можете да поставите етикети в доклада за открит проблем. Например, ако съобщението включвате кръпка, може да добавите етикета
-patch
. Това не е задължително. Разработчиците ще зададат етикети на доклада когато това е уместно.За да поставите етикети добавете долния ред в +
За да добавите етикети, добавете следния ред в псевдо-заглавките:
@@ -283,45 +283,56 @@ Usertags: <потребителски етикети> потребителски етикети. Разделяйте отделните етикети със запетайки, интервали или и двете. Ако укажете <потребител>, ще бъдат зададени етикетите за въпросния потребител. В противен случай за потребител ще бъде -използван e-mail адреса на подателя. +използван адресът на подателя на съобщението. + +Допуска се поставянето на потребителски етикети за повече от един потребител. +За целта добавете няколко псевдо-заглавки User. Всяка псевдо-заглавка Usertags +указва потребителските етикети за потребителя от последната псевдо-заглавка User. +Това е особено полезно при поставяне на етикети за екип с множество членове, за +няколко екипа или при използване на +потребителските етикети, засягащи различните хардуерни архитектури. +
-Отбелязване на препратени доклади
++User: <first-username> +Usertags: <first-username usertags> +User: <second-username> +Usertags: <second-username usertags> ++Отбелязване на препратени доклади
Forwarded: foo@example.com-ще маркира новоизпратения доклад като препратен към foo@example.com. За +
ще маркира доклада като препратен към foo@example.com. За повече информация прочетете Отчитане на предаването -на доклада за грешка в документацията за разработчици. +на доклада за проблем в документацията за разработчици.
Поемане на отговорност
-Owner: foo@example.com-показва, че foo@example.com вече е отговорен за поправянето на грешката. За -повече информация прочетете Промяна на собственика на доклада за грешка в документацията за разработчици. +показва, че foo@example.com вече е отговорен за отстраняването на проблема. За +повече информация прочетете Промяна на собственика на доклада за проблем в документацията за разработчици.
Указване на пакет-източник
-Source: foopackage-е равносилно на
Package:
за грешки, намиращи се в пакета-източник +е равносилно наPackage:
за проблеми, намиращи се в пакета-източник на foopackage. Използването на тази псевдо-заглавка рядко е необходимо.Вградени команди
--Control: команди +Control: команда@@ -329,7 +340,7 @@ Control: команди
@@ -344,43 +355,40 @@ Control: forwarded -1 https://bugs.debian.org/nnncontrol@bugs.debian.org
при използване наsubmit@bugs.debian.org
илиnnn@bugs.debian.org
. За означаване на текущия доклад (този, създаван с писмото до submit@ или докладът, до който се изпраща допълнителна информация на nnn@) може да използвате „-1“. -Вижте страницита за управляващите команди за +Вижте страницата за управляващите команди за повече информация.-ще променят заглавието на доклада 12345, ще променят нивото му на критичност, +ще променят заглавието на доклад 12345, ще променят нивото му на критичност, описващото съобщение и ще го маркират като препратен.
-Заглавки от вида X-Debbugs-нещо
+ +Заглавки от вида X-Debbugs-нещо
И най-накрая, ако вашата пощенска програма не позволява промяната на заглавките, можете зададете различни заглавки
- - -X-Debbugs-
като псевдо-заглавки.Допълнителна информация
-Различни адреси за изпращане на докладите (за маловажни грешки или грешки, касаещи много пакети)
-Ако дадена грешка е маловажна, например правописна грешка в документацията +
Различни адреси за изпращане на докладите (за маловажни проблеми или за проблеми, засягащи повече от един пакет)
+ +Ако даден проблем е маловажен, например правописна грешка в документацията или тривиален проблем при компилиране, променете критичността и изпратете доклада до
+без копие до пощенските списъци на системата са следене на проблеми. -maintonly@bugs.debian.org
вместо наsubmit@bugs.debian.org
.maintonly
ще препрати доклада само към отговорника на пакета, -без копие до пощенските списъци на системата са следене на грешките.Ако изпращате много доклади наведнъж, трябва да използвате +
Ако изпращате много доклади наведнъж, определено трябва да използвате
- -maintonly@bugs.debian.org
, за да не предизвикате излишен трафик -в пощенските списъци. Преди да изпратите съобщения за множество подобни грешки, +в пощенските списъци. Преди да изпратите съобщения за множество подобни проблеми, може да изпратите резюме доdebian-bugs-dist
.Ако желаете да съобщите за грешка, която вече е изпратен до отговорника, -може да използвате
quiet@bugs.debian.org
. Докладите, изратени до +Ако желаете да съобщите за проблем, който вече е изпратен до отговорника, +може да използвате
- -quiet@bugs.debian.org
. Докладите, изпратени доquiet@bugs.debian.org
няма да бъдат препратени никъде.Когато използвате различни адреси за изпращане, системата за следене на -грешките не настрои заглавката
Reply-To
на всички препратени +Когато използвате различни адреси за изпращане, системата за проследяване на +проблеми ще настрои заглавката
+Reply-To
на всички препратени съобщения така, че отговорите да бъдат обработвани по същия начин както първоначалния доклад. Това означава, че например отговорите доmaintonly
ще отидат при @@ -388,34 +396,33 @@ Control: forwarded -1 https://bugs.debian.org/nnn nnn@bugs.debian.org
, освен ако някой не промени това ръчно.Потвърждения
-Обикновено системата за следене на грешките връща потвърждения при подаване -на доклад за нова грешка или изпращане на допълнителна информация към -съществуващ доклад. Ако искате да потиснете потвържденията, добавете заглавка +
Обикновено системата за проследяване на проблеми връща потвърждения при подаване +на нов доклад или изпращане на допълнителна информация към +съществуващ доклад. Ако искате да предотвратите изпращането на потвържденията, добавете заглавка или псевдо-заглавка
X-Debbugs-No-Ack
в изпращаното съобщение. Ако -използвате тази заглавка при докладване на нова грешка ще се наложи да -проверите за номера на доклата в уеб-страницата на системата за следене на +използвате тази заглавка при изпращане на нов доклад, ще се наложи да +проверите за номера на доклада в уеб-страницата на системата за следене на грешките.Тази заглавка няма да потисне потвържденията от контролния адрес
-control@bugs.debian.org
, защото тези потвърждения може да съдържат съобщения за грешки, на които да трябва да се реагира.Борба с нежелатана поща и липсващи съобщения
+Борба с нежелана поща и липсващи съобщения
-Системата за следене на грешките използва обширна система от правила, +
Системата за проследяван на проблеми използва обширна система от правила, проектирани да спрат нежеланата поща. Въпреки усилията, понякога нормални съобщения са считани за нежелана поща. Ако подозирате, че ваше съобщение е погрешно разпознато като нежелана поща, пишете до
- -owner@bugs.debian.org
за -помощ. Друга честа причина за липсващи съобщения е използването на адреси, +съдействие. Друга честа причина за липсващи съобщения е използването на адреси, които съвпадат със списъка на procmail FROM_DAEMON, който включва адреси от видаmail@foobar.com
. Ако подозирате, че вашият адрес е спрян поради тази причина, проверете procmailrc(5) и изпратете съобщението наново, от адрес, който не е сред адресите във FROM_DAEMON.Съобщения за грешки в неизвестни пакети
Ако системата за следене на грешките не разпознава кой е отговорника на @@ -425,7 +432,7 @@ Control: forwarded -1 https://bugs.debian.org/nnn
Когато изпращате до
@@ -435,7 +442,7 @@ Control: forwarded -1 https://bugs.debian.org/nnnmaintonly@bugs.debian.org
или nnn-maintonly@bugs.debian.org
трябва да сте сигурни, че съобщението е адресирано до правилния пакет, като поставите точната -превдо-заглавкаPackage
в началото на първоначалния доклад +псевдо-заглавкаPackage
в началото на първоначалния доклад или като използвате услугатаcontrol@bugs.debian.org
за да прикачите доклада към правилния пакет.Когато използвате
reportbug
за да докладвате за грешка в някоя команда, напримерgrep
, следната команда автоматично ще избере -правилния пакет и ще Ви даде възможност да опишете проблема веднага: +правилния пакет и ще ви даде възможност да опишете проблема:reportbug --file $(which grep)
Може да откриете кой пакет е инсталирал програмата с командата
-dpkg @@ -443,7 +450,6 @@ Control: forwarded -1 https://bugs.debian.org/nnn
dpkg --list
илиdpkg --status
.Например:
$ which apt-get @@ -451,7 +457,7 @@ $ which apt-get $ type apt-get apt-get is /usr/bin/apt-get $ dpkg --search /usr/bin/apt-get -apt: /usr/bin/apt-get + apt: /usr/bin/apt-get $ dpkg --list apt Desired=Unknown/Install/Remove/Purge/Hold | Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed @@ -489,8 +495,8 @@ Description: Advanced front-end for dpkgИнструментът querybts, наличен от същия пакет като reportbug, -предлага удобен текстово ориентиран интерфейс към системата за следене на -грешките.
+предлага удобен текстово ориентиран интерфейс към системата за проследяване на +проблеми.Потребителите на Emacs могат да се възползват от командата debian-bug, налична в пакета
debian-el
. -- cgit v1.2.3