- nothing but formatting was changed
Approved by: maxim (mentor), marck (mentor)
This commit is contained in:
Taras Korenko
parent
c440d72e0b
commit
d856b3c14e
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=35983
1 changed files with 181 additions and 181 deletions
|
|
@ -33,11 +33,11 @@
|
|||
|
||||
<abstract>
|
||||
<para>Это руководство описывает рекомендуемую практику обработки
|
||||
сообщений об ошибках FreeBSD (Problem Reports - PR). Хотя эти
|
||||
рекомендации предназначены для Группы поддержки базы данных сообщений
|
||||
о проблемах FreeBSD (PR Database Maintenance Team)
|
||||
<email>freebsd-bugbusters@FreeBSD.org</email>, им должны следовать все,
|
||||
кто работает с этими сообщениями.</para>
|
||||
сообщений об ошибках FreeBSD (Problem Reports - PR). Хотя эти
|
||||
рекомендации предназначены для Группы поддержки базы данных сообщений
|
||||
о проблемах FreeBSD (PR Database Maintenance Team)
|
||||
<email>freebsd-bugbusters@FreeBSD.org</email>, им должны следовать все,
|
||||
кто работает с этими сообщениями.</para>
|
||||
</abstract>
|
||||
|
||||
<authorgroup>
|
||||
|
|
@ -78,39 +78,39 @@
|
|||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Респондент посылает PR при помощи утилиты &man.send-pr.1; и
|
||||
получает подтверждающее сообщение.</para>
|
||||
получает подтверждающее сообщение.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Среднестатистический коммиттер (Вася) проявляет интерес к PR и
|
||||
назначает его самому себе, или другой любитель ошибок (Петя) решает,
|
||||
что лучше всех с описанной проблемой справится именно Вася, и
|
||||
назначает её Васе.</para>
|
||||
назначает его самому себе, или другой любитель ошибок (Петя) решает,
|
||||
что лучше всех с описанной проблемой справится именно Вася, и
|
||||
назначает её Васе.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Вася связывается с Респондентом (при этом вся переписка должна
|
||||
фиксироваться) и выясняет причину появления проблемы. Затем он
|
||||
документирует причину в журнале аудита, и переводит PR в состояние
|
||||
фиксироваться) и выясняет причину появления проблемы. Затем он
|
||||
документирует причину в журнале аудита, и переводит PR в состояние
|
||||
<quote>analyzed</quote> (проанализировано).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Вася проводит бессонную ночь и выпускает патч, который, по его
|
||||
мнению, решает означенную проблему, и затем посылает её ответом,
|
||||
прося Респондента протестировать его. Затем он переводит PR в
|
||||
состояние <quote>feedback</quote>.</para>
|
||||
мнению, решает означенную проблему, и затем посылает её ответом,
|
||||
прося Респондента протестировать его. Затем он переводит PR в
|
||||
состояние <quote>feedback</quote>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Через несколько таких итераций Вася и Респондент удовлетворяются
|
||||
получающимся патчем, и Вася переносит его в дерево
|
||||
<literal>-CURRENT</literal> (или непосредственно в
|
||||
получающимся патчем, и Вася переносит его в дерево
|
||||
<literal>-CURRENT</literal> (или непосредственно в
|
||||
<literal>-STABLE</literal>, если этой проблемы в
|
||||
<literal>-CURRENT</literal> не наблюдается), при этом при выполнении
|
||||
коммита в сопутствующем сообщении делается ссылка на сообщение о
|
||||
коммита в сопутствующем сообщении делается ссылка на сообщение о
|
||||
проблеме (а также упоминается Респондент, если он предоставил весь или
|
||||
часть патча), и, если это нужно, начинается отсчёт для MFC.</para>
|
||||
часть патча), и, если это нужно, начинается отсчёт для MFC.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
|
|
@ -119,26 +119,26 @@
|
|||
|
||||
<listitem>
|
||||
<para>Если патч требует выполнения MFC, Вася оставляет Сообщение о
|
||||
проблеме в состоянии <quote>patched</quote> до выполнения операции
|
||||
проблеме в состоянии <quote>patched</quote> до выполнения операции
|
||||
MFC, а затем закрывает его.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<note>
|
||||
<para>Многие PR присылаются с очень слабым описанием проблемы, а
|
||||
некоторые из них либо очень сложно решить, либо являются вершиной
|
||||
айсберга другой, более широкой проблемы; в этих случаях очень важно
|
||||
получить всю информацию, требуемую для решения проблемы. Если
|
||||
описанная проблема не может быть решена, или проявится снова,
|
||||
необходимо повторно открыть PR.</para>
|
||||
некоторые из них либо очень сложно решить, либо являются вершиной
|
||||
айсберга другой, более широкой проблемы; в этих случаях очень важно
|
||||
получить всю информацию, требуемую для решения проблемы. Если
|
||||
описанная проблема не может быть решена, или проявится снова,
|
||||
необходимо повторно открыть PR.</para>
|
||||
</note>
|
||||
|
||||
<note>
|
||||
<para>Адрес <quote>электронной почты</quote> может оказаться недоступным.
|
||||
В этом случае ответьте на PR обычным образом и попросите Респондента
|
||||
(в своём сообщении) предоставить рабочий адрес электронной почты.
|
||||
Обычно это происходит в случаях использования &man.send-pr.1; в
|
||||
системах с выключенной или неустановленной почтовой системой.</para>
|
||||
В этом случае ответьте на PR обычным образом и попросите Респондента
|
||||
(в своём сообщении) предоставить рабочий адрес электронной почты.
|
||||
Обычно это происходит в случаях использования &man.send-pr.1; в
|
||||
системах с выключенной или неустановленной почтовой системой.</para>
|
||||
</note>
|
||||
</section>
|
||||
|
||||
|
|
@ -151,13 +151,13 @@
|
|||
|
||||
<example>
|
||||
<title>Маленький пример того, когда именно нужно менять
|
||||
состояние PR</title>
|
||||
состояние PR</title>
|
||||
|
||||
<para>Когда PR находится в работе и ответственный разработчик(и)
|
||||
удовлетворён получающимся решением, то он отвечает на PR и меняет его
|
||||
состояние на <quote>feedback</quote>. В этот момент Респондент должен
|
||||
изучить исправление в своей ситуации и ответить, действительно ли был
|
||||
устранён дефект.</para>
|
||||
удовлетворён получающимся решением, то он отвечает на PR и меняет его
|
||||
состояние на <quote>feedback</quote>. В этот момент Респондент должен
|
||||
изучить исправление в своей ситуации и ответить, действительно ли был
|
||||
устранён дефект.</para>
|
||||
</example>
|
||||
|
||||
<para>Сообщение о проблеме может находится в одном из следующих
|
||||
|
|
@ -169,7 +169,7 @@
|
|||
|
||||
<glossdef>
|
||||
<para>Начальное состояние; проблема была поставлена и её необходимо
|
||||
рассмотреть.</para>
|
||||
рассмотреть.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
|
|
@ -186,8 +186,8 @@
|
|||
|
||||
<glossdef>
|
||||
<para>Дальнейшая работа требует дополнительной информации от
|
||||
Респондента или сообщества; возможно помещение информации о
|
||||
предлагаемом решении.</para>
|
||||
Респондента или сообщества; возможно помещение информации о
|
||||
предлагаемом решении.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
|
|
@ -196,8 +196,8 @@
|
|||
|
||||
<glossdef>
|
||||
<para>Патч был перенесён в дерево исходных текстов, но
|
||||
что-то (выполнение MFC или, возможно, подтверждение Респондента)
|
||||
ещё требуется доделать.</para>
|
||||
что-то (выполнение MFC или, возможно, подтверждение Респондента)
|
||||
ещё требуется доделать.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
|
|
@ -206,12 +206,12 @@
|
|||
|
||||
<glossdef>
|
||||
<para>Работа над проблемой была остановлена из-за отсутствия
|
||||
информации или необходимых ресурсов. Это первый кандидат для
|
||||
тех, кто ищет проект для работы над ним. Если проблема вообще не
|
||||
может быть решена, она будет закрыта, а не приостановлена. Проект
|
||||
создания документации использует <quote>suspended</quote> для
|
||||
<quote>желательных</quote> нововведений, которые требуют
|
||||
значительной работы, для которой ни у кого пока нет времени.</para>
|
||||
информации или необходимых ресурсов. Это первый кандидат для
|
||||
тех, кто ищет проект для работы над ним. Если проблема вообще не
|
||||
может быть решена, она будет закрыта, а не приостановлена. Проект
|
||||
создания документации использует <quote>suspended</quote> для
|
||||
<quote>желательных</quote> нововведений, которые требуют
|
||||
значительной работы, для которой ни у кого пока нет времени.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
|
||||
|
|
@ -229,17 +229,17 @@
|
|||
|
||||
<glossdef>
|
||||
<para>Сообщение о проблеме было закрыто, когда все изменения были
|
||||
перенесены, задокументированы и протестированы, либо когда
|
||||
исправление проблемы было отвергнуто.</para>
|
||||
перенесены, задокументированы и протестированы, либо когда
|
||||
исправление проблемы было отвергнуто.</para>
|
||||
</glossdef>
|
||||
</glossentry>
|
||||
</glosslist>
|
||||
|
||||
<note>
|
||||
<para>Состояние <quote>patched</quote> напрямую связано с предлагаемыми
|
||||
решениями, так что вы можете перейти сразу к состоянию
|
||||
<quote>closed</quote>, если Респондент не может протестировать патч,
|
||||
либо на ваших тестовых прогонах он работает.</para>
|
||||
решениями, так что вы можете перейти сразу к состоянию
|
||||
<quote>closed</quote>, если Респондент не может протестировать патч,
|
||||
либо на ваших тестовых прогонах он работает.</para>
|
||||
</note>
|
||||
</section>
|
||||
|
||||
|
|
@ -260,7 +260,7 @@
|
|||
|
||||
<listitem>
|
||||
<para><link linkend="pr-assigned">PR, которые уже кому-то
|
||||
назначены.</link></para>
|
||||
назначены.</link></para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
|
|
@ -287,8 +287,9 @@
|
|||
назначения (generic assignee). Они всегда предваряются префиксом
|
||||
<literal>freebsd-</literal>. Точное название назначения (assignee)
|
||||
зависит от категории и в большинстве случаев оно соответствует
|
||||
определенному списку рассылки &os;. Далее следует текущий перечень назначений (assignee),
|
||||
составленный в порядке от общих к частным:</para>
|
||||
определенному списку рассылки &os;. Далее следует текущий перечень
|
||||
назначений (assignee), составленный в порядке от общих к
|
||||
частным:</para>
|
||||
|
||||
<table id=default-assignees-common>
|
||||
<title>Назначения по умолчанию — наиболее
|
||||
|
|
@ -395,18 +396,18 @@
|
|||
назначений: специализированные списки рассылки; почтовые алиасы
|
||||
(расширяемые в списки электронных адресов заинтересованных людей)
|
||||
и назначения отдельным лицам.</para>
|
||||
|
||||
|
||||
<para>Если назначением является список рассылки, пожалуйста,
|
||||
выполняя переназначение, используйте длинную форму
|
||||
(например, <literal>freebsd-foo</literal> вместо
|
||||
<literal>foo</literal>); благодаря этому
|
||||
сообщение, посылаемое в список рассылки, не будет дублироваться.</para>
|
||||
<literal>foo</literal>); благодаря этому сообщение, посылаемое
|
||||
в список рассылки, не будет дублироваться.</para>
|
||||
|
||||
<note>
|
||||
<para>Так как список лиц добровольно согласившихся принимать
|
||||
назначения для некоторых типов PR изменяется часто, то наиболее
|
||||
подходящим местом для его размещения является <ulink
|
||||
url="http://wiki.freebsd.org/AssigningPRs">FreeBSD wiki</ulink>.
|
||||
url="http://wiki.freebsd.org/AssigningPRs">FreeBSD wiki</ulink>.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
|
@ -510,7 +511,7 @@
|
|||
<entry>kern</entry>
|
||||
<entry>freebsd-jail</entry>
|
||||
<entry>список рассылки</entry>
|
||||
</row>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>проблема с эмуляцией &linux; или SVR4</entry>
|
||||
|
|
@ -533,7 +534,7 @@
|
|||
<entry>список рассылки</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<row>
|
||||
<entry>проблема с подсистемой &man.scsi.4;</entry>
|
||||
<entry>kern</entry>
|
||||
<entry>freebsd-scsi</entry>
|
||||
|
|
@ -767,78 +768,78 @@
|
|||
<title>Назначение PR</title>
|
||||
|
||||
<para>Если в PR в заполненном поле <literal>responsible</literal> указано
|
||||
имя разработчика FreeBSD, это значит, что PR взята этим человеком для
|
||||
дальнейшей работы.</para>
|
||||
имя разработчика FreeBSD, это значит, что PR взята этим человеком для
|
||||
дальнейшей работы.</para>
|
||||
|
||||
<para>Уже назначенное PR не должно трогаться никем, кроме администраторов GNATS (bugmeister) и того, кому эта
|
||||
проблема назначена. Если у вас есть комментарии, напишите отклик.
|
||||
Если по какой-то причине вы думаете, что PR должна изменить своё
|
||||
состояние или её необходимо назначить кому-то другому, пошлите
|
||||
сообщение тому, кто назначен ответственным. Если этот человек не
|
||||
ответит в течение двух недель, смените назначение PR, а дальше
|
||||
действуйте по своему усмотрению.</para>
|
||||
<para>Уже назначенное PR не должно трогаться никем, кроме администраторов
|
||||
GNATS (bugmeister) и того, кому эта проблема назначена. Если у вас
|
||||
есть комментарии, напишите отклик. Если по какой-то причине вы
|
||||
думаете, что PR должна изменить своё состояние или её необходимо
|
||||
назначить кому-то другому, пошлите сообщение тому, кто назначен
|
||||
ответственным. Если этот человек не ответит в течение двух недель,
|
||||
смените назначение PR, а дальше действуйте по своему усмотрению.</para>
|
||||
</section>
|
||||
|
||||
<section id="pr-dups">
|
||||
<title>Повторные PR</title>
|
||||
|
||||
<para>Если вы обнаружите, что один и тот же вопрос описывается более чем
|
||||
в одном PR, выберите то, что содержит максимальный объём полезной
|
||||
информации и закройте все остальные, чётко указав номер более полного
|
||||
PR. Если несколько PR содержат не пересекающуюся информацию, перенесите
|
||||
всю недостающую информацию в какой-либо отклик, включая ссылки на
|
||||
остальные PR; затем закройте другие PR (которые теперь полностью
|
||||
перекрыты).</para>
|
||||
в одном PR, выберите то, что содержит максимальный объём полезной
|
||||
информации и закройте все остальные, чётко указав номер более полного
|
||||
PR. Если несколько PR содержат не пересекающуюся информацию,
|
||||
перенесите всю недостающую информацию в какой-либо отклик, включая
|
||||
ссылки на остальные PR; затем закройте другие PR (которые теперь
|
||||
полностью перекрыты).</para>
|
||||
</section>
|
||||
|
||||
<section id="pr-stale">
|
||||
<title>Просроченные PR</title>
|
||||
|
||||
<para>PR считается простроченным, если оно не модифицировалось в течение
|
||||
более полугода. При обработке просроченных PR используйте следующую
|
||||
процедуру:</para>
|
||||
более полугода. При обработке просроченных PR используйте следующую
|
||||
процедуру:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Если PR достаточно подробна, попытайтесь воспроизвести проблему
|
||||
в дереве <literal>-CURRENT</literal> и <literal>-STABLE</literal>.
|
||||
Если вам это удалось, напишите отклик, описывающий ваши изыскания
|
||||
и попытайтесь найти кого-то, кому эту проблему можно назначить.
|
||||
Если это подходит, измените состояние
|
||||
на <quote>analyzed</quote>.</para>
|
||||
в дереве <literal>-CURRENT</literal> и <literal>-STABLE</literal>.
|
||||
Если вам это удалось, напишите отклик, описывающий ваши изыскания
|
||||
и попытайтесь найти кого-то, кому эту проблему можно назначить.
|
||||
Если это подходит, измените состояние
|
||||
на <quote>analyzed</quote>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Если PR описывает проблему, которая, как вы знаете, является
|
||||
результатом неправильного использования (некорректная настройка или
|
||||
что-то ещё), напишите отклик, в котором опишите, что автор
|
||||
исходного сделал не так, а затем закройте PR с описанием
|
||||
<quote>User error</quote> или <quote>Configuration
|
||||
результатом неправильного использования (некорректная настройка или
|
||||
что-то ещё), напишите отклик, в котором опишите, что автор
|
||||
исходного сделал не так, а затем закройте PR с описанием
|
||||
<quote>User error</quote> или <quote>Configuration
|
||||
error</quote>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Если в PR описывается ошибка, которая, как вы знаете, была
|
||||
исправлена как в <literal>-CURRENT</literal>, так и
|
||||
исправлена как в <literal>-CURRENT</literal>, так и
|
||||
<literal>-STABLE</literal>, закройте его с сообщением, указывающим
|
||||
на даты исправлений в каждой ветке.</para>
|
||||
на даты исправлений в каждой ветке.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Если PR описывает ошибку, которая, по вашим данным, была
|
||||
исправлена в <literal>-CURRENT</literal>, но не в
|
||||
исправлена в <literal>-CURRENT</literal>, но не в
|
||||
<literal>-STABLE</literal>, попытайтесь выяснить, когда человек,
|
||||
исправивший эту ошибку, планирует выполнить MFC, либо попробуйте
|
||||
найти для этого кого-то ещё (может, это будете вы сами?). Измените
|
||||
состояние сообщения на <quote>patched</quote> и переназначьте его
|
||||
кому-либо, кто будет делать MFC.</para>
|
||||
исправивший эту ошибку, планирует выполнить MFC, либо попробуйте
|
||||
найти для этого кого-то ещё (может, это будете вы сами?). Измените
|
||||
состояние сообщения на <quote>patched</quote> и переназначьте его
|
||||
кому-либо, кто будет делать MFC.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>В остальных случаях запросите у автора исходного сообщения
|
||||
подтверждения того, что проблема всё ещё присутствует в новых
|
||||
версиях. Если автор не отвечает в течение месяца, закройте PR с
|
||||
пометкой <quote>Feedback timeout</quote>.</para>
|
||||
подтверждения того, что проблема всё ещё присутствует в новых
|
||||
версиях. Если автор не отвечает в течение месяца, закройте PR с
|
||||
пометкой <quote>Feedback timeout</quote>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
|
@ -847,23 +848,23 @@
|
|||
<title>Незаполненные PR</title>
|
||||
|
||||
<para>GNATS требовательно подходит к формату присылаемых сообщений об
|
||||
ошибках. Вот почему много PR заканчивают жизнь в состоянии
|
||||
<quote>misfiled</quote>, если посылающий забыл заполнить поле или
|
||||
ввёл неправильные данные в некоторые поля PR. Этот раздел поможет
|
||||
предоставить основной объём необходимых подробностей для разработчиков
|
||||
FreeBSD, который может помочь им закрыть или повторно заполнить
|
||||
эти PR.</para>
|
||||
ошибках. Вот почему много PR заканчивают жизнь в состоянии
|
||||
<quote>misfiled</quote>, если посылающий забыл заполнить поле или
|
||||
ввёл неправильные данные в некоторые поля PR. Этот раздел поможет
|
||||
предоставить основной объём необходимых подробностей для разработчиков
|
||||
FreeBSD, который может помочь им закрыть или повторно заполнить
|
||||
эти PR.</para>
|
||||
|
||||
<para>Если система GNATS не может понять, что делать с сообщением об
|
||||
ошибке, которое достигло базы данных, она определяет
|
||||
<literal>gnats-admin</literal> в качестве ответственного за PR и
|
||||
помещает сообщение в категорию <literal>pending</literal>. Теперь это
|
||||
ошибке, которое достигло базы данных, она определяет
|
||||
<literal>gnats-admin</literal> в качестве ответственного за PR и
|
||||
помещает сообщение в категорию <literal>pending</literal>. Теперь это
|
||||
PR в состоянии <quote>misfiled</quote> и оно не будет появляться в
|
||||
списках сообщений об ошибках, если только кто-то специально не запросит
|
||||
перечень всех незаполненных PR. Если у вас есть доступ к машинам в
|
||||
кластере FreeBSD, можете воспользоваться командой
|
||||
<command>query-pr</command> для просмотра списка PR, которые были
|
||||
некорректно сформированы:</para>
|
||||
списках сообщений об ошибках, если только кто-то специально не запросит
|
||||
перечень всех незаполненных PR. Если у вас есть доступ к машинам в
|
||||
кластере FreeBSD, можете воспользоваться командой
|
||||
<command>query-pr</command> для просмотра списка PR, которые были
|
||||
некорректно сформированы:</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>query-pr -x -q -r gnats-admin</userinput>
|
||||
52458 gnats-ad open serious medium Re: declaration clash f
|
||||
|
|
@ -872,12 +873,12 @@
|
|||
52570 gnats-ad open serious medium Jigdo maintainer update</screen>
|
||||
|
||||
<para>Как правило, PR вроде перечисленных выше оказываются незаполненными
|
||||
по одной из следующих причин:</para>
|
||||
по одной из следующих причин:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<listitem>
|
||||
<para>Отклик на существующее PR, посланный по электронной почте,
|
||||
имеет неверный формат заголовка <literal>Subject:</literal>.</para>
|
||||
имеет неверный формат заголовка <literal>Subject:</literal>.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
|
|
@ -890,7 +891,7 @@
|
|||
|
||||
<listitem>
|
||||
<para>При заполнении шаблона &man.send-pr.1; посылающий забыл указать
|
||||
правильное значение для категории или класса PR.</para>
|
||||
правильное значение для категории или класса PR.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
|
|
@ -905,7 +906,7 @@
|
|||
|
||||
<listitem>
|
||||
<para>Это не реальное PR, а какое-то случайное сообщение, посланное
|
||||
на адрес <email>bug-followup@FreeBSD.org</email> или
|
||||
на адрес <email>bug-followup@FreeBSD.org</email> или
|
||||
<email>freebsd-gnats-submit@FreeBSD.org</email>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
|
@ -914,28 +915,28 @@
|
|||
<title>Отклики неправильно оформлены как новые PR</title>
|
||||
|
||||
<para>К наиболее массовой категории неправильно оформленных PR
|
||||
относятся те, у которых неверна тема письма, и именно они на самом
|
||||
деле требует самых больших усилий от разработчиков. Это не настоящие
|
||||
PR, описывающие отдельные ошибки. Когда по одному из адресов,
|
||||
который <quote>прослушивает</quote> GNATS на предмет обработки
|
||||
входящих сообщений, принимается ответ на существующее PR, то тема
|
||||
ответа должна быть всегда в таком виде:</para>
|
||||
относятся те, у которых неверна тема письма, и именно они на самом
|
||||
деле требует самых больших усилий от разработчиков. Это не настоящие
|
||||
PR, описывающие отдельные ошибки. Когда по одному из адресов,
|
||||
который <quote>прослушивает</quote> GNATS на предмет обработки
|
||||
входящих сообщений, принимается ответ на существующее PR, то тема
|
||||
ответа должна быть всегда в таком виде:</para>
|
||||
|
||||
<programlisting>Subject: Re: category/number: старая тема</programlisting>
|
||||
|
||||
<para>Большинство почтовых программ, когда вы отвечаете на оригинальное
|
||||
почтовое сообщение с PR, будут добавлять часть
|
||||
почтовое сообщение с PR, будут добавлять часть
|
||||
<quote><literal>Re: </literal></quote>. Часть
|
||||
<quote><literal>category/number: </literal></quote> является
|
||||
соглашением, специфичным для GNATS, которое вы должны выполнить,
|
||||
вручную поставив его в тему письма с откликом.</para>
|
||||
соглашением, специфичным для GNATS, которое вы должны выполнить,
|
||||
вручную поставив его в тему письма с откликом.</para>
|
||||
|
||||
<para>Все разработчики FreeBSD, имеющие прямой доступ к базе данных
|
||||
GNATS, могут регулярно проверять наличие таких PR и перемещать
|
||||
заинтересовавшие их в отклики к оригинальному PR (послав корректный
|
||||
отклик на сообщение об ошибке на адрес
|
||||
&a.bugfollowup;). Затем неправильно
|
||||
оформленное PR может быть закрыто с примерно таким пояснением:</para>
|
||||
GNATS, могут регулярно проверять наличие таких PR и перемещать
|
||||
заинтересовавшие их в отклики к оригинальному PR (послав корректный
|
||||
отклик на сообщение об ошибке на адрес
|
||||
&a.bugfollowup;). Затем неправильно
|
||||
оформленное PR может быть закрыто с примерно таким пояснением:</para>
|
||||
|
||||
<programlisting>Your problem report was misfiled. Please use the format
|
||||
"Subject: category/number: original text" when following
|
||||
|
|
@ -943,29 +944,29 @@ up to older, existing PRs. I've added the relevant bits
|
|||
from the body of this PR to kern/12345</programlisting>
|
||||
|
||||
<para>Поиск по команде <command>query-pr</command> оригинального PR,
|
||||
на которое отвечает неправильно оформленный отклик, легко выполняется
|
||||
следующим образом:</para>
|
||||
на которое отвечает неправильно оформленный отклик, легко выполняется
|
||||
следующим образом:</para>
|
||||
|
||||
<screen>&prompt.user; query-pr -q -y "some text"</screen>
|
||||
|
||||
<para>После того, как вы обнаружили оригинальное PR и неправильно
|
||||
оформленный отклик на него, воспользуйтесь параметром
|
||||
<option>-F</option> команды <command>query-pr</command> для
|
||||
сохранения полного текста всех относящихся к делу PR в файле формата
|
||||
почтового ящика &unix;, то есть:</para>
|
||||
оформленный отклик на него, воспользуйтесь параметром
|
||||
<option>-F</option> команды <command>query-pr</command> для
|
||||
сохранения полного текста всех относящихся к делу PR в файле формата
|
||||
почтового ящика &unix;, то есть:</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>query-pr -F 52458 52474 > mbox</userinput></screen>
|
||||
|
||||
<para>Теперь вы можете использовать любую почтовую программу для
|
||||
просмотра всех PR, которые вы сохранили в файле
|
||||
<filename>mbox</filename>. Скопируйте текст всех неверно оформленных
|
||||
PR в отклике на оригинальное сообщение о проблеме, и обязательно
|
||||
включите правильный заголовок <literal>Subject:</literal>. После
|
||||
этого закройте неверно оформленное PR. Когда вы закрываете такие PR,
|
||||
помните, что автор получает оповещение по почте о том, что его PR
|
||||
сменило состояние на <quote>closed</quote>. В пояснении обязательно
|
||||
описывайте в подробностях, почему это состояние изменилось. Обычно
|
||||
подойдёт примерно следующий текст:</para>
|
||||
просмотра всех PR, которые вы сохранили в файле
|
||||
<filename>mbox</filename>. Скопируйте текст всех неверно оформленных
|
||||
PR в отклике на оригинальное сообщение о проблеме, и обязательно
|
||||
включите правильный заголовок <literal>Subject:</literal>. После
|
||||
этого закройте неверно оформленное PR. Когда вы закрываете такие PR,
|
||||
помните, что автор получает оповещение по почте о том, что его PR
|
||||
сменило состояние на <quote>closed</quote>. В пояснении обязательно
|
||||
описывайте в подробностях, почему это состояние изменилось. Обычно
|
||||
подойдёт примерно следующий текст:</para>
|
||||
|
||||
<programlisting>Followup to ports/45364 misfiled as a new PR.
|
||||
This was misfiled because the subject did not have the format:
|
||||
|
|
@ -973,73 +974,72 @@ This was misfiled because the subject did not have the format:
|
|||
Re: ports/45364: ...</programlisting>
|
||||
|
||||
<para>В этом случае автор неправильно оформленного PR будет знать,
|
||||
чего необходимо избегать при отправке отклика на существующее
|
||||
PR.</para>
|
||||
чего необходимо избегать при отправке отклика на существующее
|
||||
PR.</para>
|
||||
</section>
|
||||
|
||||
<section id="pr-misfiled-format">
|
||||
<title>Некорректные PR с отсутствующими полями</title>
|
||||
|
||||
<para>Ко второму типу неправильно оформленных PR обычно относят те,
|
||||
что являются результатом забывчивости авторов, которые не заполнили
|
||||
все необходимые поля при написании первоначального PR.</para>
|
||||
что являются результатом забывчивости авторов, которые не заполнили
|
||||
все необходимые поля при написании первоначального PR.</para>
|
||||
|
||||
<para>Отсутствие или ошибочное задание полей <quote>category</quote>
|
||||
или <quote>class</quote> может привести к появлению некорректного
|
||||
сообщения. Разработчики могут использовать &man.edit-pr.1; для смены
|
||||
значений категории или класса этих неправильно оформленных PR на
|
||||
более подходящие и сохранить PR.</para>
|
||||
или <quote>class</quote> может привести к появлению некорректного
|
||||
сообщения. Разработчики могут использовать &man.edit-pr.1; для смены
|
||||
значений категории или класса этих неправильно оформленных PR на
|
||||
более подходящие и сохранить PR.</para>
|
||||
|
||||
<para>Другой распространённой причиной появления неправильно
|
||||
оформленных PR являются вопросы форматирования, квотирование,
|
||||
изменение или удаление шаблона <command>send-pr</command>, как по
|
||||
вине пользователя, редактирующего шаблон, так и почтовых программ,
|
||||
которые проделывают странные вещи с обычными текстовыми сообщениями.
|
||||
оформленных PR являются вопросы форматирования, квотирование,
|
||||
изменение или удаление шаблона <command>send-pr</command>, как по
|
||||
вине пользователя, редактирующего шаблон, так и почтовых программ,
|
||||
которые проделывают странные вещи с обычными текстовыми сообщениями.
|
||||
Это изредка случается и может быть исправлено программой
|
||||
<command>edit-pr</command>, что требует некоторых усилий со стороны
|
||||
разработчика, корректирующего PR, однако в большинстве случаев
|
||||
это можно сделать относительно легко.</para>
|
||||
это можно сделать относительно легко.</para>
|
||||
</section>
|
||||
|
||||
<section id="pr-misfiled-notpr">
|
||||
<title>Неправильные PR, которые на самом деле не являются сообщениями
|
||||
об ошибках</title>
|
||||
об ошибках</title>
|
||||
|
||||
<para>Иногда пользователь желает сообщить об ошибке и посылает GNATS
|
||||
по электронной почте обычное сообщение. Скрипты GNATS работает с
|
||||
сообщениями об ошибках, которые форматированы при помощи шаблона
|
||||
по электронной почте обычное сообщение. Скрипты GNATS работает с
|
||||
сообщениями об ошибках, которые форматированы при помощи шаблона
|
||||
&man.send-pr.1;. Они не могут обрабатывать любые сообщения
|
||||
электронной почты. Вот почему сообщения об ошибках, посылаемые на
|
||||
адрес <email>freebsd-gnats-submit@FreeBSD.org</email>, должны
|
||||
быть оформлены по шаблону команды <command>send-pr</command>, хотя
|
||||
сообщения по электронной почте можно послать на &a.bugs;.</para>
|
||||
электронной почты. Вот почему сообщения об ошибках, посылаемые на
|
||||
адрес <email>freebsd-gnats-submit@FreeBSD.org</email>, должны
|
||||
быть оформлены по шаблону команды <command>send-pr</command>, хотя
|
||||
сообщения по электронной почте можно послать на &a.bugs;.</para>
|
||||
|
||||
<para>Разработчики, которые видят PR, выглядящие так, будто они должны
|
||||
были быть посланы в адрес &a.bugs.name; или какого-то другого
|
||||
списка рассылки, должны закрыть PR, проинформировав его автора в
|
||||
протоколе изменения состояния о причинах, по которых это не является
|
||||
настоящим PR и куда следует посылать сообщения.</para>
|
||||
были быть посланы в адрес &a.bugs.name; или какого-то другого
|
||||
списка рассылки, должны закрыть PR, проинформировав его автора в
|
||||
протоколе изменения состояния о причинах, по которых это не является
|
||||
настоящим PR и куда следует посылать сообщения.</para>
|
||||
|
||||
<para>Электронный адрес, который использует GNATS для приёма
|
||||
поступающих PR, опубликован в документации к FreeBSD, объявлялся и
|
||||
поступающих PR, опубликован в документации к FreeBSD, объявлялся и
|
||||
указан на Web-сайте. Это значит, что спамеры его увидели.
|
||||
Спам-сообщения, достигшие GNATS, немедленно определяются в категорию
|
||||
<quote>pending</quote> и остаются там до тех пор, пока кто-нибудь
|
||||
их не
|
||||
пересмотрит. Закрытие любого из таких сообщений при помощи
|
||||
&man.edit-pr.1; весьма раздражает, потому что GNATS отвечает автору,
|
||||
их не пересмотрит. Закрытие любого из таких сообщений при помощи
|
||||
&man.edit-pr.1; весьма раздражает, потому что GNATS отвечает автору,
|
||||
а адрес отправителя спам-почты никогда не бывает настоящим.
|
||||
Для каждого закрытого PR будут приходить сообщения о
|
||||
невозможности доставки.</para>
|
||||
Для каждого закрытого PR будут приходить сообщения о
|
||||
невозможности доставки.</para>
|
||||
|
||||
<para>На данный момент с установкой некоторых фильтров против спама,
|
||||
проверяющих все добавления в базу данных GNATS, количество спама,
|
||||
достигающего состояния <quote>pending</quote>, весьма мало.</para>
|
||||
проверяющих все добавления в базу данных GNATS, количество спама,
|
||||
достигающего состояния <quote>pending</quote>, весьма мало.</para>
|
||||
|
||||
<para>Все разработчики, имеющие доступ к машинам кластера FreeBSD.org,
|
||||
приглашаются к проверке неправильно оформленных PR и немедленному
|
||||
закрытию тех, что являются почтовым спамом. Когда вы закрываете
|
||||
такое PR, пожалуйста, сделайте следующее:</para>
|
||||
приглашаются к проверке неправильно оформленных PR и немедленному
|
||||
закрытию тех, что являются почтовым спамом. Когда вы закрываете
|
||||
такое PR, пожалуйста, сделайте следующее:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
|
|
@ -1074,10 +1074,10 @@ This was misfiled because the subject did not have the format:
|
|||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink
|
||||
url="&url.articles.problem-reports;/article.html">Как писать
|
||||
Сообщения об ошибках FreeBSD</ulink>—руководство для авторов
|
||||
PR.</para>
|
||||
<para><ulink
|
||||
url="&url.articles.problem-reports;/article.html">Как писать
|
||||
Сообщения об ошибках FreeBSD</ulink>—руководство для авторов
|
||||
PR.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
|
|
|
|||
Loading…
Reference in a new issue