From c440d72e0b9fb65a6c85338b36036134eb9ef453 Mon Sep 17 00:00:00 2001 From: Taras Korenko <taras@FreeBSD.org> Date: Fri, 9 Jul 2010 20:14:08 +0000 Subject: [PATCH] - MFen: article.sgml 1.17 --> 1.32 - reworded a couple of sentences PR: docs/145357 Approved by: maxim (mentor), marck (mentor) --- .../articles/pr-guidelines/article.sgml | 587 +++++++++++++++++- 1 file changed, 560 insertions(+), 27 deletions(-) diff --git a/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml b/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml index 65561bafe1..c2f87558d5 100644 --- a/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml +++ b/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml @@ -3,7 +3,7 @@ $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/pr-guidelines/article.sgml,v 1.4 2005/12/16 20:08:02 gad Exp $ - Original revision: 1.17 + Original revision: 1.32 --> <!-- @@ -67,13 +67,13 @@ <para>������ � GNATS ������ ������������� FreeBSD, � ����� ����� �������� ����������. ��� ����, ����� ������������ ����������� ���� ������ � - �������� ������ � ��������������, ������������ ������������ ��������� - ����� ������� ���������� ����������, �����, ��� ��������� �������, - ��������� ��� �������� �������� � ��� �����.</para> + �������� ������ � ��������������, ���� ���������� ������������, + ����������� ����� ������� ���������� ����������, �����, ��� ��������� + �������, ��������� ��� �������� �������� � ��� �����.</para> </section> <section id="pr-lifecycle"> - <title>��������� ���� ��������� �� ������</title> + <title>��������� ���� ��������� � ��������</title> <itemizedlist> <listitem> @@ -82,7 +82,7 @@ </listitem> <listitem> - <para>����������������� ��������� (����) ��������� ������� � PR � + <para>�������������������� ��������� (����) ��������� ������� � PR � ��������� ��� ������ ����, ��� ������ �������� ������ (����) ������, ��� ����� ���� � ��������� ��������� ��������� ������ ����, � ��������� ţ ����.</para> @@ -96,7 +96,7 @@ </listitem> <listitem> - <para>���� �������� ��������� ���� � ��������� ����, �������, �� ��� + <para>���� �������� ��������� ���� � ��������� ����, �������, �� ��� ������, ������ ���������� ��������, � ����� �������� ţ �������, ����� ����������� �������������� ���. ����� �� ��������� PR � ��������� <quote>feedback</quote>.</para> @@ -108,8 +108,8 @@ <literal>-CURRENT</literal> (��� ��������������� � <literal>-STABLE</literal>, ���� ���� �������� � <literal>-CURRENT</literal> �� �����������), ��� ���� ��� ���������� - �������� � ������������� ��������� �������� ������ �� ��������� � - �������� (� ����� ����������� ����������, ���� �� ��������� ���� ��� + ������� � ������������� ��������� �������� ������ �� ��������� � + �������� (� ����� ����������� ����������, ���� �� ����������� ���� ��� ����� �����), �, ���� ��� �����, ���������� ���ޣ� ��� MFC.</para> </listitem> @@ -215,6 +215,15 @@ </glossdef> </glossentry> + <glossentry> + <glossterm>repocopy</glossterm> + + <glossdef> + <para>������� �������� ������� �� ���������� �������� ����������� + ����������� (���������� �������� ����������� CVS).</para> + </glossdef> + </glossentry> + <glossentry> <glossterm>closed</glossterm> @@ -244,6 +253,11 @@ �� ������ ����� ���� � ����������� ���������� ������ PR.</para> <itemizedlist> + <listitem> + <para><link linkend="pr-unassigned">������ ������������� + PR.</link></para> + </listitem> + <listitem> <para><link linkend="pr-assigned">PR, ������� ��� ����-�� ���������.</link></para> @@ -263,8 +277,491 @@ </itemizedlist> <para>� ����������� �������� �����������, ��� ���� ������������� �� ��� - ���� ���� PR, ������� ��������� PR � ������ �� ���� �����, � ����� - �������� ����� ������� ������� �� ���� �����.</para> + ���� ���� PR, ������� ��������� PR � ������ �� ���� �����, � ����� + ��������� ������� ������ �� ���� �����.</para> + + <section id="pr-unassigned"> + <title>������������� PR</title> + + <para>�� �������� ���������� � ��������� ��������������� ����� + ���������� (generic assignee). ��� ������ ������������ ��������� + <literal>freebsd-</literal>. ������ �������� ���������� (assignee) + ������� �� ��������� � � ����������� ������� ��� ������������� + ������������� ������ �������� &os;. ����� ������� ������� �������� ���������� (assignee), + ������������ � ������� �� ����� � �������:</para> + + <table id=default-assignees-common> + <title>���������� �� ��������� — �������� + �����</title> + <tgroup cols="3"> + <thead> + <row> + <entry>���</entry> + <entry>���������</entry> + <entry>���������� �� ���������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>������� �������</entry> + <entry>bin, conf, gnu, kern, misc</entry> + <entry>freebsd-bugs</entry> + </row> + + <row> + <entry>����������� ��� �����������</entry> + <entry>alpha, amd64, arm, i386, ia64, powerpc, sparc64, + sun4v</entry> + <entry>freebsd-<replaceable>arch</replaceable></entry> + </row> + + <row> + <entry>��������� ������</entry> + <entry>ports</entry> + <entry>freebsd-ports-bugs</entry> + </row> + + <row> + <entry>������������, ������������ � ��������</entry> + <entry>docs</entry> + <entry>freebsd-doc</entry> + </row> + + <row> + <entry>�������� ����� &os; (�� ����������� ������������)</entry> + <entry>www</entry> + <entry>freebsd-www</entry> + </row> + </tbody> + </table> + + <table id=default-assignees-other> + <title>���������� �� ��������� — ���������</title> + + <tgroup cols="3"> + <thead> + <row> + <entry>���</entry> + <entry>���������</entry> + <entry>���������� �� ���������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>� ������ &os; (advocacy efforts)</entry> + <entry>advocacy</entry> + <entry>freebsd-advocacy</entry> + </row> + + <row> + <entry>�������� � &java.virtual.machine;</entry> + <entry>java</entry> + <entry>freebsd-java</entry> + </row> + + <row> + <entry>������������ ����������</entry> + <entry>standards</entry> + <entry>freebsd-standards</entry> + </row> + + <row> + <entry>�������� ����������</entry> + <entry>threads</entry> + <entry>freebsd-threads</entry> + </row> + + <row> + <entry>���������� &man.usb.4;</entry> + <entry>usb</entry> + <entry>freebsd-usb</entry> + </row> + </tbody> + </table> + + <para>�� �����������, ���� ����������, ��� ����� PR �������� ��� + ������������ ���������. ���� �� ��������� ���������, �� �� �������� + ����� ���������� � ����������. (� ���������, ��� ���������� PR + �������� ���������� ������, ��� ���� �������� ��������� �� ������� + � ������������ i386, �� ��� ����� ����� ���� ����� ��� ���� + ���������� &os;, � ������� ����� ���������� ����� ��������� + <literal>kern</literal>. ����������, �������� ����� + �����������).</para> + + <para>���������� ��������� PR ����� ���� �������������� �� ����� ����� + �����, ������� ��������������� ����������. ���������� ��������� ����� + ����������: ������������������ ������ ��������; �������� ������ + (����������� � ������ ����������� ������� ���������������� �����) + � ���������� ��������� �����.</para> + + <para>���� ����������� �������� ������ ��������, ����������, + �������� ��������������, ����������� ������� ����� + (��������, <literal>freebsd-foo</literal> ������ + <literal>foo</literal>); ��������� ����� + ���������, ���������� � ������ ��������, �� ����� �������������.</para> + + <note> + <para>��� ��� ������ ��� ����������� ������������� ��������� + ���������� ��� ��������� ����� PR ���������� �����, �� �������� + ���������� ������ ��� ��� ���������� �������� <ulink + url="http://wiki.freebsd.org/AssigningPRs">FreeBSD wiki</ulink>. + </para> + </note> + + <para>���� �������� (��������, ��������) �������� ����������.</para> + + <table id=common-assignees-base> + <title>����� ���������� — ������� �������</title> + <tgroup cols="4"> + <thead> + <row> + <entry>���</entry> + <entry>�������������� ���������</entry> + <entry>�������������� ����������</entry> + <entry>��� ����������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>��������, ����������� ��� ����������� &arm;</entry> + <entry>arm</entry> + <entry>freebsd-arm</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>��������, ����������� ��� ����������� &mips;</entry> + <entry>kern</entry> + <entry>freebsd-mips</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>��������, ����������� ��� ����������� &powerpc;</entry> + <entry>kern</entry> + <entry>freebsd-ppc</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � Advanced Configuration and Power + Management (&man.acpi.4;)</entry> + <entry>kern</entry> + <entry>freebsd-acpi</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ���������� ATM</entry> + <entry>kern</entry> + <entry>freebsd-atm</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ������������ �������� ��� ����������� + ������������� &os; (��������, + NanoBSD/PicoBSD/FreeBSD-arm)</entry> + <entry>kern</entry> + <entry>freebsd-embedded</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ���������� &firewire;</entry> + <entry>kern</entry> + <entry>freebsd-firewire</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � �������� ���� �������� �������</entry> + <entry>kern</entry> + <entry>freebsd-fs</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ����������� &man.geom.4;</entry> + <entry>kern</entry> + <entry>freebsd-geom</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ����������� &man.ipfw.4;</entry> + <entry>kern</entry> + <entry>freebsd-ipfw</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ���������� ISDN</entry> + <entry>kern</entry> + <entry>freebsd-isdn</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>���������� &man.jail.8;</entry> + <entry>kern</entry> + <entry>freebsd-jail</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ��������� &linux; ��� SVR4</entry> + <entry>kern</entry> + <entry>freebsd-emulation</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ������� ������</entry> + <entry>kern</entry> + <entry>freebsd-net</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ����������� &man.pf.4;</entry> + <entry>kern</entry> + <entry>freebsd-pf</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ����������� &man.scsi.4;</entry> + <entry>kern</entry> + <entry>freebsd-scsi</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � �������� ����������� (&man.sound.4;)</entry> + <entry>kern</entry> + <entry>freebsd-multimedia</entry> + <entry>�����</entry> + </row> + + <row> + <entry>�������� � &man.sysinstall.8;</entry> + <entry>bin</entry> + <entry>freebsd-bugs (<emphasis>not</emphasis> + freebsd-qa)</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ���������� ���������� ��������� + (&man.rc.8;)</entry> + <entry>kern</entry> + <entry>freebsd-rc</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>�������� � ��������� Xen</entry> + <entry>kern</entry> + <entry>xen</entry> + <entry>�����</entry> + </row> + </tbody> + </table> + + <table id=common-assignees-ports> + <title>����� ���������� — ��������� ������</title> + <tgroup cols="4"> + <thead> + <row> + <entry>���</entry> + <entry>�������������� ���������</entry> + <entry>�������������� ����������</entry> + <entry>��� ����������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>�������� � ��������������� ������� ������ + (<emphasis>��</emphasis> � ���������� ������!)</entry> + <entry>ports</entry> + <entry>portmgr</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� apache@FreeBSD.org</entry> + <entry>ports</entry> + <entry>apache</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� autotools@FreeBSD.org</entry> + <entry>ports</entry> + <entry>autotools</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� doceng@FreeBSD.org</entry> + <entry>ports</entry> + <entry>doceng</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� eclipse@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-eclipse</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� gecko@FreeBSD.org</entry> + <entry>ports</entry> + <entry>gecko</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� gnome@FreeBSD.org</entry> + <entry>ports</entry> + <entry>gnome</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� hamradio@FreeBSD.org</entry> + <entry>ports</entry> + <entry>hamradio</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� haskell@FreeBSD.org</entry> + <entry>ports</entry> + <entry>haskell</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� java@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-java</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� kde@FreeBSD.org</entry> + <entry>ports</entry> + <entry>kde</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� mono@FreeBSD.org</entry> + <entry>ports</entry> + <entry>mono</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� + openoffice@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-openoffice</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� perl@FreeBSD.org</entry> + <entry>ports</entry> + <entry>perl</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� python@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-python</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� ruby@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-ruby</entry> + <entry>������ ��������</entry> + </row> + + <row> + <entry>����, � �������� ���������� secteam@FreeBSD.org</entry> + <entry>ports</entry> + <entry>secteam</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� box@FreeBSD.org</entry> + <entry>ports</entry> + <entry>vbox</entry> + <entry>�����</entry> + </row> + + <row> + <entry>����, � �������� ���������� x11@FreeBSD.org</entry> + <entry>ports</entry> + <entry>freebsd-x11</entry> + <entry>������ ��������</entry> + </row> + </tbody> + </table> + + <para>PR ��� ������, � ������� ������������ �������� ��������� �����, + ����� ���� ������������� ����� ����� (������ ������, ��� �� ������ + &os; ��������� � ������������ ������� �������� ����������� ������, + ������� �� �� ������ ������ ������ �� ��������� ������).</para> + + <para>��� ��������� PR, ���������� �� �������������� �� ������ ����� + (�� ����������� ����), ���� �� �� �������, ��� ������� ������������� + ����� �������� ��� ����. ��� ������� �������� ��������, ����� ������� + �������� ������������ ������� ������, ��� ��� ���������������, ��� + ����� ��� ��� ��� ��������.</para> + + <table id=common-assignees-other> + <title>����� ���������� — ���������</title> + <tgroup cols="4"> + <thead> + <row> + <entry>���</entry> + <entry>�������������� ���������</entry> + <entry>�������������� ����������</entry> + <entry>��� ����������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>��������� � ����� GNATS(&man.send-pr.1;)</entry> + <entry>bin</entry> + <entry>bugmeister</entry> + <entry>�����</entry> + </row> + + <row> + <entry>��������� � ��� ����������� GNATS</entry> + <entry>www</entry> + <entry>bugmeister</entry> + <entry>�����</entry> + </row> + </tbody> + </table> + </section> <section id="pr-assigned"> <title>���������� PR</title> @@ -273,7 +770,7 @@ ��� ������������ FreeBSD, ��� ������, ��� PR ����� ���� ��������� ��� ���������� ������.</para> - <para>��� ����������� PR �� ������ ��������� �����, ����� ����, ���� ��� + <para>��� ����������� PR �� ������ ��������� �����, ����� ��������������� GNATS (bugmeister) � ����, ���� ��� �������� ���������. ���� � ��� ���� �����������, �������� ������. ���� �� �����-�� ������� �� �������, ��� PR ������ �������� ��ϣ ��������� ��� ţ ���������� ��������� ����-�� �������, ������� @@ -333,7 +830,7 @@ <literal>-STABLE</literal>, ����������� ��������, ����� �������, ����������� ��� ������, ��������� ��������� MFC, ���� ���������� ����� ��� ����� ����-�� �ݣ (�����, ��� ������ �� ����?). �������� - ��������� ��������� �� <quote>feedback</quote> � ������������� ��� + ��������� ��������� �� <quote>patched</quote> � ������������� ��� ����-����, ��� ����� ������ MFC.</para> </listitem> @@ -383,11 +880,29 @@ ����� �������� ������ ��������� <literal>Subject:</literal>.</para> </listitem> + <listitem> + <para>����� PR �������� ����� (Cc:) � ������ ��������, � ���-������ + ������� �� ���� ���� ������ ���������, ��������������� GNATS. + � �����, ���������� � ������ ��������, ���� ���� ���������/PR�����. + (��� ������ �� ����������� ���������� <emphasis>��</emphasis> + ������ �������� ��������).</para> + </listitem> + <listitem> <para>��� ���������� ������� &man.send-pr.1; ���������� ����� ������� ���������� �������� ��� ��������� ��� ������ PR.</para> </listitem> + <listitem> + <para>��� ���������� ������� &man.send-pr.1; ���������� ��������� + �������� ���� Confidential � <literal>yes</literal>. (��� ��� + �� ��������� ������� ������������� GNATS ��� ������ + <application>cvsup</application>, ���������� � PR-�� �������� + �������������. ���������, ���������� ������������, �� ������� + ����� ����� GNATS, �� ���������� ���������� �� ����� ������� + �������� ������������).</para> + </listitem> + <listitem> <para>��� �� �������� PR, � �����-�� ��������� ���������, ��������� �� ����� <email>bug-followup@FreeBSD.org</email> ��� @@ -419,7 +934,7 @@ GNATS, ����� ��������� ��������� ������� ����� PR � ���������� ���������������� �� � ������� � ������������� PR (������ ���������� ������ �� ��������� �� ������ �� ����� - <email>bug-followup@FreeBSD.org</email>). ����� ����������� + &a.bugfollowup;). ����� ����������� ����������� PR ����� ���� ������� � �������� ����� ����������:</para> <programlisting>Your problem report was misfiled. Please use the format @@ -453,7 +968,7 @@ from the body of this PR to kern/12345</programlisting> �����ģ� �������� ��������� �����:</para> <programlisting>Followup to ports/45364 misfiled as a new PR. -This was misfiled because the subject didn't have the format: +This was misfiled because the subject did not have the format: Re: ports/45364: ...</programlisting> @@ -480,9 +995,9 @@ This was misfiled because the subject didn't have the format: ��������� ��� �������� ������� <command>send-pr</command>, ��� �� ���� ������������, �������������� ������, ��� � �������� ��������, ������� ����������� �������� ���� � �������� ���������� �����������. - ��� ���������� �� ���������, � ����� ���� ���������� ���������� - <command>edit-pr</command>; ��� ������� ��������� ������ �� ������� - ������������, ������� ��������� PR, ������ � ����������� ������� + ��� ������� ��������� � ����� ���� ���������� ���������� + <command>edit-pr</command>, ��� ������� ��������� ������ �� ������� + ������������, ��������������� PR, ������ � ����������� ������� ��� ����� ������� ������������ �����.</para> </section> @@ -507,12 +1022,13 @@ This was misfiled because the subject didn't have the format: <para>����������� �����, ������� ���������� GNATS ��� ��ɣ�� ����������� PR, ����������� � ������������ � FreeBSD, ���������� � - ������ �� Web-�����. ��� ������, ��� ������� ��� �������. ������ - ���� ��������� ��������� ��������� ��������� � GNATS, ������� - ������� �� � ��������� <quote>pending</quote>, ���� ���-������ �� �� + ������ �� Web-�����. ��� ������, ��� ������� ��� �������. + ����-���������, ��������� GNATS, ���������� ������������ � ��������� + <quote>pending</quote> � �������� ��� �� ��� ���, ���� ���-������ + �� �� �����������. �������� ������ �� ����� ��������� ��� ������ &man.edit-pr.1; ������ ����������, ������ ��� GNATS �������� ������, - � ������ ����� ����������� ����-����� ������� �� ������ ���������. + � ����� ����������� ����-����� ������� �� ������ ���������. ��� ������� ��������� PR ����� ��������� ��������� � ������������� ��������.</para> @@ -523,11 +1039,28 @@ This was misfiled because the subject didn't have the format: <para>��� ������������, ������� ������ � ������� �������� FreeBSD.org, ������������ � �������� ����������� ����������� PR � ������������ �������� ���, ��� �������� �������� ������. ����� �� ���������� - ����� PR, ������ �� ������ ������� � �������� ��������� - <quote><literal>junk</literal></quote>. �������� PR �� �����������, - ��� ��� ������� ��������� ����� � ��� ��������� ���� ��������� �� - ��, ��� �� �� ���������� ��� ��������� ��� ������� �� ���� �������� - ������������.</para> + ����� PR, ����������, �������� ���������:</para> + + <itemizedlist> + <listitem> + <para>��������� Category � <literal>junk</literal>.</para> + </listitem> + + <listitem> + <para>���������� Confidential � <literal>no</literal>.</para> + </listitem> + + <listitem> + <para>������� State � <literal>closed</literal>.</para> + </listitem> + </itemizedlist> + + <para>��� PR ��������� junk �� ����������� ��������� �����������, + �������������, ������� ���� ��������� � ��� ��������� ����������, + ��� �� �� ������ ������� �� ��� ������� �������� ������������ �� ���. + ���� �� ������ ���������� �� ��� ����� ���������, ��� �������� + ��� � ������� ����, ��� � �� ���� ������ ����, ������������� + ����� <application>cvsup</application>.</para> </section> </section> </section>