diff --git a/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml b/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml new file mode 100644 index 0000000000..190efd4f90 --- /dev/null +++ b/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml @@ -0,0 +1,557 @@ +<!-- + The FreeBSD Russian Documentation Project + + $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml,v 1.1 2004/02/06 16:59:32 andy Exp $ + + Original revision: 1.14 +--> + +<!-- + Problem Report Handling Guidelines + The FreeBSD Project - http://www.FreeBSD.org +--> + +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ +<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> +%man; +<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//RU"> +%mailing-lists; +<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN"> +%freebsd; +<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN"> +%trademarks; +<!ENTITY man.edit-pr.1 "<citerefentry/<refentrytitle/edit-pr/<manvolnum/1//"> +<!ENTITY man.query-pr.1 "<citerefentry/<refentrytitle/query-pr/<manvolnum/1//"> +]> + +<article> + <!-- :START of Article Metadata --> + <articleinfo> + <title>������������ �� ������ � ����������� � ���������</title> + + <pubdate>$FreeBSD$</pubdate> + + <legalnotice id="trademarks" role="trademarks"> + &tm-attrib.freebsd; + &tm-attrib.opengroup; + &tm-attrib.general; + </legalnotice> + + <abstract> + <para>��� ����������� ��������� ������������� �������� ��������� + ��������� �� ������� FreeBSD (Problem Reports - PR). ���� ��� + ������������ ������������� ��� ������ ��������� ���� ������ ��������� + � ��������� FreeBSD (PR Database Maintenance Team) + <email>freebsd-bugbusters@FreeBSD.org</email>, �� ������ ��������� ���, + ��� �������� � ����� �����������.</para> + </abstract> + + <authorgroup> + <author> + <firstname>Dag-Erling</firstname> + + <surname>Smørgrav</surname> + </author> + + <author> + <firstname>Hiten</firstname> + + <surname>Pandya</surname> + </author> + </authorgroup> + </articleinfo> + <!-- :END of Article Metadata--> + + <section id="intro"> + <title>��������</title> + + <para>GNATS �������� �������� ���������� ��������������� (����������� �� + �������), ������� ������������ � ������� FreeBSD. ��� ��� ���������� + ������������ �������� ������� � ����������� ����������� ����� ��� + ����������� �������� FreeBSD, ���������� ������������� GNATS ���������� + ��� ����������� �������� �������.</para> + + <para>������ � GNATS ������ ������������� FreeBSD, � ����� ����� �������� + ����������. ��� ����, ����� ������������ ����������� ���� ������ � + �������� ������ � ��������������, ������������ ������������ ��������� + ����� ������� ���������� ����������, �����, ��� ��������� �������, + ��������� ��� �������� �������� � ��� �����.</para> + </section> + + <section id="pr-lifecycle"> + <title>��������� ���� ��������� �� ������</title> + + <itemizedlist> + <listitem> + <para>���������� �������� PR ��� ������ ������� &man.send-pr.1; � + �������� �������������� ���������.</para> + </listitem> + + <listitem> + <para>����������������� ��������� (����) ��������� ������� � PR � + ��������� ��� ������ ����, ��� ������ �������� ������ (����) ������, + ��� ����� ���� � ��������� ��������� ��������� ������ ����, � + ��������� ţ ����.</para> + </listitem> + + <listitem> + <para>���� ����������� � ������������ (��� ���� ��� ��������� ������ + �������������) � �������� ������� ��������� ��������. ����� �� + ������������� ������� � ������� ������, � ��������� PR � ��������� + <quote>analyzed</quote> (����������������).</para> + </listitem> + + <listitem> + <para>���� �������� ��������� ���� � ��������� ����, �������, �� ��� + ������, ������ ���������� ��������, � ����� �������� ţ �������, + ����� ����������� �������������� ���. ����� �� ��������� PR � + ��������� <quote>feedback</quote>.</para> + </listitem> + + <listitem> + <para>����� ��������� ����� �������� ���� � ���������� ��������������� + ������������ ������, � ���� ��������� ��� � ������ + <literal>-CURRENT</literal> (��� ��������������� � + <literal>-STABLE</literal>, ���� ���� �������� � + <literal>-CURRENT</literal> �� �����������), ��� ���� ��� ���������� + ������� � ������������� ��������� �������� ������ �� ��������� � + �������� (� ����� ����������� ����������, ���� �� ��������� ���� ��� + ����� �����), �, ���� ��� �����, ���������� ���ޣ� ��� MFC.</para> + </listitem> + + <listitem> + <para>���� ����� �� ����� ���������� MFC, ���� ��������� PR.</para> + </listitem> + + <listitem> + <para>���� ���� ������� ���������� MFC, ���� ��������� ��������� � + �������� � ��������� <quote>patched</quote> �� ���������� �������� + MFC, � ����� ��������� ���.</para> + </listitem> + </itemizedlist> + + <note> + <para>������ PR ����������� � ����� ������ ��������� ��������, � + ��������� �� ��� ���� ����� ������ ������, ���� �������� �������� + �������� ������, ����� ������� ��������; � ���� ������� ����� ����� + �������� ��� ����������, ��������� ��� ������� ��������. ���� + ��������� �������� �� ����� ���� ������, ��� ��������� �����, + ���������� �������� ������� PR.</para> + </note> + + <note> + <para>����� <quote>����������� �����</quote> ����� ��������� �����������. + � ���� ������ �������� �� PR ������� ������� � ��������� ����������� + (� ��ϣ� ���������) ������������ ������� ����� ����������� �����. + ������ ��� ���������� � ������� ������������� &man.send-pr.1; � + �������� � ����������� ��� ��������������� �������� ��������.</para> + </note> + </section> + + <section id="pr-states"> + <title>��������� ��������� � ���������</title> + + <para>��� ���������� ��������� �������� ����� ����� ��������� ��������� + PR. ��� ��������� ������ � �������� �������� ������� ��������� ������ + ��� PR.</para> + + <example> + <title>��������� ������ ����, ����� ������ ����� ������ + ��������� PR</title> + + <para>����� PR ��������� � ������ � ������������� �����������(�) + ���������ң� ������������ ��������, �� �� �������� �� PR � ������ ��� + ��������� �� <quote>feedback</quote>. � ���� ������ ���������� ������ + ������� ����������� � ����� �������� � ��������, ������������� �� ��� + �����Σ� ������.</para> + </example> + + <para>��������� � �������� ����� ��������� � ����� �� ��������� + ���������:</para> + + <glosslist> + <glossentry> + <glossterm>open</glossterm> + + <glossdef> + <para>��������� ���������; �������� ���� ���������� � ţ ���������� + �����������.</para> + </glossdef> + </glossentry> + + <glossentry> + <glossterm>analyzed</glossterm> + + <glossdef> + <para>�������� ���� �����������, ������ ţ �������.</para> + </glossdef> + </glossentry> + + <glossentry> + <glossterm>feedback</glossterm> + + <glossdef> + <para>���������� ������ ������� �������������� ���������� �� + ����������� ��� ����������; �������� ��������� ���������� � + ������������ �������.</para> + </glossdef> + </glossentry> + + <glossentry> + <glossterm>patched</glossterm> + + <glossdef> + <para>���� ��� ������ӣ� � ������ �������� �������, �� + ���-�� (���������� MFC ���, ��������, ������������� �����������) + �ݣ ��������� ��������.</para> + </glossdef> + </glossentry> + + <glossentry> + <glossterm>suspended</glossterm> + + <glossdef> + <para>������ ��� ��������� ���� ����������� ��-�� ���������� + ���������� ��� ����������� ��������. ��� ������ �������� ��� + ���, ��� ���� ������ ��� ������ ��� ���. ���� �������� ������ �� + ����� ���� ������, ��� ����� �������, � �� ��������������. ������ + �������� ������������ ���������� <quote>suspended</quote> ��� + <quote>�����������</quote> ������������, ������� ������� + ������������ ������, ��� ������� �� � ���� ���� ��� �������.</para> + </glossdef> + </glossentry> + + <glossentry> + <glossterm>closed</glossterm> + + <glossdef> + <para>��������� � �������� ���� �������, ����� ��� ��������� ���� + ����������, ����������������� � ��������������, ���� ����� + ����������� �������� ���� ����������.</para> + </glossdef> + </glossentry> + </glosslist> + + <note> + <para>��������� <quote>patched</quote> �������� ������� � ������������� + ���������, ��� ��� �� ������ ������� ����� � ��������� + <quote>closed</quote>, ���� ���������� �� ����� ��������������� ����, + ���� �� ����� �������� �������� �� ��������.</para> + </note> + </section> + + <section id="pr-types"> + <title>���� ��������� � ���������</title> + + <para>��� ��������� ��������� �� �������, ���� � �������� ������������, + �������� ���������������� ������ � ���� ������ GNATS, ���� � �������� + ������������, ������� ������������� ���� ������ � �������� ���� + ������� � �������, �������������, ����������� ��� ��������� �� ���������, + �� ������ ����� ���� � ����������� ���������� ������ PR.</para> + + <itemizedlist> + <listitem> + <para><link linkend="pr-assigned">PR, ������� ��� ����-�� + ���������.</link></para> + </listitem> + + <listitem> + <para><link linkend="pr-dups">������� ������������ PR.</link></para> + </listitem> + + <listitem> + <para><link linkend="pr-stale">����������� PR</link></para> + </listitem> + + <listitem> + <para><link linkend="pr-misfiled">������������ PR</link></para> + </listitem> + </itemizedlist> + + <para>� ����������� �������� �����������, ��� ���� ������������� �� ��� + ���� ���� PR, ������� ��������� PR � ������ �� ���� �����, � ����� + �������� ����� ������� ������� �� ���� �����.</para> + + <section id="pr-assigned"> + <title>���������� PR</title> + + <para>���� � PR � ����������� ���� <literal>responsible</literal> ������� + ��� ������������ FreeBSD, ��� ������, ��� PR ����� ���� ��������� ��� + ���������� ������.</para> + + <para>��� ����������� PR �� ������ ��������� �����, ����� ����, ���� ��� + �������� ���������. ���� � ��� ���� �����������, �������� ������. + ���� �� �����-�� ������� �� �������, ��� PR ������ �������� ��ϣ + ��������� ��� ţ ���������� ��������� ����-�� �������, ������� + ��������� ����, ��� �������� �������������. ���� ���� ������� �� + ������� � ������� ���� ������, ������� ���������� PR, � ������ + ���������� �� ������ ����������.</para> + </section> + + <section id="pr-dups"> + <title>��������� PR</title> + + <para>���� �� ����������, ��� ���� � ��� �� ������ ����������� ����� ��� + � ����� PR, �������� ��, ��� �������� ������������ ��ߣ� �������� + ���������� � �������� ��� ���������, ޣ��� ������ ����� ����� ������� + PR. ���� ��������� PR �������� ���������������� ����������, ���������� + ��� ����������� ���������� � �����-���� ������, ������� ������ �� + ��������� PR; ����� �������� ������ PR (������� ������ ��������� + ���������).</para> + </section> + + <section id="pr-stale"> + <title>������������ PR</title> + + <para>PR ��������� �������������, ���� ��� �� ���������������� � ������� + ����� ��������. ��� ��������� ������������ PR ����������� ��������� + ���������:</para> + + <itemizedlist> + <listitem> + <para>���� PR ���������� ��������, ����������� ������������� �������� + � ������ <literal>-CURRENT</literal> � <literal>-STABLE</literal>. + ���� ��� ��� �������, �������� ������, ����������� ���� ��������� + � ����������� ����� ����-��, ���� ��� �������� ����� ���������. + ���� ��� ��������, �������� ��������� + �� <quote>analyzed</quote>.</para> + </listitem> + + <listitem> + <para>���� PR ��������� ��������, �������, ��� �� ������, �������� + ����������� ������������� ������������� (������������ ��������� ��� + ���-�� �ݣ), �������� ������, � ������� �������, ��� ����� + ��������� ������ �� ���, � ����� �������� PR � ��������� + <quote>User error</quote> ��� <quote>Configuration + error</quote>.</para> + </listitem> + + <listitem> + <para>���� � PR ����������� ������, �������, ��� �� ������, ���� + ���������� ��� � <literal>-CURRENT</literal>, ��� � + <literal>-STABLE</literal>, �������� ��� � ����������, ����������� + �� ���� ����������� � ������ �����.</para> + </listitem> + + <listitem> + <para>���� PR ��������� ������, �������, �� ����� ������, ���� + ���������� � <literal>-CURRENT</literal>, �� �� � + <literal>-STABLE</literal>, ����������� ��������, ����� �������, + ����������� ��� ������, ��������� ��������� MFC, ���� ���������� + ����� ��� ����� ����-�� �ݣ (�����, ��� ������ �� ����?). �������� + ��������� ��������� �� <quote>feedback</quote> � ������������� ��� + ����-����, ��� ����� ������ MFC.</para> + </listitem> + + <listitem> + <para>� ��������� ������� ��������� � ������ ��������� ��������� + ������������� ����, ��� �������� �ӣ �ݣ ������������ � ����� + �������. ���� ����� �� �������� � ������� ������, �������� PR � + �������� <quote>Feedback timeout</quote>.</para> + </listitem> + </itemizedlist> + </section> + + <section id="pr-misfiled"> + <title>������������� PR</title> + + <para>GNATS ������������� �������� � ������� ����������� ��������� �� + �������. ��� ������ ����� PR ����������� ����� � ��������� + <quote>misfiled</quote>, ���� ���������� ����� ��������� ���� ��� + �ף� ������������ ������ � ��������� ���� PR. ���� ������ ������� + ������������ �������� ��ߣ� ����������� ������������ ��� ������������� + FreeBSD, ������� ����� ������ �� ������� ��� �������� ��������� + ��� PR.</para> + + <para>���� ������� GNATS �� ����� ������, ��� ������ � ���������� �� + ������, ������� �������� ���� ������, ��� ���������� + <literal>gnats-admin</literal> � �������� �������������� �� PR � + �������� ��������� � ��������� <literal>pending</literal>. ������ ��� + PR � ��������� <quote>misfiled</quote> � ��� �� ����� ���������� � + ������� ��������� �� �������, ���� ������ ���-�� ���������� �� �������� + �������� ���� ������������� 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 + 52510 gnats-ad open serious medium Re: lots of sockets in + 52557 gnats-ad open serious medium + 52570 gnats-ad open serious medium Jigdo maintainer update</screen> + + <para>��� �������, PR ����� ������������� ���� ����������� �������������� + �� ����� �� ��������� ������:</para> + + <itemizedlist> + <listitem> + <para>������ �� ������������ PR, ��������� �� ����������� �����, + ����� �������� ������ ��������� <literal>Subject:</literal>.</para> + </listitem> + + <listitem> + <para>��� ���������� ������� &man.send-pr.1; ���������� ����� ������� + ���������� �������� ��� ��������� ��� ������ PR.</para> + </listitem> + + <listitem> + <para>��� �� �������� PR, � �����-�� ��������� ���������, ��������� + �� ����� <email>bug-followup@freebsd.org</email> ��� + <email>freebsd-gnats-submit@freebsd.org</email>.</para> + </listitem> + </itemizedlist> + + <section id="pr-misfiled-followups"> + <title>������� ����������� ��������� ��� ����� PR</title> + + <para>� �������� �������� ��������� ����������� ����������� PR + ��������� ��, � ������� ������� ���� ������, � ������ ��� �� ����� + ���� ������� ����� ������� ������ �� �������������. ��� �� ��������� + PR, ����������� ��������� ������. ����� �� ������ �� �������, + ������� <quote>������������</quote> GNATS �� ������� ��������� + �������� ���������, ����������� ����� �� ������������ PR, �� ���� + ������ ������ ���� ������ � ����� ����:</para> + + <programlisting>Subject: Re: category/number: ������ ����</programlisting> + + <para>����������� �������� ��������, ����� �� ��������� �� ������������ + �������� ��������� � PR, ����� ��������� ����� + <quote><literal>Re: </literal></quote>. ����� + <quote><literal>category/number: </literal></quote> �������� + �����������, ����������� ��� GNATS, ������� �� ������ ���������, + ������� �������� ��� � ���� ������ � ��������.</para> + + <para>��� ������������ FreeBSD, ������� ������ ������ � ���� ������ + GNATS, ����� ��������� ��������� ������� ����� PR � ���������� + ���������������� �� � ������� � ������������� PR (������ ���������� + ������ �� ��������� �� ������ �� ����� + <email>bug-followup@freebsd.org</email>). ����� ����������� + ����������� PR ����� ���� ������� � �������� ����� ����������:</para> + + <programlisting>Your problem report was misfiled. Please use the format +"Subject: category/number: original text" when following +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> + + <screen>&prompt.user; query-pr -q -y "some text"</screen> + + <para>����� ����, ��� �� ���������� ������������ PR � ����������� + ����������� ������ �� ����, �������������� ���������� + <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> + + <programlisting>Followup to ports/45364 misfiled as a new PR. +This was misfiled because the subject didn't have the format: + + Re: ports/45364: ...</programlisting> + + <para>� ���� ������ ����� ����������� ������������ PR ����� �����, + ���� ���������� �������� ��� �������� ������� �� ������������ + PR.</para> + </section> + + <section id="pr-misfiled-format"> + <title>������������ PR � �������������� ������</title> + + <para>�� ������� ���� ����������� ����������� PR ������ ������� ��, + ��� �������� ����������� ������������ �������, ������� �� ��������� + ��� ����������� ���� ��� ��������� ��������������� PR.</para> + + <para>���������� ��� ��������� ������� ����� <quote>category</quote> + ��� <quote>class</quote> ����� �������� � ��������� ������������� + ���������. ������������ ����� ������������ &man.edit-pr.1; ��� ����� + �������� ��������� ��� ������ ���� ����������� ����������� PR �� + ����� ���������� � ��������� PR.</para> + + <para>������ ����������Σ���� �������� ��������� ����������� + ����������� PR �������� ������� ��������������, ������������, + ��������� ��� �������� ������� <command>send-pr</command>, ��� �� + ���� ������������, �������������� ������, ��� � �������� ��������, + ������� ����������� �������� ���� � �������� ���������� �����������. + ��� ���������� �� ���������, � ����� ���� ���������� ���������� + <command>edit-pr</command>; ��� ������� ��������� ������ �� ������� + ������������, ������� ���������� PR, ������ � ����������� ������� + ��� ����� ������� ������������ �����.</para> + </section> + + <section id="pr-misfiled-notpr"> + <title>������������ PR, ������� �� ����� ���� �� �������� ����������� + �� �������</title> + + <para>������ ������������ ������ �������� �� ������ � �������� GNATS + �� ����������� ����� ������� ���������. ������� GNATS �������� � + ����������� �� �������, ������� ������������� ��� ������ ������� + &man.send-pr.1;. ��� �� ����� ������������ ����� ��������� + ����������� �����. ��� ������ ��������� �� �������, ���������� �� + ����� <email>freebsd-gnats-submit@freebsd.org</email>, ������ + ���� ��������� �� ������� ������� <command>send-pr</command>, ���� + ��������� �� ����������� ����� ����� ������� �� &a.bugs;.</para> + + <para>������������, ������� ����� PR, ���������� ���, ����� ��� ������ + ���� ���� ������� � ����� &a.bugs.name; ��� ������-�� ������� + ������ ��������, ������ ������� PR, ��������������� ��� ������ � + ��������� ��������� ��������� � ��������, �� ������� ��� �� �������� + ��������� PR � ���� ������� �������� ���������.</para> + + <para>����������� �����, ������� ���������� GNATS ��� ��ɣ�� + ����������� PR, ����������� � ������������ � FreeBSD, ���������� � + ������ �� Web-�����. ��� ������, ��� ������� ��� �������. ������ + ���� ��������� ��������� ��������� ��������� � GNATS, ������� + ������� �� � ��������� <quote>pending</quote>, ���� ���-������ �� �� + �����������. �������� ������ �� ����� ��������� ��� ������ + &man.edit-pr.1; ������ ����������, ������ ��� GNATS �������� ������, + � ������ ����� ����������� ����-����� ������� �� ������ ���������. + ��� ������� ��������� PR ����� ��������� ��������� � + ������������� ��������.</para> + + <para>�� ������ ������ � ���������� ��������� �������� ������ �����, + ����������� ��� ���������� � ���� ������ GNATS, ���������� �����, + ������������ ��������� <quote>pending</quote>, ������ ����.</para> + + <para>��� ������������, ������� ������ � ������� �������� FreeBSD.org, + ������������ � �������� ����������� ����������� PR � ������������ + �������� ���, ��� �������� �������� ������. ����� �� ���������� + ����� PR, ������ �� ������ ������� � �������� ��������� + <quote><literal>junk</literal></quote>. �������� PR �� �����������, + ��� ��� ������� ��������� ����� � ��� ��������� ���� ��������� �� + ��, ��� �� �� ���������� ��� ��������� ��� ������� �� ���� �������� + ������������.</para> + </section> + </section> + </section> + + <section id="references"> + <title>�������������� ����������</title> + + <para>��� �������� ��������, ����������� � ������������� ��������� � + ��������� ��������� �� �������. ����������, ���� ������ �� �������� + ������.</para> + + <itemizedlist> + <listitem> + <para><ulink + url="../../articles/problem-reports/article.html">��� ������ + ��������� �� ������� FreeBSD</ulink>—����������� ��� ������� + PR.</para> + </listitem> + </itemizedlist> + </section> +</article>