diff --git a/ru_RU.KOI8-R/articles/Makefile b/ru_RU.KOI8-R/articles/Makefile index 5ac51a3c33..c237eb5971 100644 --- a/ru_RU.KOI8-R/articles/Makefile +++ b/ru_RU.KOI8-R/articles/Makefile @@ -10,7 +10,7 @@ SUBDIR = SUBDIR+= 5-roadmap SUBDIR+= checkpoint -#SUBDIR+= committers-guide +SUBDIR+= committers-guide SUBDIR+= console-server #SUBDIR+= contributing #SUBDIR+= contributors diff --git a/ru_RU.KOI8-R/articles/committers-guide/Makefile b/ru_RU.KOI8-R/articles/committers-guide/Makefile new file mode 100644 index 0000000000..226144ce99 --- /dev/null +++ b/ru_RU.KOI8-R/articles/committers-guide/Makefile @@ -0,0 +1,25 @@ +# +# The FreeBSD Russian Documentation Project +# +# $FreeBSD$ +# $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/committers-guide/Makefile,v 1.2 2004/09/21 08:24:32 marck Exp $ +# +# Original revision: 1.10 +# +# Article: The FreeBSD Committers Guide + + +DOC?= article + +FORMATS?= html +WITH_ARTICLE_TOC?= YES + +INSTALL_COMPRESSED?= gz +INSTALL_ONLY_COMPRESSED?= + +SRCS= article.sgml + +URL_RELPREFIX?= ../../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. + +.include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/ru_RU.KOI8-R/articles/committers-guide/article.sgml b/ru_RU.KOI8-R/articles/committers-guide/article.sgml new file mode 100644 index 0000000000..4d74e6395a --- /dev/null +++ b/ru_RU.KOI8-R/articles/committers-guide/article.sgml @@ -0,0 +1,3157 @@ +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ +<!-- + The FreeBSD Russian Documentation Project + + $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/committers-guide/article.sgml,v 1.9 2004/09/21 13:54:37 den Exp $ + + Original revision: 1.213 +--> + +<!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN"> +%articles.ent; +]> + +<article lang="ru"> + <articleinfo> + <title>���������� ����������</title> + + <authorgroup> + <author> + <surname>The FreeBSD Documentation Project</surname> + </author> + </authorgroup> + + <pubdate>$FreeBSD$</pubdate> + + <copyright> + <year>1999</year> + <year>2000</year> + <year>2001</year> + <year>2002</year> + <year>2003</year> + <year>2004</year> + <holder>The FreeBSD Documentation Project</holder> + </copyright> + + <legalnotice id="trademarks" role="trademarks"> + &tm-attrib.freebsd; + &tm-attrib.cvsup; + &tm-attrib.ibm; + &tm-attrib.intel; + &tm-attrib.sparc; + &tm-attrib.general; + </legalnotice> + + <abstract> + <para>������ �������� �������� ���������� ��� ���������� ����������� + FreeBSD. ��� ����� ���������� ������ ������� ��� ����� ������� ������; + ������ ����������� ����� ������������� ����� �� ������� ������������� + ���.</para> + </abstract> + </articleinfo> + + <sect1 id="admin"> + <title>���������������� ������</title> + + <informaltable frame="none" orient="port"> + <tgroup cols="2"> + <tbody> + <row> + <entry><emphasis>���� ��������� �����������</emphasis></entry> + <entry><hostid role="fqdn">ncvs.FreeBSD.org</hostid></entry> + </row> + + <row> + <entry><emphasis>������ �����������</emphasis></entry> + <entry>&man.ssh.1;, ������ �������� 2</entry> + </row> + + <row> + <entry><emphasis>�������� ������ ����������� (CVSROOT)</emphasis></entry> + <entry> + <hostid role="fqdn">ncvs.FreeBSD.org</hostid><literal>:</literal><filename>/home/ncvs</filename> (��. ����� <xref linkend="cvs.operations">). + </entry> + </row> + + <row> + <entry><emphasis>&a.cvsadm;</emphasis></entry> + <entry>&a.peter; � &a.markm;, � ����� &a.joe; � &a.marcus; ��� + �������� <filename>ports/</filename></entry> + </row> + + <row> + <entry><emphasis>������ ��������</emphasis></entry> + <entry>&a.doc-developers;, &a.doc-committers;; + &a.ports-developers;, &a.ports-committers;; + &a.src-developers;, &a.src-committers;. (������� ����������� + ������� ������������� ��������� ������ �������� � ���������� + -developers � -committers. ������ ���� ������� �������� � ������ + <filename>/home/mail/<replaceable>repository-name</replaceable>-developers-archive</filename> + � + <filename>/home/mail/<replaceable>repository-name</replaceable>-committers-archive</filename> + �� ������� �������� <hostid role="domainname">FreeBSD.org</hostid>). + </entry> + </row> + + + <row> + <entry><emphasis>������ ���������</emphasis></entry> + <entry><filename>/home/core/public/monthly-report</filename> + �� ������� �������� <hostid role="domainname">FreeBSD.org</hostid>. + </entry> + </row> + + <row> + <entry><emphasis>�������� �������� ����� CVS</emphasis></entry> + <entry><literal>RELENG_4</literal> (����� 4.X-STABLE), + <literal>HEAD</literal> (����� -CURRENT)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>��� ����������� �� ������ ������� �� ������ ������������ ��������� + &man.ssh.1; ��� &man.telnet.1; � ���������� Kerberos 5. � ������ + &man.ssh.1;, �������� ������ �������� ������ 2. + ��� ��������� �������� ����������� ����� ����������� �� ��������� � + &man.telnet.1; ��� &man.rlogin.1;, ��������� ���������� �� ����������� + ���������� � ������������� ����. �� ���������, �������� &man.ssh.1; + ����� ������� ���� ������. �������� ������� ����� ������, ��� + &man.ssh-agent.1; � &man.scp.1;, �������� &man.ssh.1; ����������� + ������� ������ � �������������. ���� �� ������ �� ������ �� &man.ssh.1;, + ��������� � ������ <xref linkend="ssh.guide">.</para> + </sect1> + + <sect1 id="committer.types"> + <title>���� ������ �����</title> + + <para>CVS ����������� FreeBSD ������� �� ���������� ��������, ������������ + �������� ������ ������� ������������ �������, ������������, �������������� + ���������� ������� ���������� (������), � ����� ��������� ��������� + �������. ����� ������ � ����������� (<quote>������ ���</quote>) + ������������� �������� ������� ������, � ������� ��� ����� ���� ���������. + ��� �������, ������� �������� ������� � �������, ������������� ����� + ���������� �� ���. � ����������, ������� �������� ������ ���� + ����� ���� ���������; � ���� ������, ��������� ������ ��������� + ����������� �������� ������ ��� ���������� � ������ �������, � ���������, + ������� ������������� �� ������ ������ �, ��������, � ������� ������-�� + ������� ������ � ��������.</para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry><emphasis>��� ������ ����</emphasis></entry> + <entry><emphasis>�������������</emphasis></entry> + <entry><emphasis>������� �����������</emphasis></entry> + </row> + + <row> + <entry>src</entry> + <entry>core@</entry> + <entry>src/ � ��������������� ����� doc/</entry> + </row> + + <row> + <entry>doc</entry> + <entry>doceng@</entry> + <entry>doc/, www/, ������������ ������ src/</entry> + </row> + + <row> + <entry>ports</entry> + <entry>portmgr@</entry> + <entry>ports/</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>����, ���������� �� ���������� ������ �� ������� ����� �������������� + �� ���� ������ ������. ������, � ����� ������ �������� ������, ���������, + �� ������� ����� ������ � �����-���� ����� ������, ������ ������������� + ������������ ��������� ��� ������������ ������� ������������, �������� + ������������� �� ������������� �� ��������� ����� �����������, � �����, + ��������, �������� ��������� � ��������. ��������� ������� ������� + ��������� �������� ���� �����������, ��������� ����� ������ ���������� + �� ����� ����������, �� �������� ������������ ����� ������ � ������ + �������.</para> + + <para>��� ����������� �� ������� ���������� ������, ������� ����������� + �� ������������ ������������ ��������� � �������� ���������� ����� + ������ ����������������.</para> + + <sect2> + <title>������� ��� ����������� ������������ (<filename>doc/</filename>) + ��� ������ � ������� �������� ������� + (<filename>src/</filename>)</title> + + <itemizedlist> + <listitem><para>���������� ������������ ����� �������������� �������� + ������������ � �������� �������, ��������, �������� �����������, ����� + README, ���� ������ ������� fortune, ����������, � ����� ���������� + ����������� � �������� ������� ��� ��������������� ������������ � + ������������ �������� �������, ��� ������� ���������� �������� ������ + � ������ ��������.</para></listitem> + + <listitem><para>���������� ������������ ����� ������� �������������� + ��������� � ����������� � �������� ������ (����� ��� ����������� � + �������� ������, ���������� ����� �������������� ������������ � �.�.) + ��� ������� ��������� �� ���������� �������� + �������.</para></listitem> + + <listitem><para>��������� ������������ ����� ��������� ������� �������� + ������ ���� �� ������� �������� ������� (� �����, ����� �������, + ����������� �������� �������), ����� ���� �������, ������� ��������� + ��� ���������� ��������� (Core). ����� ���������, ������ � ��� ������ + ������������ �������� � ���� 'access', � ����������� ������� ������� + ������� ������ � ��������, ��������������� ��������� ��������� �� + ������ ������.</para></listitem> + + <listitem><para>��������� ������� ("Approved by") ����� ������������� + ������ "�����������" (�� ���������� � ��������) ����������� �������� + �������; ��������� ����� ������������� ������������ ��������� � + ����������� � ������ "Reviewed by".</para></listitem> + </itemizedlist> + </sect2> + + </sect1> + + <sect1 id="cvs.operations"> + <title>������ � CVS</title> + + <para>���������������, ��� �� ��� ������ ���� ������� ������ � CVS.</para> + + <para>&a.cvsadm; �������� <quote>�����������</quote> ����������� CVS � + ������������ �� ��� ������ ��� ��������� (� ����� ������ ��� ����������� + �����-���� �������� ������ ����������� ��� ������ � CVS). ���� � + ���������� ����� �������� � ������ ����������� ��������� ���������� + ������, ��������, ����� �������� �������� <command>cvs import</command> + ��� <command>cvs tag</command>, ������� ������ ��������������� ��������� + &a.cvsadm; (��. ��������� �������) � �������� � ��������. � �������� + ��������� �������, ���������� �� ������ �����-���� ����� �����������, � + ������ CVS � �����, �� ������ �������� &a.cvsadm;. ����������, + <emphasis>�� ����</emphasis> ������ ������ &a.cvsadm; �� ������ + ������������� ����������� � ������ ��������, ������� ����� ������ + ��������������� ���������.</para> + + <para>�������� �������� ���������� ����������� ����� ������ ������ + CVS-��������; ��� ����������� �����, ������ CVS-������� ����� ������� + ������ �� �������, �������������� �������� �����������.</para> + + <note><para>������, �� ������� ������� �������� �������, ������� �� ������� + �����������, ������� ��������� ���������:</para> + + <itemizedlist> + <listitem><para>ncvs@ - ����������� <filename role="directory"> + /home/ncvs</filename>, �������� �������� ������ + </para></listitem> + + <listitem><para>pcvs@ - ����������� <filename role="directory"> + /home/pcvs</filename>, �����</para></listitem> + + <listitem><para>dcvs@ - ����������� <filename role="directory"> + /home/dcvs</filename>, ������������</para></listitem> + + <listitem><para>projcvs@ - ����������� <filename role="directory"> + /home/projcvs</filename>, ������ �������</para></listitem> + </itemizedlist> + </note> + + <para>������ CVS � ��������� ����� ��������� �� ������ ����������� + �����������: <literal>doc</literal>, <literal>ports</literal>, + <literal>projects</literal> � <literal>src</literal>. ��� �������� + ������ ������������� ��� ��������������� ����� + <application>CVSup</application> ��������� ������� ������������� � + ����, � ����� ��������� ��������� <literal>CVSROOT</literal>.</para> + + <note><para>�������� ��������, ��� ������ <literal>www</literal>, ���������� + �������� ������ + <ulink url="http://www.FreeBSD.org">���-����� FreeBSD</ulink>, ���������� + � ����������� <literal>doc</literal>.</para></note> + + <para>� ��������� �����, ��� ����������� CVS ������������� �� ����� ������, + <hostid role="hostname">ncvs.FreeBSD.org</hostid>, ������, ��� ����������� + ����������� � ������� �������� �� �� ��������� ��������� �������, ��� + ������ �������������� ��������� ��� �����. �� � ������� ������������ + �����������. �������, ������ ����������� ���������� � ��������� ��������. + � �����, ����� ������� �������� ���:</para> + + <table frame="none" id="cvs-repositories-and-hosts"> + <title>����������� CVS &os;, ����� � ��������</title> + + <tgroup cols="3"> + <thead> + <row> + <entry>�����������</entry> + <entry>����</entry> + <entry>�������</entry> + </row> + </thead> + + <tbody> + <row> + <entry>doc</entry> + <entry>dcvs.FreeBSD.org</entry> + <entry>/home/dcvs</entry> + </row> + + <row> + <entry>ports</entry> + <entry>pcvs.FreeBSD.org</entry> + <entry>/home/pcvs</entry> + </row> + + <row> + <entry>projects</entry> + <entry>projcvs.FreeBSD.org</entry> + <entry>/home/projcvs</entry> + </row> + + <row> + <entry>src</entry> + <entry>ncvs.FreeBSD.org</entry> + <entry>/home/ncvs</entry> + </row> + </tbody> + </tgroup> + </table> + + <para>�������� � CVS ������������ ��������, ����� ��������� ���������� + ��������� <envar>CVSROOT</envar> (��� ������ ��������� �� ��������������� + ���� � ������� �������� ������, �������� + <hostid role="fqdn">ncvs.FreeBSD.org</hostid><literal>:</literal><filename>/home/ncvs</filename>), + �������� ���������� <envar>CVS_RSH</envar> � <command>ssh</command> � + ������������ ���������� ������ �������� � �������. ������ ���������� + ���������� �������-��������, ����������������� � ������ + <application>cvs</application> � ����������� �����������. � ���������, + ������������ �������� &man.tcsh.1; ����� �������� ��������� ������ � + ���� ������ ��������� �������� <filename>.cshrc</filename>:</para> + + <programlisting>alias dcvs env CVS_RSH=ssh cvs -d <replaceable>user</replaceable>@dcvs.FreeBSD.org:/home/dcvs +alias pcvs env CVS_RSH=ssh cvs -d <replaceable>user</replaceable>@pcvs.FreeBSD.org:/home/pcvs +alias projcvs env CVS_RSH=ssh cvs -d <replaceable>user</replaceable>@projcvs.FreeBSD.org:/home/projcvs +alias scvs env CVS_RSH=ssh cvs -d <replaceable>user</replaceable>@ncvs.FreeBSD.org:/home/ncvs</programlisting> + + <para>������ ��� �������� � CVS ����� ����������� �� ��������� ������, + � ��� �������� ��������� � ����������� ������ CVS ������� ������������ + ���� ��� ����� �������� � ������ ���-���� ���������� ����� (��������, + �������� ������ ��������� �������������), ����� ������������ ������� + <command>cvs import</command>; ���������� � �������� ����������� �� + &man.cvs.1; �� �������������.</para> + + <note> + <para>����������, <emphasis>�� �����������</emphasis> ������� + <command>cvs checkout</command> ��� + <command>cvs update</command> ��� ������������� ����� �������� �������. + �������� CVS �� ������������� ��� ��������� ������ � ������� + ������������ ��������� �������� �� ������� �������. ����������, + ����������� ����� ������������� ����������� <command>cvsup</command>, + � �������� ���� ����������� ������ ��� ���������� ��������. + ���� �������������� ���� �������� cvsup ���������� �������. ��� + ������������� ������������� � ������ ������� ����������� �� ������ + ������������ ������� <hostid>cvsup-master</hostid>, ������� �������� + ������������ ��������� ��� ��������� ������ � CVS; �� ��� �������� + &a.kuriyama;. + </para> + </note> + + <para>���� ��� ����� ������������ ������� CVS <command>add</command> � + <command>delete</command>, ��� ����� � ���������� ����������� ����� + �������� ������� ������� �������� ������� &man.mv.1;, ����� ��������� + �������� <quote>������������� �����������</quote> (repository copy). + ��� ���� ���-���� �� <link linkend="conventions">CVS-��������</link> + ��������� ����������� ����� ������ ����������� �� ������ ����� � ���� ��� + ����� �� ����. ������������ ����������� ������������ ��� ���������� + ������� (�������� ���������). ����������� ��������� ������� ��������� + ����� ����� ��� ����� ������� FreeBSD.</para> + + <para>������������ �� CVS, ������� ��������� � FAQ ����� ����� �� ������: + <ulink url="http://www.cvshome.org/docs/"></ulink>. + ����� ������� ����� ����� ����� ������ (Karl Fogel) + <ulink url="http://cvsbook.red-bean.com/cvsbook.html">Open Source + Development with CVS</ulink>. + ��������� �������� ���������� � CVS �� ������� ����� ����� ���� ������� + <ulink url="http://alexm.here.ru/cvs-ru/">�����</ulink>.</para> + + <para>&a.des; ������� ����� <quote>����-������</quote> ������ � CVS:</para> + + <orderedlist> + <listitem> + <para>���������� ������� ������ �� �����������: ������� + <command>co</command> ��� <command>checkout</command>.</para> + + <screen>&prompt.user; <userinput>cvs checkout shazam</userinput></screen> + + <para>��� ������� �������� ����� ������ <filename>shazam</filename>. + ���� ������ � ����� ������ �� ���������� (�� ������ � ����� modules), + ����� ����������� ������� ������� ���������� �������� ������ + <filename>shazam</filename>.</para> + + <table frame="none"> + <title>�������� ����� ������� <command>cvs checkout</command></title> + + <tgroup cols=2> + <tbody> + <row> + <entry><option>-P</option></entry> + <entry>�� ��������� (������, ������� ����� ���������� + ����������) ������ ��������</entry> + </row> + + <row> + <entry><option>-l</option></entry> + <entry>��������� ���� ������� ��������� (��� + ������������)</entry> + </row> + + <row> + <entry><option>-r<replaceable>rev</replaceable></option></entry> + <entry>������� �������, ����� ��� ��� + <replaceable>rev</replaceable> ��� ���������� ������</entry> + </row> + + <row> + <entry><option>-D<replaceable>date</replaceable></option></entry> + <entry>������� ��������� ������ � ����������� �� ������ + <replaceable>date</replaceable></entry> + </row> + </tbody> + </tgroup> + </table> + + <para>������� � ���������� � FreeBSD:</para> + + <itemizedlist> + <listitem> + <para>������� ������ <filename>miscfs</filename>, ������������� � + �������� ����������� <filename>src/sys/miscfs</filename>:</para> + + <screen>&prompt.user; <userinput>cvs co miscfs</userinput></screen> + + <para>����� ���������� �� �������� ������� + <filename>miscfs</filename>, ���������� ����������� + <filename>CVS</filename>, <filename>deadfs</filename>, + <filename>devfs</filename> � �.�. ���� �� ��� + (<filename>linprocfs</filename>) ����� ������.</para> + </listitem> + + <listitem> + <para>������� �� �� �����, �� � ������ �����:</para> + + <screen>&prompt.user; <userinput>cvs co src/sys/miscfs</userinput></screen> + + <para>������ � ��� ���� ������� <filename>src</filename>, + ���������� ����������� <filename>CVS</filename> � + <filename>sys</filename>. ������� <filename>src/sys</filename> + �������� ����������� <filename>CVS</filename> � + <filename>miscfs</filename> � �.�.</para> + </listitem> + + <listitem> + <para>������� �� �� �����, ������ ��� ���� ������ + �����������:</para> + + <screen>&prompt.user; <userinput>cvs co -P miscfs</userinput></screen> + + <para>�� �������� ������� + <filename>miscfs</filename> � ������������� + <filename>CVS</filename>, <filename>deadfs</filename>, + <filename>devfs</filename>... ������ ��� ����������� + <filename>linprocfs</filename>, ��������� �� �� �������� ������.</para> + </listitem> + + <listitem> + <para>������� ������� <filename>miscfs</filename> ��� + ������������:</para> + + <screen>&prompt.user; <userinput>cvs co -l miscfs</userinput></screen> + + <para>������ � �������� <filename>miscfs</filename> ����� ������ + ���� ���������� <filename>CVS</filename>.</para> + </listitem> + + <listitem> + <para>������� ������ <filename>miscfs</filename> �� ����� + 4.X:</para> + + <screen>&prompt.user; <userinput>cvs co -rRELENG_4 miscfs</userinput></screen> + + <para>������ �� ������ �������� �������� ������ � ���������� ������ + � ��� �����.</para> + </listitem> + + <listitem> + <para>������� ������ <filename>miscfs</filename> �� ��������� �� + ������ ������ 3.4-RELEASE:</para> + + <screen>&prompt.user; <userinput>cvs co -rRELENG_3_4_0_RELEASE miscfs</userinput></screen> + + <para>� ���� ������ �� �� ������� ������ ��������� � �����������, + ��������� <literal>RELENG_3_4_0_RELEASE</literal> ��������� + ������ �������, � �� ����� ����������.</para> + </listitem> + + <listitem> + <para>������� ������ <filename>miscfs</filename> �� ��������� �� + 15 ������ 2000 �:</para> + + <screen>&prompt.user; <userinput>cvs co -D'01/15/2000' miscfs</userinput></screen> + + <para>��� � � ���������� ������, ��������� �� ����� ���� + ��������.</para> + </listitem> + + <listitem> + <para>������� ������ <filename>miscfs</filename>, ����� �� ��� + ������ �����:</para> + + <screen>&prompt.user; <userinput>cvs co -D'last week' miscfs</userinput></screen> + + <para>� �����, ��������� �� ����� ���� ��������.</para> + </listitem> + </itemizedlist> + + <para>�������� ��������, ��� ����-������ �������� � ������������ + <filename>CVS</filename>.</para> + + <para>��������� ����� <option>-D</option> and <option>-r</option> + ����������� (�������� <quote>��������</quote>, sticky), ��������, + ��� ����������� ������������� ������� + <command>cvs update</command>.</para> + </listitem> + + <listitem> + <para>�������� ��������� ����������� ������: ������� + <command>status</command>.</para> + + <screen>&prompt.user; <userinput>cvs status shazam</userinput></screen> + + <para>��� ������� ������� ������ ����� <filename>shazam</filename> + ��� ������� ����� � ���������� <filename>shazam</filename>. + ��� ������� �� ������ ������ ����� ���� ����� ��:</para> + + <informaltable frame="none"> + <tgroup cols=2> + <tbody> + <row> + <entry>Up-to-date</entry> + <entry>���� ������������� ����������� � �� + ���������������</entry> + </row> + + <row> + <entry>Needs Patch</entry> + <entry>���� �� ���������, �� ����������� �������� ����������� + ������</entry> + </row> + + <row> + <entry>Locally Modified</entry> + <entry>���� ������������� �����������, �� ��� ������� + ��������</entry> + </row> + + <row> + <entry>Needs Merge</entry> + <entry>���� ������� ��������; ������ � ���, ���� ������� � � + �����������</entry> + </row> + + <row> + <entry>File had conflicts on merge</entry> + <entry>����� ���������� ���������� �������� ���������, � ��� + ��� ��� �� ���������</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>����� ����, ����� �������� ��������� ������ � ���� �����������, + ������ � ���� ��������� �� ��������� (���� �� ��������� + <quote>�������</quote> ����, ��� ��� �����, ��������� ��������� ������ + ����� ���������� �� �����), � ����� ������� ����, ��������� ����� + � �����.</para> + </listitem> + + <listitem> + <para>���������� ������������ ������: ������� + <command>update</command>.</para> + + <screen>&prompt.user; <userinput>cvs update shazam</userinput></screen> + + <para>��� ������� ������� ��������� ����� <filename>shazam</filename> + ��� ������ � �������� <filename>shazam</filename> �� �������� + ������ ������ ��������� ���� ��� ���������� �����. ���� ��������� + <quote>������ �������</quote>, �� ���������� ������, ���� ������ + �� �������� ����� � ����������� �� ��� ��������� ��� ��� �� + ��������� ����-������ ��� ���������������.</para> + + <para>�������� ����� � ���������� � ��� ��������� ��� ������� + <command>checkout</command>:</para> + + <informaltable frame="none"> + <tgroup cols=2> + <tbody> + <row> + <entry><option>-d</option></entry> + <entry>������� ����� ����������� ��� ����������� ����� + �����������</entry> + </row> + + <row> + <entry><option>-A</option></entry> + <entry>���������� �� �������� ��������� �������� �����</entry> + </row> + + <row> + <entry><option>-j<replaceable>rev</replaceable></option></entry> + <entry>���������� ����� (��. ����)</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>���� �� ��������� ������ � ������� <option>-r</option> ��� + <option>-D</option>, ���������� ������� <command>cvs update</command> + � ������� ����������� <option>-r</option> ��� <option>-D</option> + ��� � ������ <option>-A</option> �������� � ������ ����� �����, + ������� ��� ����. ������������� ����� <option>-A</option> + ������� �������������� ����� ������� ��������; ����� + <option>-r</option> � <option>-D</option>, ��������, ��������� + ��.</para> + + <para>������������ ������������� <literal>HEAD</literal> � �������� + ��������� ����� <option>-r</option> ������ ���� ��� �� ���������, ��� + � �������� ����� <option>-A</option>, ������ ��� ����� ���� + � ������.</para> + + <para>����� <option>-d</option> �������, ����:</para> + <itemizedlist> + <listitem> + <para>����� ���������� ���� ������ ���-���� ��� � ���� ���� + ��������� �������������� ��������;</para> + </listitem> + + <listitem> + <para>�� ��������� ������� ������� ������ ��� ������ ����� + <option>-l</option>, � � ���������� ������ ������� � + �����������;</para> + </listitem> + + <listitem> + <para>�� ������� �����-���� ����������� � ������ ������ + ����� ������� ��.</para> + </listitem> + </itemizedlist> + + <para><emphasis>��������� �������� �� ����� ������� <command>cvs + update</command>.</emphasis> ��������, ������������� � ������, + ������������ ������ ����� ��� ������:</para> + + <informaltable frame="none"> + <tgroup cols=2> + <tbody> + <row> + <entry><literal>U</literal></entry> + <entry>���� ��� ������� ��������.</entry> + </row> + + <row> + <entry><literal>P</literal></entry> + <entry>���� ��� ������� �������� (���������� �������� ���� + �� ���������� �����������).</entry> + </row> + + <row> + <entry><literal>M</literal></entry> + <entry>���� ��� �������, � ��� ���� �������� �������.</entry> + </row> + + <row> + <entry><literal>C</literal></entry> + <entry>���� ��� �������, � ��� ����������� ��������� �������� + ���������.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>����������� (merging) ������������, ���� �� ��������� ������� + ����� ������-�� ������, �������� ���, ����� ���-���� ��� �������� + ������ ����������� ���������, �, �������, �� ���������� ������� + <command>cvs update</command>. CVS �����, ��� ������������� ��������� + ���������, � �������� ���������� ���� ��������� � ����, ��� ��������� + � ����������� (�� ��������� ������, ������� �� ���������, �� ������, + �� ������� �� ��������� ����������). ���� ��������� ����������� � + ���������� ������� �����, ����������� ����� ������ ���������� ������� + (���� ��������� ��� ���� ����� �� ���� ������������� ��� ������������ + ����������).</para> + + <para>CVS ������� ����� <literal>M</literal> ����� ������ ���� �������� + ���������� ������, ���� ���� � ��� ��� ����� ������ � �����������, + ��� ��� ������� <command>cvs update</command> ������ ��� �������� + ��������� ������ ������, ������� �� ��������.</para> + + <para>���� � ���������� �� ������ ����� <literal>C</literal>, ���� + ��������� ����������� � �����������, ���������� � ����������� + (��������� ���� � ����� � ��� �� ��� ����� ������������� �������, + ���� �� �������� ���� ���������, ��� ��� ��������� + <command>cvs</command> �� ������ �������� �������� � ��������� + ��������� �� �����������). ��� ���������� ��������� ���������, + ������� ���������� ����. ������������� ��������� ���������� + �������� �� ������ <literal><</literal>, <literal>=</literal> � + <literal>></literal>. � ������ ������� �� ���������� ������������ + ������ �� ���� ������ <literal><</literal> � ����� �����, ����� + ���� ��������, ���������� ��������� ���� ���������, ����������� + �� ���� ������ <literal>=</literal>, ��������������� �������� �� + ������ �����, ������������ � �����������, �, �������, ������ �� ���� + ������ <literal>></literal> ��������� � ������� ������, �� ������� + �� ��������� ����.</para> + + <para>����� <option>-j</option> �������� ��������� ���������� ������ + �����. ��� �� ������� ��������� ���� ����������� �� ��������� ������ + ��� ��, ��� � ��� ������������� ����� <option>-r</option>, �� + ������������� ����� ������ ��� ����� �� ����������. ��� ����� ����� + ����� ���� ��� ������ �������������: ��� ���� �������� ������� + ��������� ��������� ����� ����� ���������� �������� � ��������� + ����� �����.</para> + + <para>� �������, �� ������ ��������� � ��������� ������ � ���� + <filename>shazam/shazam.c</filename> � &os.current;, � ������� + ������ ��������� ���������� � &os.stable; (Merge-From-Current, MFC). + ������, ������� ������� �������� — 1.15:</para> + + <itemizedlist> + <listitem> + <para>��������� ������� ������ ������ <filename>shazam</filename> + ��� ����� &os.stable;:</para> + + <screen>&prompt.user; <userinput>cvs co -rRELENG_4 shazam</userinput></screen> + </listitem> + + <listitem> + <para>��������� ��������� ����� �������� 1.14 � 1.15:</para> + + <screen>&prompt.user; <userinput>cvs update -j1.14 -j1.15 shazam/shazam.c</userinput></screen> + </listitem> + </itemizedlist> + + <para>����� ��������� �� �������� �������� � �������, ���������� + ������������� ����� (<literal>$Id: article.sgml,v 1.1 2004-09-21 15:38:38 marck Exp $</literal> ���, � ������ FreeBSD, + <literal>$<!-- stop expansion -->FreeBSD<!-- stop expansion -->$</literal>). + ��� ����������� ��������������� ���� ��� ���������� ��������� + (� ������ ������ ���������� ������ ������-����������� � ������ ������ + <literal>$Id: article.sgml,v 1.1 2004-09-21 15:38:38 marck Exp $</literal>, ������� ���� ������ � <literal>$Id: article.sgml,v 1.1 2004-09-21 15:38:38 marck Exp $</literal> + ��� &os.stable;).</para> + + <listitem> + <para>�������� ��������� ����� ��������� ������� � ������� �� + �����������: ������� <command>diff</command>.</para> + + <screen>&prompt.user; <userinput>cvs diff shazam</userinput></screen> + + <para>��� ������� ������� ��� ������� ���������� ��������� ����� (��� + ������ ������) <filename>shazam</filename> �� ���������, ������������ + � �����������.</para> + + <table frame="none"> + <title>�������� ����� ������� <command>cvs diff</command></title> + + <tgroup cols=2> + <tbody> + <row> + <entry><option>-u</option></entry> + <entry>������������ ��������������� (unified) ������.</entry> + </row> + + <row> + <entry><option>-c</option></entry> + <entry>������������ ����������� (context) ������.</entry> + </row> + + <row> + <entry><option>-N</option></entry> + <entry>���������� ������������� ��� ��������� �����.</entry> + </row> + </tbody> + </tgroup> + </table> + + <para>������ ����� ����� ������������ ������ <option>-u</option>, + ��������� ��������������� ������ ������� ������� � ����� ������, + ��� ����� ��� ������ (� ��������� ������� ����������� ������, + ������������ ������ <option>-c</option> ����� ���� ��������� �����, + �� �� ������� ����� ���������). ��������������� ������ �������� + ������� �� ����� ����������, ������ �� ������� ���������� �� ������, + ��������� �� ���� �������� <literal>@</literal> � ������� �����, + ����������� ��������� ������������� �������. ����� ������� ������ + �����: ��, ��� ���������� � �������, ��������� ��������, ������������ + � ������� <literal>-</literal> ���������� ��������� ������, �������, + ������������ � ������� <literal>+</literal> — + �����������.</para> + + <para>�� ������ ���������� ������� ��������� � �������, ������������ + �� ���, � ������� �� ��������� ����, ������ ����� <option>-r</option> + ��� <option>-D</option> ������� �������� <command>checkout</command> + � <command>update</command>, ��� ���� �������� ������ ��������� ����� + ������ ����� �������� (��� ����������� �� ����, ��� ����� � ����� + ��������� �����), ������ <emphasis>���</emphasis> ������ ��� ������ + ����� <option>-r</option> ��� <option>-D</option>.</para> + + <listitem> + <para>�������� ������� ���������: ������� <command>log</command>.</para> + + <screen>&prompt.user; <userinput>cvs log shazam</userinput></screen> + + <para>���� <filename>shazam</filename> �������� ������� ������, ��� + ������� ������ �� ����� <emphasis>���������</emphasis> � ����������� + � �����, � ���������, ��� �������������� � �����������, ����� ������ + ������������� �������� ��������� (<literal>HEAD</literal>), � ����� + ������ ���������� ���� ������������, � ����� ���������� ����, �������� + �� �������. �����, ��� ������ ������ ����� ��������� ��������������� + �� ���������� ���������, ���������� ����, ����� � ������ �������, + ���������� ����������� � ��������� ����� � ���������� ����������� + ���������, ����������� �����������.</para> + + <para>���� <filename>shazam</filename> �������� ���������, ������������� + ��������� ����������� ��� ������� ����� � ��������. ���� ��� ���� + ������� <command>log</command> �� ��� ������ ���� <option>-l</option>, + ��������� ���������� ����������� ��� ���� ������������.</para> + + <para>������� <command>log</command> ������������ ��� ��������� ������� + ������ ��� ���������� ������ � ��� ����, ��� ��� ��������� � + ����������� CVS. ��������� ����� + <option>-r<replaceable>rev</replaceable></option>, �� ������ + ���������� ���������� ��������� � ����� ������������ ������:</para> + + <screen>&prompt.user; <userinput>cvs log -r1.2 shazam</userinput></screen> + + <para>��� ������� ������� ���������� ��������� ��� ������ + <literal>1.2</literal> ����� <filename>shazam</filename> (��� ��� + ������ <literal>1.2</literal> ������� �� ������ � �������� + <filename>shazam</filename>).</para> + </listitem> + + <listitem> + <para>��� ��� �����: ������� <command>annotate</command>. + ��� ������� ���������� ����� ������ ������� ���������� ����� (������) + ��� ������������, ���������� ��������� ��������� � ��� ������.</para> + + <screen>&prompt.user; <userinput>cvs annotate shazam</userinput></screen> + </listitem> + + <listitem> + <para>���������� ����� ������: ������� <command>add</command>.</para> + + <para>�������� ����, ��������� ��� ���� ������� + <command>cvs add</command>, ����� ����������� ������ � ����������� + (������): <command>cvs commit</command>.</para> + + <para>����� ��� ��, ����� �������� ����������� � ����������� ����� + �������� � ������������ ���������� ������� <command>cvs add</command>. + ��������, ��� ��������� ������ ����� ���������� �������� �� + ����.</para> + </listitem> + + <listitem> + <para>�������� ���������� ������: ������� + <command>remove</command>.</para> + + <para>������� ����, ����� ��������� ������� <command>cvs rm</command> + � ��� ������ � �������� ���������, �������, ��������� ��� ���� + <command>cvs commit</command>.</para> + </listitem> + + <listitem> + <para>�������� ��������� � �����������: ������� + <command>commit</command> ��� <command>checkin</command>.</para> + + <table frame="none"> + <title>Useful <command>cvs commit</command> options</title> + + <tgroup cols=2> + <tbody> + <row> + <entry><option>-f</option></entry> + <entry>����������� �������� ��������� ��� �� ����������������� + �����.</entry> + </row> + + <row> + <entry><option>-m<replaceable>msg</replaceable></option></entry> + <entry>������� ��������� ��� ������� � ��������� ������ (�� + ��������� ��������� ��������).</entry> + </row> + </tbody> + </tgroup> + </table> + + <para>����� <option>-f</option> ������� ������������, ���� �� ������, + ��� ������ ������� �����-���� ������ ���������� � ������� + ���������.</para> + + <para>������� ���������� ��������� ����� �����. ��� ���� ����������� + ������ ������, ����� �� ����������� ���������, ������ �� ������ � + ������ �� ������������, �� � ������ ��� ���� ������, ����� ���-���� + ��������������, ������ ���������� ��������� ��� ������������ �������� + ���� ����� � ���� �������� ������. ����� ����, ��� ����� �������� + � ������ ����, ����� �� ���������� ��������������� ��� � &os.stable; + (MFC).</para> + + <para>��������� ������ ���� ������, ��������, �������, � ������������ + �� ���� �������� ���������, ����� ��������� ���� ����������� � + ������.</para> + + <para>��������� ������ ���������� ���� ���������� ��������� + �������������, ��������� �� �������� ��������� � ����� �� + �� ����������� ��������� ��������.</para> + + <para>��������� �������� ���������� �� ��������� ���� � ������ + ��������� �� ���� ���. ��� ���������� ����������� ���������, + � �����, ��� ����������� ������, ��������� ����� �������������� + �� ������ �������.</para> + + <para>��������� ���������� � ����� ������� ��������� ���������������� + �� ��������������� �������� ��� ������������� � ��������. + ��� ��������� �����������, �, ����� ����, ���������� ��������� ����, + ����� ������ �������������� ��������� ���� �������. � ������ ������� + � ����� ������������, ��� ��������� ������ ����� ��������� ��������, + ��������� ���������� ������� �������� ���������, ��������� + ��������.</para> + + <para>��������� ������� ������� ������ ������ �� ���� ��� � ����� + ����� � ��������� ����������. ��������, ������� ��������� � ��������� + ����� (��� ��������� ������ ��������� ������) � ����������� + ����������� ��� ��������������.</para> + + <para>����� ��������, <emphasis>�����������</emphasis>:</para> + + <itemizedlist> + <listitem> + <para>���������, ��� �� ������ ��������� ������ � ���������� �����, + ����������� ������� <command>cvs status</command>.</para> + </listitem> + + <listitem> + <para>��������� ���� ��������� ��� ������ ������� + <command>cvs diff</command></para> + </listitem> + </itemizedlist> + + <para>����� ����, ������ ����������, � ����� ������ ����� �� ������� + ���������, ��� ����� �� �������� � ���� ������ ������ ������. + ������� <command>cvs commit</command> ��� ���������� ������� + ��� ���������� ����� � ������� �������� � ���� ������������. + </para> + </listitem> + </orderedlist> + + <para>��� ��������� �������� �������:</para> + + <orderedlist> + <listitem> + + <para>����� ������������ ����� ����� ������� � ���� + <filename>~/.cvsrc</filename>, ��������:</para> + + <programlisting>cvs -z3 +diff -Nu +update -Pd +checkout -P</programlisting> + + <para>��� ������� ������:</para> + + <itemizedlist> + <listitem> + <para>������ ������������ ���������� ������ 3 ��� ����� � ��������� + �������� CVS. � ������ ���������� ���������� ��� ������� ��� �� + ������ �������� ����.</para> + </listitem> + + <listitem> + <para>������ ������������ ����� <option>-N</option> (���������� + ����������� ��� ��������� �����) � <option>-u</option> + (��������������� ������) ��� &man.diff.1;.</para> + + <listitem> + <para>������ ������������ ����� <option>-P</option> (������� ������ + ��������) � <option>-d</option> (��������� ����� ��������) + ��� ����������.</para> + </listitem> + + <listitem> + <para>������ ������������ ����� <option>-P</option> (������� ������ + ��������) ��� ���������� ������ � �������.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>����������� �������� ������� ������� (Eivind Eklund) + <command>cdiff</command> ��� ��������� ��������� ���������������� + �������. �� �������� �������� ��� &man.less.1;, ����������� + �������� ���� ANSI ��� ��������� ����������, ����������� � ��������� + �����; ������ ������ �� ��������������. ������ �����, ������ + ��������� ������������� ��������� (������� ����� �������� ����������� + � ���������� ��-�� ��������������� ������� � ������ ������).</para> + + <para><ulink url="http://people.FreeBSD.org/~eivind/cdiff"></ulink></para> + + <para>������ ����������� ��� ������ &man.more.1; ��� &man.less.1;:</para> + + <screen>&prompt.user; <userinput>cvs diff -Nu shazam | cdiff</userinput></screen> + + <para>������ �����, ��������� ��������� ���������, ����� ��� &man.vim.1; + (<filename role="package">editors/vim5</filename>) ������������ + �������� �������������� �������� ������ ����� ������, � ��� ����� + ������ ��������� � �������� CVS/RCS.</para> + + <screen>&prompt.user; <userinput>echo "syn on" >> ~/.vimrc </userinput> +&prompt.user; <userinput>cvs diff -Nu shazam | vim -</userinput> +&prompt.user; <userinput>cvs log shazam | vim -</userinput> </screen> + </listitem> + + <listitem> + <para>CVS — ������, ���������� � ����� ����� ������������� + � ����� ��������� ���������. <!-- XXX + exhibits non-deterministic behavior which some claim as proof + that it is actually merely the Newtonian manifestation of a + sentient transdimensional entity. --> + �� ���� ������� �� �������� �������� � ������ ��� �������� �� ������, + ��� ��� �� ������� ���������� ������ � �������������� ���������� + (� ������ &a.cvsadm;).</para> + </listitem> + + <listitem> + <para>�� ���������� ��������� � �������� ������ ������� + <command>cvs commit</command> (� ��������� ��� ��������� ����������� + ���������) ������� ������� (����� ��� �� 2–3 ������). ��� + ������� ��������� ������� �����������, � ������� ��� ��������, � �� + ��������� ������ ������������� �������� ��� ����������. ���� ��� + ����� �������� ������� ���������� ���������, ����������� ��� ������� + � �������� � ��������� �� ����� ���������� ������� + <command>cvs commit</command>.</para> + </listitem> + </orderedlist> + + </sect1> + + <sect1 id="conventions"> + <title>���������� � ��������</title> + + <para>���� �����������, �� ������ ������ ����� ���������� ��������� + ����������� ��������.</para> + + <itemizedlist> + <listitem> + <para>�������� ���� � ������ <quote>SGML ���������</quote> ������� + � ���� + <filename>doc/en_US.ISO8859-1/share/sgml/authors.ent</filename>; + ��� ��������� ������ ���� ������� ������ ������, ��������� � + ��������� ������ ��������� ��� ������ ��������� �������� + ������� ���������� ������ doc/.</para> + + <para>��� �������� ������� ������, �� ��� ���� ��� �������� �������� + ������ ������ ����� ������� ������ � CVS.</para> + </listitem> + + <listitem> + <para>�������� ���� � ������ <quote>������������</quote> ������ + <ulink url="&url.articles.contributors;/index.html">��������� ������� + FreeBSD</ulink> � ������� ���� ������ �� ������� + <quote>������ ���������</quote>.</para> + </listitem> + + <listitem> + <para>�������� ������� � ����� ���������� � ���� + <filename>www/en/news/news.xml</filename>. ����������� ������������ + ������ ���� <quote>����� ���������</quote> ��� ������.</para> + </listitem> + + <listitem> + <para>��� ����� �������� ��� PGP ��� GnuPG ���� � ������� + <filename>doc/share/pgpkeys</filename> (� ���� � ��� ��� �����, + ��� ����� ��� �������). �� �������� �������� � ���������� ������ + � ���� <filename>doc/share/pgpkeys/pgpkeys.ent</filename>.</para> + + <para>&a.des; ������� ������ ��� ��������� ����� ��������. + �������������� ���������� ����� �������� � ����� <ulink + url="http://cvsweb.FreeBSD.org/doc/share/pgpkeys/README">README</ulink>.</para> + + <note> + <para>����� �����, ����� � ����������� ������������ ��� ������� + ���������� PGP/GnuPG ����, ��������� �� ����� ������������� + ��� ������������� ���������� (��������, ��� ����� ��������� ������ + &a.admins; ��� ���������� �������������� ������� ������). ������ + ����� ���������� ������ ������������� ������ <hostid + role="domainname">FreeBSD.org</hostid> ����� ����� �� ������ <ulink + url="&url.base;/doc/pgpkeyring.txt">http://www.FreeBSD.org/doc/pgpkeyring.txt</ulink>.</para> + </note> + </listitem> + + <listitem> + <para>��������� ���������� ��������� ���������� � ����� �������������� + � ���� + <filename>ports/astro/xearth/files/freebsd.committers.markers</filename>.</para> + </listitem> + + <listitem> + <para>��������� ��������� ������ � ��� ������ �������� � ���� + <filename>src/usr.bin/calendar/calendars/calendar.freebsd</filename>.</para> + </listitem> + + <listitem> + <para>������������� ������ �����������, ����� ����� �� ����� �����, + ��� �� � ��� �����������. �� ��� �� ��������� ������ ��������� + ������ ��� ���������: ����� ���������� ����-��� ������ � ���� � + �������� FreeBSD, � ������� �� ���������� ��������. ������� ��� + ������ � &a.developers; — � ���!</para> + </listitem> + + <listitem> + <para>������� �� ������ <hostid>hub.FreeBSD.org</hostid> � �������� + ���� <filename>/var/forward/<replaceable>user</replaceable></filename> + (�������� <replaceable>user</replaceable> �� ���� ��� ������������). + ���� ���� ������ ��������� ����� ����������� �����, �� ������� + ����� �������������� ��� ����� �� ����� + <replaceable>yourusername</replaceable>@FreeBSD.org, � ��� ����� + ��������� � �������� � ������ ����� �� ������ &a.committers; � + &a.developers;. ������� ������� �������� ����� �� ������ + <hostid>hub</hostid> ����� ���� <quote>��������</quote> ������� + ��� �������� ��� ��������������, ��� ���, ����� �� �������� �����, + ��������� ������� �� ���� ������������� ����-������ ���.</para> + + <para>��-�� �������� ��������, ����������� �� ��������, �������������� + ������ ��������, ��-�� �������� ���������� ������������� ����� + (�����), ������, ����������� ����� ��� ������ FreeBSD.org, + ���������� ��������� �������� �������� � �� ��������� �� ��������� + ��������� ������. �� ��������� ������ ������������ ����������� + ���������� �������� ������������ ���������� DNS ��� �����, + ������������� �����, �� � ������� ������ ����� �������. ��� + �������� ��������� �������� � ���, ��� ��� ��������� ���������� + �����. ���� �� ������ ��������� �������� ��� ������ ������, + �������� ���� <filename>~/.spam_lover</filename> � ����� + �������� ���������� �� ������ + <hostid role="fqdn">freefall.FreeBSD.org</hostid>.</para> + </listitem> + + <listitem> + <para>���� �� ���� ��������� �� &a.cvsall;, ���, ������ �����, + ������� ���������� �� ����, ����� �� �������� ���������� + ������� ��������� � ��������.</para> + </listitem> + </itemizedlist> + + <para>��� ����� ���������� ������������� �������� ��� ������������ + �������. ��� ������ �������� �� �������� ��� �������� � �����������, + �������� � �������, � �������� ��� ������� ������ ���� � ����� + �����������. ��(�) ����� ����������� �������� �� ���� �������� + � ���� ��������� ������. �� ��� ���, ���� ��� ������ �� ����� + (� �� ���������� ��� ����������� �������������� ������� ����� + <filename>access</filename>), ��� �� ���������� ��������� � ������ + �������� ��������������, ����� ����� �������� �� ������ �������� + ��������� (approval) ������� � ������� ��� � ���������� ��������� + ������� ������� <literal>Approved by:</literal>.</para> + + <para>��� ������� � ������ <filename>src</filename> ������� ������ + ������������� � ����� &os.current; � ���� ����� ��������������� + � &os.stable;. ������� ��������� ���������, ����� ����������� + ��� ����������� ����������� �� ������ ������������� �������� + � ����� &os.stable;.</para> + </sect1> + + <sect1 id="pref-license"> + <title>���������������� �������� ��� ����� ������</title> + + <para>� ��������� ����� ������ &os; ������� ���������������� ������ + �������� �� �������� ������ ��������� �����:</para> + +<programlisting>Copyright © <Year> <Author>. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE.</programlisting> + +<!-- XXX ���� ������� *������* � ������������ ���������� ������� --> + + <para>������ &os; ������ �� ����������� ��� ���������� <quote>������ + �����</quote>, ��� <quote>����� � �������</quote> � �������� �� ����� + �������� ���. � ����� � ������� ����������� ���������� ������� &os;, + ���������� ����� ������ ������������ ������������ �������������� ��� + ����� ��������������. ���� ��� ��� � ������ ���������� �������� + <quote>����� � �������</quote>, ����������� ����������� ��� ��������. + �� ����� ����, ����������� ����������� �������� �� ����������� + ��������.</para> + + <para>������ &os; �� ����������� ������������� ��������� ����� �������� + ��� �������� ����������� ��������. ����� �������� ����� �������������� + � ����������� ������� ������� ����������� ������� + <email>core@FreeBSD.org</email>. ������� ����� ��������� �������� + ���������� ������������� ����, � �������� ��-�� ������������ + �������� ������� �� ����� ���������������� ������������ ��������.</para> + </sect1> + + <sect1 id="developer.relations"> + <title>�������������� ����� ��������������</title> + + <para>���� �� ��������� ��� ����������� �������� �����, ���� � �������, + � ������� �� ��� ���������� ��� ������������� �������, ���, ������ �����, + �� ����������� ������������� ������ � ���-���� ��� �� �������������. + �� �� ������� ���������, ���� �� ����� ������ � ��� ����� �������, + ������� ���� ����� ����� �� ���������� (� ������ �����, ���������� + ��������� ����� ��������). ���� �� �� ����������� �������������� + ���-���� ������� �������������� (��-��������, ������ ��� ����� ������ + �������� ������ ������ �������� <literal>cvs-committers</literal>), + ����� ������� �������������� ���� �������������� �� ���� ������� ����, + ��� �� �� ���������, ���� �� ���� �����������. � ������ ������ ����� + ���������� �� ������, ���������� � ������ <makevar>MAINTAINER</makevar> + � ����� <filename>Makefile</filename>. ��� ������ ������ �����������, + � ������ ���� ��� �� ��������, ��� ����� ������ ������� ����, ����� + ������ ������������ ������ ������� <command>cvs log</command>. + &a.fenner; ������� �������� ������ ��� ����������� �������������, + �������� ������� ������������� �������, ��������� ��� ������� �� + ��������� ������ ��� ������������ ������ � ����������� ������������� + �� �������� � ������ ����. ������ ����� ����� �� ������ + <hostid>freefall</hostid> � ����� <filename>~fenner/bin/whodid</filename>. + ���� ��������� ���� ������� �� �������� �� ���� ������� ��� ���� ������� + ������������� ���������� �������� � ��������, ����� ����������� ������ + ��������������.</para> + + <para>���� �� �� �����-���� �������� �� ������� � ����� ����������, + ���������� �� ��� ������ � ������ �������� <literal>-hackers</literal> + ����� ��������. ����� �����, ���� ��� �������� ��� � �����, ��� + ����� ������������ ��������� ��� ����� ������ �����������. ���� + ��������� ���, ��� ��� ������ �������� �������������, ��������, + ����� ��� �������� (back out) �� ��� ���, ���� �� ����� ��������� + ���������. ������� — � ������� CVS ������ ����� ��������� + � ����������� ���������.</para> + + <para>�� ���������� � ����� ������ ������ �������������, � �������� �� �� + ��������. ���� ��� ���������� ���� ������� �������� ��� ��, ��� ���� + ����� ������������ ��������, ��� �� ������, ��� ��� �����, ����� + ������������ �������������, ����� ��������� ���� ������, �������� + ���� ������ ���, ��� ��������� ������ FreeBSD. ������ ��� ������� �� + ��� ��� ���� �����. ��������� ������� — �����.</para> + + <para>������ ������ � ������. ���������� ���� ������� �� ��������, ������ + ���������� � �� ������ �������� � ������ ������ ������� ������ ����� + ������ � ���� �������. ������ �������.</para> + + <para>������ �������, ���� ��� ����������. ��� �� ��������� ������. + ���� �� ��������, ����������. �� ��������� �� ����, ��, ��� �����, + ������ � ������. �� ������� ������� �� �������� ��� ������, ������ + ��������� ������ � ���������� ������.</para> + + <para>����������� � ������� � ������. ����������� ���� ��������� ��� + ������������ �������� � �������������� �� ���������. ����� �� + ����������� ������������ ����������� � ��������� ��������� �������� + �������� ���������� ����������. ���� ����� �� ����� ����������� + ����� ���, ��� ������������ ��������.</para> + + </sect1> + + <sect1 id="gnats"> + <title>GNATS</title> + + <para>��� ������������ ������ � �������� �� ��������� ������ FreeBSD + ���������� <application>GNATS</application>. ���� �� ��������� ������ + ��� ������ ���������, ��������� � ����� �� ��������� �� ������� (PR), + �� �������� ������� ��� ���������, ��������� ������� + <command>edit-pr <replaceable>pr-number</replaceable></command> �� ������ + <hostid>freefall</hostid>. ������ �����, ���� �� ��������� ������� + ������� �� ����� � �������� ������ PR �� ���� ����. �� � ���� ������ + ������������ &man.send-pr.1; ��� ����������� ���������, �������, �� + ������ ������, ����� ����������� ����� ���������� ���������� � + ���������.</para> + + <para>����� �������� � <application>GNATS</application> ����� ��������� + �� �������:</para> + + <itemizedlist> + <listitem> + <para><ulink url="http://www.cs.utah.edu/csinfo/texinfo/gnats/gnats.html"></ulink></para> + </listitem> + + <listitem> + <para><ulink url="&url.base;/support.html">http://www.FreeBSD.org/support.html</ulink></para> + </listitem> + + <listitem> + <para>&man.send-pr.1;</para> + </listitem> + </itemizedlist> + + <para>�� ������ ������������ ��������� ������ GNATS, ����������� �� + ������������ ��� ������ CVSup. ��� ���� �� ������ ������������ + ������� GNATS ��������, � ����� ������������ ������� ������������, + ������ ��� <command>tkgnats</command>, ��� �������� ��� �������� � + ����� ��������� �� ������� ��� ���������� � ��������.</para> + + <procedure> + <title>������������� ��������� ����� GNATS</title> + + <step> + <para>���� �� ��� �� ������������� ������� ������ GNATS, �������� � ��� + <filename>supfile</filename> ������</para> + + <programlisting>gnats release=current prefix=/usr</programlisting> + + <para>������, ��� ��� ������ ������ �������������� ����� �������, + ���������� �������� <quote>tag=</quote>, ��������� ������ GNATS �� + ��������� ��� ����������� CVS � �� ����� ���������� �����.</para> + + <para>����� ������� cvsup � �������� <filename>/usr/gnats</filename> + ����� ������� ����� ������ GNATS FreeBSD. �� ������ ������������ + ���� <emphasis>refuse</emphasis> ��� ����������� ��������� ���������. + ��������, ���� ��� ���������� ������ ��������� ��������� + <literal>docs</literal>, �������� � ���� + <filename>/usr/local/etc/cvsup/sup/refuse</filename><footnote> + <para>������ ���� � ����� ������� �� ��������� <literal>*default + base</literal> � ����� ����� + <filename>supfile</filename>.</para> + </footnote> ������</para> + + <programlisting>gnats/[a-ce-z]*</programlisting> + + <para>������ ������� � ���� ������� �������������, ��� �� + ��������������� ������ ��������� <literal>docs</literal>.</para> + </step> + + <step> + <para>���������� ���� GNATS �� + <filename>ports/databases/gnats</filename>. ����� ��������� �� + ���������� ��������� ��������� �������� � ������ + <filename>$PREFIX/share/gnats</filename>.</para> + </step> + + <step> + <para>�������� ���������� ������ �� ������������������ �������� GNATS + � ��������� ������� GNATS:</para> + + <screen>&prompt.root; <userinput>cd /usr/local/share/gnats/gnats-db</userinput> +&prompt.root; <userinput>ln -s /usr/gnats/docs</userinput></screen> + + <para>���������� ��� �������� ��� ���� ���������������� ���������.</para> + </step> + + <step> + <para>�������� ��������� ���� GNATS <filename>categories</filename>, + ������������� � �������� + <filename>$PREFIX/share/gnats/gnats-db/gnats-adm</filename>:</para> + + <programlisting># This category is mandatory +pending:Category for faulty PRs:gnats-admin: +# +# FreeBSD categories +# +docs:Documentation Bug:freebsd-doc:</programlisting> + </step> + + <step> + <para>��������� <filename>$PREFIX/libexec/gnats/gen-index</filename> + ��� �������� �������. ����� ���� ������� ������ ���� ������������� + � ���� + <filename>$PREFIX/share/gnats/gnats-db/gnats-adm/index</filename>. + ��� �������� ����� ��������� ������������ ��� ������ &man.cron.8; + ��� ��������� &man.cvsup.1; �� �������, ������� ����� ����������� + ����� ������:</para> + + <screen>&prompt.root; <userinput>/usr/local/libexec/gnats/gen-index \ + > /usr/local/share/gnats/gnats-db/gnats-adm/index</userinput></screen> + </step> + + <step> + <para>������������� ��������� ������������ �������� � ���� ������ + GNATS. ��������� ������� ������� ������ �������� ��������� �� + ������� � ��������� <literal>docs</literal>:</para> + + <screen>&prompt.root; <userinput>query-pr -c docs -s open</userinput></screen> + + <para>������ ����������, ��������, ���� + <filename role="package">databases/tkgnats</filename> ����� ������ + ��������.</para> + </step> + + <step> + <para>�������� PR � �������� ���.</para> + </step> + </procedure> + + <note> + <para>��������� ��������� ��������� ��� �������� � ������������� + ��������� �� ������� ��������. ��� �������������� ��� �������� ��� + ����������� ����� �� ������ <hostid>freefall</hostid>.</para> + </note> + </sect1> + + <sect1 id="people"> + <title>��� ���� ���</title> + + <para>������ �������� �����������, ���������� ��� ��������� ���������� � + ����� ������� FreeBSD, � �������� ��� ��� ���������� ����� ������������� + ��������. ������� � �� � ���� ������ �� ������ ������ ���������� ����. + </para> + + <!-- XXX The TRB are missing --> + + <variablelist> + + <varlistentry> + <term>&a.jhb;</term> + + <listitem> + <para>���� ����������� ������ SMPng � �������� �� �����������, + ������ � ���������� �������� �� ������������ ����. ���� ����� + �������� ���������� ������ "����������� SMPng". ���� �� ��������� + � ������� ������������ ������������������ ����, ������������� ���� + ������ � ������. �������������� ���������� � ������� SMPng ����� + �������� �� ������ + <ulink url="http://www.FreeBSD.org/smp/"></ulink></para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.jake;, &a.tmm;</term> + + <listitem> + <para>����� � ����� �������� �� ������������ FreeBSD �� ����������� + &sparc64;.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.doceng;</term> + + <listitem> + <para>doceng — ������, ���������� �� �������������� + ���������� ������������, ����� ����� ����������� ������������ � + ������������ ���������� ������������ CVS �� ���-����� � FTP-����� + FreeBSD. ��� ������ �� ��������� ���������. ������� ����� + ����������, ��������� � �������������, ���������� � &a.doc;. + �������������� ���������� � ������������ ������ ����� ����� � �� + <ulink url="http://www.FreeBSD.org/internal/doceng.html">����������� + ���������</ulink>. + ����������, ���������������� � ���������� ������������, ������ + ������������ � <ulink + url="&url.books.fdp-primer;/index.html">��������� �� ������� + ���������������� FreeBSD ��� ����� ����������</ulink>.</para> + + <varlistentry> + <term>&a.ru;</term> + + <listitem> + <para>������ ����������� ����� �������� &man.mdoc.7;. ���� �� + ������ ���������� �������� � ���������� � ������ �� �� ��������� + ��� ��������, ���������� � �������.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.bde;</term> + + <listitem> + <para>���� ���������� ����� ������ ���� �������. ���� ��� ������ + ��� �� ���� ����� ��������, ���� ������ ��� �� ���. ���������, + ��� ����� ������� ������ ����. ���� ����� �������� �������� + ��������� ����������, ���������� � FreeBSD.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.gallatin;</term> + <term>&a.mjacob;</term> + <term>&a.dfr;</term> + <term>&a.obrien;</term> + + <listitem> + <para>��� ���������� �������� ��������� �������������� ��������� + DEC Alpha AXP.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.dg;</term> + + <listitem> + <para>����� ������ �� ����������� ����������� ����� (VM). ���� �� + ���������� �������� ��� ����� �������, ������������� ���� ������ + � �������.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.dfr;</term> + <term>&a.marcel;</term> + <term>&a.peter;</term> + <term>&a.ps;</term> + + <listitem> + <para>��� ������ �������� ��������� �������������� ��������� + Intel IA-64, ���������� ��������� &itanium; Processor + Family (IPF).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.murray;</term> + <term>&a.steve;</term> + <term>&a.rwatson;</term> + <term>&a.jhb;</term> + <term>&a.scottl;</term> + <term>&a.kensmith;</term> + <term>&a.hrs;</term> + + <listitem> + <para>����� ������ ������ &a.re;. ��� ������ �������� �� ����� + � ������� ������� �������. � ������ ��������� ����, ����������� + �������� ��������� ������������� ������� �� ������ ���� ��������� + ������� � �����, ����������� � ���������� ������. ���� �� ������ + ������������� �����-���� ��������� �� &os.current; � + &os.stable; (������ �� ��� �� ���� � ������ ���������� ������), + ��� ��������� �������� � ���� �������.</para> + + <para>������, ����� ����, ����� ������ ������������ � ������� + (<filename>src/release/doc/*</filename>). ���� ���� ��������� + ����� ����, ����� ���� ����������� � ���������� � ������, + �������� �� ���� ������. ��� �����, ���� �� ������� ���� + � ������������� ����������� � ���������.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.benno;</term> + + <listitem> + <para>����� �������� ����������� ������� ����� &powerpc;.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.brian;</term> + + <listitem> + <para>������ ���������� �������� �� + <filename>/usr/sbin/ppp</filename>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.nectar;</term> + + <listitem> + <para>��� — + <ulink url="&url.base;/security/">FreeBSD Security + Officer</ulink> + � �������� �� ������������ ������ &a.security-officer;. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.wollman;</term> + + <listitem> + <para>���� ��� ����� ����� �� ������ ������ ���� ������� ����� ����, + ��� �� �� ������� � ����������� ��������� ������� ����������, + ������ �������� ����� ���������� � ��������. ������ ����, �� + ������ ����������� � ��������� ����������, ���������� � + FreeBSD.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.committers;</term> + + <listitem> + <para>cvs-committers — �����, ������������ CVS ��� ������� + ��������� � ��������. �� <emphasis>�������</emphasis> �� ������ + �������� ������ �������� �� ���� �����; ������� ���� �������� �� + ����, ����� ��� ����� ������� �������� �����������, ��������������� + ����������� � �������.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>&a.developers;</term> + + <listitem> + <para>��� ���������� ��������� �� ������ �������� -developers. + ���� ������ ������ ��� ���������� ��������, ���������� + <quote>����������</quote> ����������� FreeBSD, ����� ��� ������ + ���������, ������ � �.�. ���� ������ <emphasis>��</emphasis> + ������������ ��� ���������� ����, � <emphasis>�� + ��������</emphasis> ������� ������� &a.arch; ��� &a.audit;. + �� ����� ����, ����� ��� ������������� ������ �������, ��������� + �������� ���������� ��������, ���������� ����� ���������� + ������������� FreeBSD � �������� ������ �����������. �, �������: + <emphasis>�������, ������������� ������� �� ������ � &a.developers; + � ������ � ������ ������ �������� FreeBSD</emphasis>. ������� �� + ������ � �����-���� ������ ������ �������� � ������ � + &a.developers;. �������� �������� �������� ��������� ����� + ������������� ������� ������ ��������. ����� ����, ������� �� + ���������� �������� � �� ��������������� ����-���� ������ � + &a.developers;. ��� ���� ������� ������ � &a.developers; ��������, + ��� ������ ������ �� �������� ���������. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="ssh.guide"> + <title>SSH: ������� �����</title> + + <procedure> + <step> + <para>���� �� ����������� FreeBSD ������ 4.0 ��� ����� �������, + OpenSSH ������� � ������� �������� �������. ��� ����� ������ ������ + ���������� ���������� ���� �� ������ SSH. ������ ����� ��� + ����������� ���� OpenSSH + (<filename role="package">security/openssh</filename>). + ��������, �� �������� ��������� ������������ ���� ssh1 + (<filename role="package">security/ssh</filename>), ������ �� + �������� �������� �������� �� ��� ��������. �������, ��� + ��� ����� �� ����� ���� ����������� ������������.</para> + </step> + + <step> + <para>��� ���, ��� �� ����� �������� ���� ������ ������ ��� ��� + ������������� &man.ssh.1; � ���������� ��� ����������� ����� + RSA ��� DSA, ������� ����� ������� &man.ssh-agent.1;. ���� �� + ����������� ������������ ��, ���������, ��� ��� �������� ������ + ������ ����������. ������������ X Window, ��������, ������ + ��������� �� �� ������ <filename>.xsession</filename> ��� + <filename>.xinitrc</filename>. ��������� �������� � ���������� + �������� &man.ssh-agent.1;.</para> + </step> + + <step> + <para>�������� ���� ������ ��� ������ &man.ssh-keygen.1;. ����� + �������� � �������� + <filename><envar>$HOME</envar>/.ssh/</filename>.</para> + </step> + + <step> + <para>������� ��� ��������� ���� (���������� ����� + <filename><envar>$HOME</envar>/.ssh/id_dsa.pub</filename> + ��� <filename><envar>$HOME</envar>/.ssh/id_rsa.pub</filename>) + ������ �������� �������, ����� �� ��� ���� ������� � ���� + <filename><replaceable>yourlogin</replaceable></filename> � �������� + <filename class="directory">/c/ssh-keys/</filename> �� ������ + <hostid>freefall</hostid>. + </para> + </step> + </procedure> + + <para>������ �� ������ ������������ �������� &man.ssh-add.1; ��� + ����������� ���� ��� �� ������. ������� �������� ������� ����� + ��� ������ ���������� ����� � ����� �������� �� � ������ ����������� + (&man.ssh-agent.1;). ���� �� ������ ������� ����������� ��������� + ���� �� ������, ����������� ������� <command>ssh-add -d</command>.</para> + + <para>��� ����� ����������� ������� ���� <command>ssh + freefall.FreeBSD.org ls /usr</command>.</para> + + <para>�� �������������� ����������� ����������� � + <filename role="package">security/openssh</filename>, &man.ssh.1;, + &man.ssh-add.1;, &man.ssh-agent.1;, &man.ssh-keygen.1; � + &man.scp.1;.</para> + </sect1> + + <sect1 id="rules"> + <title>������� ������ ������ ���������� FreeBSD</title> + + <orderedlist> + <listitem> + <para>�������� ������ �����������.</para> + </listitem> + + <listitem> + <para>�������� ������ ���������� �������.</para> + </listitem> + + <listitem> + <para>�������� ����� �������� ��������� + <emphasis>��</emphasis> �������.</para> + </listitem> + + <listitem> + <para>�������� ������������ ������������ (��������� � ���� + <makevar>MAINTAINER</makevar> ������ <filename>Makefile</filename> + ��� � ����� <filename>MAINTAINER</filename> � �������� �������� + �����������).</para> + </listitem> + + <listitem> + <para>����� ������� ��������� ���������� �������� (back out) � �������� + �������, ���� ���� ������� ����������. ������� ������������ ����� + ����������� ������ �����������, ���� ��� ����� Security Officer. + </para> + </listitem> + + <listitem> + <para>��������� �������� � ����� &os.current; �� &os.stable;, �� + ����������� �������, ����� ����������� ������������ ���������� ��� + �������������� ��������� � &os.current;. ����� ������������� � + �� ������� ��������� ������ ���� ��������� � &os.current; � ������� + �� ������� ���� 3 ���� ����� ���������, ����� ��� ����� ��������� + ��������������. ����������� �������� �������� ��� �� ������� � + ����� &os.stable;, ��� � ����������� (��. ������� 5).</para> + </listitem> + + <listitem> + <para>�� ������������ � ������� ������������ ��������: ��� ����� + ��������. ���� ��� ���������� � ���-���� <quote>������������� �� + �����������</quote>, ������� ��� ������ ������.</para> + </listitem> + + <listitem> + <para>���������� ��� ������� ��������� ���� (core freeze), � ����� + ������������ ������� ������ �������� <literal>committers</literal> � + <literal>developers</literal>, ����� ���� � ����� ���������� ����� + ��������.</para> + </listitem> + + <listitem> + <para>���� �� ������������ � �����-���� ���������, ������� + ��������!</para> + </listitem> + + <listitem> + <para>���������� ���� ��������� ����� ��������.</para> + </listitem> + + <listitem> + <para>�� ����������� ������ � ������� + <filename>src/contrib</filename>, + <filename>src/crypto</filename> � + <filename>src/sys/contrib</filename> ��� + <emphasis>�������</emphasis> ���������� (approval) ���������������� + �����������(��).</para> + </listitem> + </orderedlist> + + <para>������������ ���� ������ ����� ������� ���������� ��� ������������ + ���, � ������ ���������, ������� ������� ������������� ����. ����� + ��������� (Core) ����� ����� �������� ������������� ����� ���������� + �� �������, ����� ��������� � ����� ������ ������ ������. + � <quote>���������</quote> ������ (��������� ��������� �����������) + ����� ����� ����� ����� ������������� �� �����������. ��� ������������ + ���� ���������� ����� ��� �� ������ ��� ��� ������� ������� ������� ���� + ��������� ����������������� ����������� (2/3) ������� ���������. ��� + ������� ���������� �� ������, ��� ��������� ������� �� ������� + ����������, ���������������� ������������ ������ ������� ��-��� ����, + �� ���� �������������� ������� ���������� �����������. ���� ���-�� + ������� ��-��� ��������, ����� ����� ����������� ���������� � ��������� + ����������, � �� ���� ��������� � ������. � ����� ������, ���������, + ��� ����� ��������������, ����� ����� �� <quote>�������� + ���������</quote>, �� ������� ������������ ���� ������������ ��� + ������� ������������� ����. ���������, ����� �������� �������������� + ����� ��������� ��������� ������ ������� ����� 30 ���� � ������ + ����������� 30 ���� (���� ����� ������ ������������ ��������� 30 ����). + ���������, ��������� �������� ����, ����� ��������� ��������� �� + ��������� 6 �������. ������� ���������� �������� <emphasis>��������� + �������������</emphasis> � �� ���� ������� ��������� ����� ����� + ���������� ������ �� ���������, ���� ������� ���� �������������� ������� + ������.</para> + + <para>�� ���� ������ �������� ������������ �������, ��������� �������� + ������������� ����������� � ���������� <emphasis>���� �� + ���������</emphasis>. ���� �� ���� �������� � ��������� �� ���� ����� + ���������� ��������� �������. ��������� �������� <quote>������ + �����</quote> ������ � ������ ������������ ��� �����, � �� �� + �������������� ������. ����� ��������� — � ������ ������� + ����������.</para> + + <sect2> + <title>�����������</title> + + <orderedlist> + <listitem id="respect"> + <para>�������� ������ �����������.</para> + + <para>�� ������ ���������� � ������ ����������� ��� � �������� �� + ���������� (��� ��� � ��������). �������� �� ����������� ��������� + ������� ���������� ��������, ����� �� ���� ����������� �� ����� ��� + ����-���� ��� ��������, � ���� ��� ������� �������, ��� �������� + ��������� �� ������. ��� ����������� �� ����, ������ �� �� + ��������� �������� ���� � ����� ��� ��� (� ������� ������ �� ������ + ���), �� ������ ������ <emphasis>����������</emphasis> �������� � + ������ �����������, ��� � ��������� �������, ��� � � ������ �����. + </para> + + <para>����������� ���������� ������ � ������� ����������� + ������� — ���� �� ������� ���������� �������, ����� + ����� ������, ��� ����� ����� ��������� � ����, � ������� ��������� + ������������ ���� �� ����� ������ � ����������� ���������� �������� + ������.</para> + + <para>����� �� ������������� ����� �������, ������� �� ��������� + �����, ����� �� ��� ��� �����-���� ���� ������� ������ + �������������� ������ �� ������������. ������� �����������, + ����� ��������� � ���, ��� �������� ���������� ������� ���������(��) + � ������������ ����� ����������; �� ���������� ����� � ����� ���� + �������� ���� ����������, ���� ����� ����� ������ ������. + ��� �� ������ ������ <quote>������������� ������������</quote>: + ������������� ���������� ��������� ��������, �������� �� ���� + ����������� �������� ������, ����� ������� ����������� �������� + �������, � ����� �������� � ������������ ��� ������ ���� + ����������. �� �������� ����� ����������� ��� ��������� + ������������, ��� � ������ ���������; ��� �� ��������, ��� ��������� + ����� ��������� ��������� ����� ���������, ������, ��� + ��������������� ����������� ������������ ��������� ����� + �����������.</para> + + <para>��������� ��������� ������ �� ����� ���������� ���� � �����, + ������ <quote>����������� ������� ������� �����</quote>. ������� + ����� ���� �� ����� ������ �����������.</para> + </listitem> + + <listitem> + <para>�������� ������ ���������� �������.</para> + + <para>�� �� ������ ���� �����������. � ���� ����� �� ���� ������� + ��������� ���������� (contributor). ������� �� ���� ��� �����. + �������, ����� ����� ���� �������� �������� � ������. �� ���������, + ��������� ���� ������� ���� ������ ��� ���. ������� ���� ��������. + �� ������������� ������ ���������� � �� �������� ��. ���������� � + ��� � ���������. ��������, ��� ���� ������� ����������, � ��� + ��������� �� ����� ��� �������, ��� � ����������. �� ����� � + ������ ��������� �� ����� � �����, ��� � ���. � ����� ������, + ��� �������� ��������� ������ ������ ��� �������, ����� ����� + �����������. ������ ������� �� ����.</para> + + <para>��������� ������ ������� <xref linkend="respect"> � ���������� + ��� � � ������ ���������� �������.</para> + </listitem> + + <listitem> + <para>�������� ����� �������� ��������� + <emphasis>��</emphasis> �������.</para> + + <para>����������� CVS — �� ����� ��� ������ ��������� ��� + ���������� ��. ��� ��������� ������ ����������� � ������� + ��������, � ���� ����� ���������� ���������� �������� � + �����������. ��� �� ��������, ��� �� ������ ���������� ���������� + �� ����������� ��������� �������������� ������ � ���� ��� �������� + � �������� �����������. �� ������ �������, ����� �������������� + ��������� ������� ���������������� ���������� � �������� �����. + ��� �������, ����� �� ������ ��������� ������ �������� ���������, + ���� ��������� �������� ����� ����������� ���������, ������ + ����� �� �����, ����� ��� ��������� <emphasis>����������</emphasis>. + ������ ������ ���������, ��� �� �� ���������� ���� — + ���� ��� ��� ����������� ����-���� ��� �� �����������.</para> + + <para>���� �� ������������, ������� ������!</para> + </listitem> + + <listitem> + <para>�������� ������������ ������������.</para> + + <para>������ ����� ���� FreeBSD �� �������� ����-���� + <quote>��������������</quote>: ��������, ����� ����� ���������� + � �������, ���� �� ������� ��������� � <quote>���</quote> ���, + �����; ������, ������ ����� �������������� ���������. ����� �� + ������������ ���������� ���� ���������� ������ MAINTAINER � ���� + <filename>Makefile</filename> ������ ��� ����� ������, ������� + ������� �������������� ����� ��� ����������� ������������; ��. + ����� ��������������� ������ <ulink + url="&url.books.developers-handbook;/policies.html">����������� + ������������</ulink>. � ������, ���� �����-�� ������� ������� + ����� ��������� ������������, ��������� ��� ����� �� ��� ������ + ���� �������� �� ������� ���� ����� �� ������. � �������, ����� + <quote>��������������</quote> ���� ������, �� ������ ��������� + �� ������� ��������, ����� ������, ��� �������� ������� ���� � + ��������� ����� ������� � ���� �������.</para> + + <para>��������� ������� FreeBSD �������� ��� �������� �����������, + ������������ ���������� ����� ��������� �� ���� �������� FreeBSD, + ����� ��� ����������� ��� ������� ����������. ��� �������������� + ���������� �������� <ulink + url="&url.articles.contributors;/staff-who.html"> + http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/staff-who.html</ulink> + </para> + </listitem> + + <listitem> + <para>����� ������� ��������� ���������� �������� � �������� + �������, ���� ���� ������� ����������. ������� ������������ ����� + ����������� ������ �����������, ���� ��� ����� Security Officer. + </para> + + <para>��� ����� ���� �������, �������� � ������ ��������� (����� + ������ �������� ������, ��� ���� ������ ��). � �������, CVS + ���� �����������, ������ ���� ����� ����� �������� ����������, + ������ �������� ��������� ���������, ����������� ���� ���������� + ���������, � ����� ����������� ����� ���������������� ����. + ���� � ����� ������ ��������, ��� ��������� ����� ����, ��� + ����� ���� ����� ��������� �����. � ��������� ������, + ������������� �� �������� ���� � ������������ ���������� ������ + �������� �������, ���� ������� ������ ���������� ���������. + ������� �� ������ ��������� �����, ��������� ���������� ������ + �������� �������� ��� ������� ������� �� �������; ������, ���� + ����� ������ ��� �� ������, �� ������ ���� ���������� ������������, + ����� �� ����� �������� ��������, ���� ��������� �������� ��� + ���.</para> + </listitem> + + <listitem> + <para>��������� �������� � ����� &os.current; �� &os.stable;, �� + ����������� �������, ����� ����������� ������������ ���������� ��� + �������������� ��������� � &os.current;. ����� ������������� � + �� ������� ��������� ������ ���� ��������� � &os.current; � ������� + �� ������� ���� 3 ���� ����� ���������, ����� ��� ����� ��������� + ��������������. ����������� �������� �������� ��� �� ������� � + ����� &os.stable;, ��� � ����������� (��. ������� 5).</para> + + <para>��� ��� ���� <quote>�� �����������</quote> �������: ����������� + ������� ���������� �������� �� �����������, ���� ���������� ��� + ��������� ��������� �������. �������� ��� �����, � ��������� + ������ ������� ������� � ������ � ������ &os.stable;. �� ������ + ������ ����� ����������, ��� ����� &os.stable; ����������� + �������� �������������. �� ���������, ������, ��� �������� + ������������ — ������������� �������� &os.stable;, + � ��� ��� ����� ����������� �� �������, �������� �� ������� + &os.current;. ����� ����, ��� ������ ����������� ��������� � + &os.current;, ���� ��� ���������� ����������� � &os.stable;. + ������������ &os.current; ������ ����� ����������� �������������� + ��������� ���������, ��� ��� �������� ����� ��� ������ + ������������, ���� ������ ���� �� ���� � ����������� ����������� + ��� � ���-���� �������� �� ��������� ������������ (��������, + ����������� �������� � ��������� �����������, ��������� ������ ��� + �������� � �������� ������� � �.�.) ����� �������, �������� �� + ����������� �������� ������.</para> + + <para>��������� � ����� ��������� ������������ (security branches, + ��������, <literal>RELENG_4_5</literal>) ������ ���� �������� + ������ ������ &a.security-officer; ���, � ��������� �������, ����� + �� ����������� ��������� (&a.re;).</para> + </listitem> + + <listitem> + <para>�� ������������ � ������� ������������ ��������: ��� ����� + ��������. ���� ��� ���������� � ���-���� <quote>������������� �� + �����������</quote>, ������� ��� ������ ������.</para> + + <para>��� ���� ���������� ������� ����� ����� ����������� ��� + ���������� ������; �������� ��� �����, ���� �� ����� ���������� + ���������� ����� ����������. ���������, ���, �������� �� ��� + ������ �� ���������� ������ ��� �����, ���� ��������� � ������ + ���� �����. ������, ��� ����� ����� ������� — + �������������� ������, ���� ��� ��������� �� ����������. + �������������, �� �� ������ ���������� ���� ������ ��������, + � ����� � ���������� ������� ��������� � ������������� ������ + ��������. ���������, ��������������� � ��������� ���� �� ���� + �������� ������� ����� ���������, ��� ��, ������� ������ �������� + ��������� �� ��������, ��� ��� �������� ��������� ��� ����� � + ��������� ���������: ��� ���� �������� � ��� ���� ���������� + ��������. ���� ���-����, ��������� ��� �������������� �����, + ������ ��� � ������� ���������, ���������� �������� � ��: + ��������� ��������. ����, �� ������ ������, ���-���� �� + ������������� ��������� � ���� ��������, � ��� ��������� + ����� ���, ���������� � ���������, � �� �������� �������� + ������. ��������� �������� ��� ���� � ���������� ��������, + �������� � ���� ����������� �����. � �������, ����� ���� + ����������� �����-���� ����� ����, � ��������� �� ����� ������ � + ������� ����������� ����������, ��������� ����� �������� + ������������ ��������� ��� ���������� �������. � ���� ������ + ��� ��������� ��������� ������ ����������� ������� �������, + ���������� ������� ��������.</para> + <!-- XXX Mention TRB here too --> + </listitem> + + <listitem> + <para>���������� ��� ������� ��������� ���� (core freeze), � ����� + ������������ ������� ������ �������� <literal>committers</literal> � + <literal>developers</literal>, ����� ���� � ����� ���������� ����� + ��������.</para> + + <para>�������� �� ���������� ��������� � ������ ��������� ���� + �������� �������� ������� �������. ���������� ������ ���� + � ����� �������, ������ ��� ������ 10 �������� ��������� + ����� ������� ����������. ���������� ��� ������� ����� + ������������ ��������� �������������� ���� �� ����������� ����� + � ���������� ������ ��������� ������������ FreeBSD, ������� + ����������� � ����������.</para> + </listitem> + + <listitem> + <para>���� �� ������������ � �����-���� ���������, ������� + ��������!</para> + + <para>��������� ������ �����������, ����� ���-���� ��������� + ��������� ��������, �����, ��� ��������� ���������. ����� + ���-���� �������, ��, ������ �����, �� ������ �������� ������� + � ���������, � ����� ����� ����� ������� ��������, �� �� �� + ������ ����� ��������� ���� �� � ������ �����. �� ����� + ��������� �������� <quote>���, ���� ������, ��� ���� + ������?</quote> �� � ��� �����, ��� �� ����: ����� �� �� ����� + �� �����������.</para> + </listitem> + + <listitem> + <para>���������� ���� ��������� ����� ��������.</para> + + <!-- XXX Needs update re sparc64 + pc98 + Also, needs more details on which machines are available for testing + --> + <para>��� ������� ����� ���������� ���������. �������, ���� �� ��� + ������������� ���� �������� ��� ����, �� �� ��� ����� ������������ + �� �������� ������ ��� ���������. ���� ���� ��������� ����������� + ����, ���������, ��� ����� ���� ��������� ���������� ���� GENERIC + � LINT. ���� �� ��������� ������ ����� ��������� ����, ���������, + ��� ��� ���������� (������� ����������� make buildworld). ���� + �� ��������� ��� � �����-���� �����, ���������, ��� �� ���������� + ��� �� ������, ������� �������� ������ �� ���� ����� ����. ���� + ���� ��������� ����� ��������� ������ �����������, ��������� ��� + �� ���� �������������� ������������. ������ ��������� �������� + ����� ����� �� �������� <ulink url="&url.base;/internal/"> + </ulink>. �� ���� ���������� ������ �������������� �������� + � ������� ����� ����������� ��������������� ������ ��� + ������������.</para> + </listitem> + + <listitem> + <para>�� ����������� ������ � ������� + <filename>src/contrib</filename>, + <filename>src/crypto</filename> � + <filename>src/sys/contrib</filename> ��� + <emphasis>�������</emphasis> ���������� (approval) ���������������� + �����������(��).</para> + + <para>��������� ������� �������� �������� ��� ��������� + ��������������, �������, ��� �������, ������������� � + ��������������� �����. ����� ������, ���� �� ��������� ���� �� + ����� �������������, ����� ����� �������� ����� ��� ������������� + �� ��� ����� ������� �������������. ��� ���, ���� � ��� ��� + <emphasis>�������</emphasis> ���������� �� �����������, + <emphasis>������</emphasis> �� ������� � ���� ������ + ����������� (����, �������, �� �� ������������� ���� ��� + ����).</para> + + <para>�������, ��� ������ ��� ��������� ����� �� ��������, ��� �� �� + ������ �������� �������� ���������� ���, ��������, ����� ����� + ������ ����. ����� �����, ���� �� ���������� ���� ����������� + �������. ���� ��������� ���������� ��� FreeBSD, �������� ������ + � ������������, ��������, �� ��������� �������� ��������� �� + ��������. ��� �� �����, ��� �� �� �� ������, + <emphasis>��</emphasis> ����������� ������ ����!</para> + + <para>���� �� ������ ����� ������������� �� <quote>�����</quote> + ������� ������ ����������, ��������� � &a.core;.</para> + </listitem> + </orderedlist> + </sect2> + + <sect2> + <title>������� ������ � ���������� �������������</title> + + <para>������� � ������ 5.0 ������ FreeBSD ����� ������������ ��������� + ����� �������������� ����������, � ����� �� �������� + <quote>&i386;-����������</quote>. ��� ��������� ��������� FreeBSD + �� ���� ���� ���� �������� ���������� ���� �������������� ��������� + ���������:</para> + + <blockquote> + <para>�������� 32-������ ���������� ���������� �������� i386; + �������� 64-������ ��������� — Sparc64. ������� + ��������� � ������� (� ��� ����� �������� ��������� � API � ABI) + �� ��������� � ����������� ������ ���� �������� �� ������� ���� + �� ����� 32 � ����� 64-������ ���������, ���������� �� �������� + �������������� ����������.</para> + </blockquote> + + <para>��������� i386 � Sparc64 ���� ������� �� ������� ������� + ������������������ ����������� ��� �������������; ����� ����, ��� + ������������ ������������� ������ ������� � ������� ���������� � + ������� � �����: ������� ���� � �����, ����������� ���������, + ���������� DMA, ����, ���������� ��������� � �.�.</para> + + <para>��������� Alpha, �������, �������� 64-������, ������ �� + ������������ ����� ������������ ������ � ������ �� ����� ������� + ���������� ������� �������� ���������� ��� ��������� ���������, + � �������� ����������� ����� ����������� �� ������ 64-������ + ����������. ��������� ia64 �� ������ ������ ��� ��, ��� � + Sparc64, ������ �� ����������� ��� ������������� ���� ��������� + ������ �������.</para> + + <para>�� ����� ����������������� ��� ������� �� ���� ����, ��� ����� + �������� ���� � ����������� 64-������ ��������.</para> + + <!-- XXX ??? XXX --> + <para>����� ����, ������������ ������ ���� � ����� ����� ������ ������� + ��������� (Tier Policy) ��������� ���������� ����������. ��� ������� + ������������� ��� ������ �������� �������� ����������, � ������ + ���������� �� ������������� ���������� � ������������ � ������������. + ������� ������� ��������� �� ������ ������� ������� ����� ������, ��� + ����������� �� ��������� � �������� ����������.</para> + </sect2> + + <sect2> + <title>������ ������������</title> + + <para>����� �������� � ������� ������������ ����������� �����-���� + �������� �������� ����������. ��� ���������� SGML, ����� ����, + ��� ������ ������� <command>make lint</command> ������� ��������� + ������������ ��������������.</para> + + <para>��� ������� �����������, ��� ������ ������� �� ��������� ������ + <command>manck</command> ���������� ������������ ������������ ������ + � ������ �� �����, � ����� ������� ���� ����������� ������ �� �������� + (���������� <makevar>MLINK</makevar>).</para> + + <para>�� ���������� �������������� ��������� �� ��������������� + (�� ����������� �������������� ������� ����). ����� ���������� + ���������� ���������� ��������� ��� ������������� ������� + <command>cvs diff</command> �, ����� �������, ����� ������ ����������� + ������. �� ���������� � ������� � ������� <filename>doc/</filename> � + <filename>www/</filename> ��������� ������ � ������������������: ��� + ���������� ������ ������������. ����������� ��� �������������� + ��������� ��� ������������������ ���������� ���������, � ����� + ����������� �� ��� ������� � ���������� ���������� � �������.</para> + </sect2> + + <sect2> + <title>�������� ������������</title> + + <para>��� ������������� �������� �����-���� �������������� ����������� + �� ������ ������� ������� ������� ������������ ��������� ����� + ��������:</para> + + <orderedlist> + <listitem> + <para>� �������� ����������� �, ��������, � ������������ � ������ + �����, ������� ��� ��������� ����������� ������������� � �� + ���������������� � ������������� (deprecated); �� ������������� + ������� ��������������.</para> + </listitem> + + <listitem> + <para>�����, ������� ��� ��������� ����������� �� ���������� + ��������� ������ (����� X.0).</para> + </listitem> + + <listitem> + <para>�����, ������� ��� ��������� ���������, � ��� ����� �� + ������������: ������ ��� �������� �����������. ��� �������, + �� ���� ����� ��������� � ������������ � ������.</para> + </listitem> + </orderedlist> + </sect2> + </sect1> + + <sect1 id="archs"> + <title>��������� ��������� ����������</title> + + <para>FreeBSD �������� ������ ����������� ������������ �������� � + ������������� ��� ������ �� ����� ������������� ���������� + ������������. ������ ������ �������� ����������� �������� � + ��������� ����������� ��������� �������� ������������ �������� + ������� ���� �� �������-��������� (Machine Dependent, MD) � + �������-����������� (Machine Independent, MI), � �����, �� �����������, + ����������� �������-��������� ����� ����. ������ ����� ���������� + �����������, ������� �������� ������������ FreeBSD, ������� ����������� + ������ �� ��������� ����, �������������� � �������� ������� �������. + ����� ����, ���������� ����������� ������� ���������� ����������� + ��������� � ���� ����. ��� ��� ������ ����������� �������� ��������� + ������� ��������� ��� ��������� ����������, ��� ���������� ������������ + ������������ ������ ����� "�������� ��������".</para> + + <sect2> + <title>�������� ���������</title> + + <para>������ FreeBSD ������������ ��� ������ �� ������� ��������, + �������� � ���������������������� ���������� ��������. �������� + �������� �� ����� ���������� ���������� � ��������� ����� ������, + ������ FreeBSD �������� �������� ������������ ������� ������� + ����������, ������������ � ������������������, � ����� ��������� + �������� �� ��������� ������ ��������� �������, ����� ��� ������ + ��������� ������, ������������, ������������ � ������� �������. + ������������ �������������� ���������� �������� ��������� ������� + ������������ FreeBSD �� ���� ��������� ����� ������������ (��������, + ��������� 64-������ �����������, ������������� �� ���������� �������� + � �.�.); ��� �� �����, ���������� ����� ������ ������ ������ ���� + ��������� ������� � ������� ���������� ������ �� ��������� + �������������� ���������� ���������.</para> + + <para>������ FreeBSD ����� ��������� ���������� ��������� �� 4 ������. + ��� ������� ������ ����������� ����� ����������, ����������� ��� + ���������� ��������� ������� ������, � ������������� ������������� + �� ��������� � ���������. ����� ����, ������������ ������� ����� + ������ ��� �����������.</para> + </sect2> + + <sect2> + <title>����� 1: ��������� �������������� �����������</title> + + <para>��������� 1 ������ ��������� �������������� ������� ������������, + ������� ������� ������� � ������������� ��������������. ����� + �����������, ����������� � ��� �������, ������ ���� ��������� + ������������� ��� ���� ���������� ������� ������ ��� ������� �� + ������� (����������� ����� ���� ������������-��������� �����������, + ����� ��� �������� ����������). ��� �������, ��� ��������� 1 ������ + ������ �������������� ��������� ������ ���� �������������� + ��������������� � �������� FreeBSD.org, ���� ����� ���������� ��� + ���� �������������.</para> + + <para>����������� ������� ������ ������ ���� �������� � ������������ + ��� ����������� FreeBSD �� ���� ��������, ������� ������� ��������� + � ����� ����������.</para> + + <para>� ��������� ����� ����������� 1 ������ �������� i386, Sparc64, + AMD64, and PC98.</para> + </sect2> + + <sect2> + <title>����� 2: ����������� ��� �������������</title> + + <para>��������� 2 ������ �� �������������� �������� ������������ � + ������� �������. ��������� �������������� ����������� �� ���������� + ��� ������������. ����� �����������, ����������� � FreeBSD, ������ + ���� ���������� �� ���� ����������, ������ ���������������� ���������� + �� ������ ���������� ���� � ������ �������� ������� �� ���������. + ���������� ����� �� ����������� 2 ������ ����� ���� ��������� � + �����������, ���� ��� �� ������ � ������������ � ������� ���������� + ������ ������� ������ � �� ������ � ������������ ������� �� ������ + ��������� 2 ������. ��� ���������� ����������� 2 ������ � ������ + �������� ������� FreeBSD ������� ������ ���� �������� ����������� + ���� �� � �������������������� ����� �� �������� ����������. + ��������� ���������� �� ���������� ������� ����� ���� ������� ��� + ����� ����������, ����������� � ��������� ���������� � �������� + �� ��������� ��� �������.</para> + + <para>������ ������������� 2 ������ �������� ��, ������� ����������� + � �������� � 1 �����, �� ���� ��������� � ��������� ����������. + ����� �� ������ ������ ����� ��������� ���������, ���������� �� + 1 ������ �� ������� ������ ������������, �� ���� ���� ��� ����������� + ���������� ��������, ��������� ��� ��������� ������� � ��������� + ���������� � ������������ ������������.</para> + + <para>� ��������� ����� ����������� 2 ������ �������� Alpha, PowerPC + � ia64.</para> + </sect2> + + <sect2> + <title>����� 3: ����������������� �����������</title> + + <para>��������� 3 ������ �� �������������� �������� ������������ � + ������� �������. ��������� �������������� ����������� �� ���������� + ��� ������������. ������������� �������� ������ ����� ����: ��, ��� + ������� ��� � � ��������� ����� �� ����������� ���������� ������� + ������������; ������� ����� ���� �������� �������������; �� ��������� + ����������� � �������������������� ����� �� �������� ���������� (��� + ��� ����������� ���������, ���� �������� ���������� ����������); + �������, �������, ������� ����������� ��� ����������, ��� ���������� + ������������������ �����������. ��������� ������ 3 ������ �� �������� + � �������� ������ �������� ������� FreeBSD, ������ ������ ��� ������ + ������������� ����� ������������� � ����������� Perforce FreeBSD, ��� + ���������� �������� ������ � ���������� ���������� � �������� ������ + ����.</para> + + <para>� ��������� ����� ������������ ���������� 3 ������ �������� + &s390;.</para> + </sect2> + + <sect2> + <title>����� 4: �� �������������� �����������</title> + + <para>������� 4 ������ ����� �� �������������� ��������.</para> + + <para>� 4 ������ ��������� ��� �����������, �� ������������� ����.</para> + </sect2> + + <sect2> + <title>������� ����� ������ ��� �����������</title> + + <para>��� �������� ��������� �� ������ � ����� ��������� �������, + ������������ ����������, �������, � ���� �������, ��������� ��� + � �������� ������������, ������� ������� � ��������� ��������������. + </para> + </sect2> + </sect1> + + <sect1 id="ports"> + <title>FAQ �� ������ � �������</title> + + <qandaset> + <qandadiv> + <title>���������� ������ �����</title> + + <qandaentry> + <question> + <para>��� �������� ����� ����?</para> + </question> + + <answer> + <para>��� ������ ���������� ������, ����������� ������������� + �����������.</para> + + <para>����� ������� ����� ������������ ������ + <command>addport</command> �� ������ + <hostid>freefall</hostid>. �� ������� ���� �� ���������� ���� + ��������, ��������� ������ ��������� �� ����� + <filename>Makefile</filename>, ������� ������ � ���� + <filename>CVSROOT/modules</filename> � � ���� + <filename>Makefile</filename> ��� ������ ���������. + ������ ��� ������� &a.mharo; � &a.will;; ������� � ����������� + �� ������ <command>addport</command> ������� ���������� �����, + ��� �������� �����������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ��� ������� �������, �������� ����� ����?</para> + </question> + + <answer> + <para>��������� ���. ���������� ��������� � ���, ��� ���� � + ��������������� ����� ��������� ����������. ������������� + ������������������ �������� ������:</para> + + <screen>&prompt.root; <userinput>make install</userinput> +&prompt.root; <userinput>make package</userinput> +&prompt.root; <userinput>make deinstall</userinput> +&prompt.root; <userinput>pkg_add <replaceable>��� ���������� ������</replaceable></userinput> +&prompt.root; <userinput>make deinstall</userinput> +&prompt.root; <userinput>make reinstall</userinput> +&prompt.root; <userinput>make package</userinput> + </screen> + + <para>����� ��������� ���������� ����� ����� � + <ulink url="&url.books.porters-handbook;/index.html">����������� + FreeBSD �� �������� ������</ulink>.</para> + + <para>����������� &man.portlint.1; ��� �������� ������������ �����. + �� ����������� ���������� ������� ���������� ��������������, + �� �� ������� ���� ��������� ���������� �� ���.</para> + + <para>���� ����� ���� ������� �������, ��� �� ���������� � + <ulink + url="&url.articles.contributors;/contrib-additional.html">������ + ������ ����������</ulink>, �������� ��� ��� ����.</para> + + <para>�������� PR, ���� ����� ���� ������ � ���� PR. ��� ����� + �������������� �������� + <userinput>edit-pr <replaceable>PR#</replaceable></userinput> + �� ������ <hostid>freefall</hostid> � �������� �������� � ������ + <varname>state</varname> � <constant>open</constant> �� + <constant>closed</constant>. ����� ������� ������� ����� + �������, � �� ��� ������ ���������.</para> + </answer> + </qandaentry> + </qandadiv> + + <qandadiv> + <title>������������ �����������</title> + + <qandaentry> + <question> + <para>����� ��������� ������������ �����������?</para> + </question> + + <answer> + <para>��� ������������� ���������� �����, �������� ��������� + � �������, ��� ������������ � ����������� � ������ ��������, + ���������� ���������� ������������ �����������. � ������ + ������ <wordasword>������� ���������</wordasword> �������� + ������ ������ ��� ��������� �����������. ��������� ����� + ������� ��������� ������ + <filename>print/ghostscript*</filename> � ���������� � + �������������� ������ + <filename>x11-wm/windowmaker*</filename>.</para> + + <para>������ �������� �������� ������������� ��������� ���� �� + ������ ����������� � ������, ��� ������������� �������, ����� + ����� ������ ��� ����� ���������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>����� ������������ ����������� <emphasis>��</emphasis> + ���������?</para> + </question> + + <answer> + <para>���� ��� �������, ������� ������ �� ���������. ��� �����, + ������������ � ������������ ��������� � ����� �� �������������, + ����� ������ ���������� ��������� ������� + <command>cvs remove</command> ��� ������� �������� � + <command>addport</command> ��� ������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ����� ������?</para> + </question> + + <answer> + <para>�������� � <application>GNATS</application> PR, ������ + ������� ������������� �����������. ��������� �������������� + �� <literal>portmgr</literal> � ���������� ������ + (<varname>state</varname>) � ��������� + <literal>repocopy</literal>. ���� ��� ������ ����� ������� + ������� &a.portmgr;, �� ����� ������������� �� + <literal>pcvs</literal>. &a.portmgr; ����� ���������� + ����������� ��������� ��������������; � ��������� ������ + ������ &a.pcvs; ���������� ���������� + ����������� � ������ ��� ��� PR. ����� �����, ��� ���������� + ��������� ���������:</para> + + <itemizedlist> + <listitem> + <para>����� ������������� ����������� �����:</para> + + <procedure> + <step> + <para>�������� ����� ������� ����� �� ����� ������ + (�� �������� �������� ������ <makevar>PORTNAME</makevar>, + ����� �� �������� ���� ������ � ����� ������).</para> + </step> + + <step> + <para>�������� ����� ������� � ������ + <makevar>SUBDIR</makevar> � ������������ ����� + Makefile. ��� �������� �� ������ ��������������� + �������� <command>make checksubdirs</command>.</para> + </step> + + <step> + <para>���� ���� ����� ���������, �������� ������ + <makevar>CATEGORIES</makevar> � ����� + <filename>Makefile</filename>.</para> + </step> + + <step> + <para>�������� ������ ��� ������ ������.</para> + </step> + + <step> + <para>�������� ������ � ���� + <filename>ports/MOVED</filename>.</para> + </step> + </procedure> + </listitem> + + <listitem> + <para>��� �������� �����:</para> + + <procedure> + <step> + <para>��������� ��������� ��������� �� ������� ������, + ��������� �� ���������� � �������� �� ��� �������������. + ���������� ������� <command>grep</command> �� ����������� + ����� <filename>INDEX</filename> ������������, ��������� + ��������� ����� ����� ���� ���������������� �� ����� + ������. ������������� ������������ ������ ����� ��� + ������ ������� <command>grep -r</command>.</para> + </step> + + <step> + <para>������� ������ ����, ������ <makevar>SUBDIR</makevar> + � ������, ����������� ������.</para> + </step> + + <step> + <para>�������� ������ � ���� + <filename>ports/MOVED</filename>.</para> + </step> + </procedure> + </listitem> + + <listitem> + <para>����� ������������� ����������� (�������� + <quote>��������������</quote>, ����� ����� ����������� + ������ ������� ���������):</para> + + <procedure> + <step> + <para>����������� ��������� �� ���������� ���� ������� ��� + ��������� ������ ����� � �������� �������.</para> + </step> + </procedure> + </listitem> + </itemizedlist> + </answer> + </qandaentry> + </qandadiv> + + <qandadiv> + <title>��������� ������</title> + + <qandaentry> + <question> + <para>��� ����� <quote>��������� ������</quote>?</para> + </question> + + <answer> + <para>����� �������� ������ ��� ���������� ����������� ��������� + ������ ������� ��������� �� ��������� ����� ���������� + ������� � ������ ������. ���� ������� � ���������� + <quote>���������� ������</quote>.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>������� ������ ���������?</para> + </question> + + <answer> + <para>������ ���-������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ��� ������ ��� ����?</para> + </question> + + <answer> + <para>�� ����� ��������� �� �� ������ ����������� �����-���� + ������� � ������ ������ ��� ������� ���������� ����-���������. + <quote>������ ����������</quote> ����� �������� ���� ��:</para> + + <itemizedlist> + <listitem> + <para>�� �������� �������������� ��������� ����-��������� + � �������� ����� <quote>������, ����������� + ������</quote>.</para> + </listitem> + + <listitem> + <para>����-�������� ������� ��� ��� � ������ �������� ������ + � ���������� � ���, ��� ���� �� �������� � ��� ������ ���� + ����������.</para> + </listitem> + </itemizedlist> + + <para>�������, ��� � ��� ��� ���������������� ���������� + ���������� ������������ ���� � ������ ��������� ������ ������, + ��� ���� �� ��������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>������ � ����� � ������ ������� ���������?</para> + </question> + + <answer> + <para>������ �� 2-3 ������ �� ������ ������� ��������� + ����-�������� �������� ������ � ��������������� �� ���� � + &a.ports; � &a.committers;. ������ ����� ������ ������� + ��������� ������������ �� ��������� ���� �� ���������� + ������, ��������� ����������� ������ ������ ������ ���� + ���������������� � �������, � ������ ���� ������� + ������������ �� ���� ����.</para> + + <para>����������, ����� ������ ������� ��������� � + &a.committers; ����� ���������� ��� ���� ��������������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ������, ����� ������ ��������� ������ ����������?</para> + </question> + + <answer> + <para>���������� ������� ��������� ������������ ����-���������� + �������� ������ � &a.ports; � &a.committers; ����� ��������� + ����� ����� ������. �������, ��� ���� ������� ������ �� + �������� ��������������� ���������� ���������. ��� ����������� + ���������, ��� � ��������� ������ �� ��������� ������ + ���������������, ��� ��������� �� ������������� �����.</para> + </answer> + </qandaentry> + </qandadiv> + + <qandadiv> + <title>�������� ����� ���������</title> + + <qandaentry> + <question> + <para>������ ��������� �������� ����� ��������� ������?</para> + </question> + + <answer> + <para>�����������, ������������ ����� ���������, ������ + ����������� ��������� ����������� �� ��������, � ��� ����� + �������� ������, �� ������� ������� ������ ��������� + ������������, � ����� ������ ������, ����������� � ����� + ���������.</para> + + <para>������ ��� ���������� ������, �������, ��� ������� ��������� + ���������� ������� ��� �� ������ ����������, �������� �������, + ��� ������������ ���������� ��������� ������ ������ �������, �, + �������, ��� �������� ����������� ��������� ������� ����� � + ����������� �� �������.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ������� �������?</para> + </question> + + <answer> + <para>��������� �������� ����������� ��� ��� ��������� ���������� + ������������� ����������� ���������� �����.</para> + + <para>�������� � <application>GNATS</application> PR � ��������� + ������ ��� �������� ����� ���������. ����������, ����� ������ + �������� ����� � ������ <filename>Makefile</filename> + ����������� ������, �� ������ ���������, � ����� � ����������� + ������ <makevar>VALID_CATEGORIES</makevar> � ����� + <filename>ports/Mk/bsd.port.mk</filename>. ��������� PR ������ + &a.portmgr; (<literal>portmgr</literal>). ���� ����-�������� + ������� ���������, �� �������� PR ������ &a.cvsadm; + (<literal>cvs</literal>), ���� �� ������ ������� �������� + ����������� � ������ PR ���. � ���������� ��� ����� ���������� + ��������� ��������:</para> + + <procedure> + <step> + <para>�������� ����� <filename>Makefile</filename> ��� ���� + ������������ ������. ���� �� ���������� ����� ��������� + � ������� ���������� �������.</para> + + <para>��� ����� ��� ����������:</para> + <procedure> + <step> + <para>������� ��� ���� ������ �������� ���������� + <makevar>CATEGORIES</makevar> (��� � ���� ����� + �����, �� ������ ��?) ����� ��������� ������ ���� + ������� � ������ <emphasis>������</emphasis>, ��� + ������� ���������, ��������� �� ����������� + ���������� <makevar>PKGORIGIN</makevar>.</para> + </step> + + <step> + <para>��������� ������� <command>make + describe</command>. ��������� ��������� ���������� + �������� ������� <command>make index</command>, + ������� ��� ��������� ��������� ��������� �����, + ���������� ������ <command>make describe</command>, + ����������� ������ ������ ��������� ��� ������ + ������� � �������.</para> + </step> + + <step> + <para>���� �� ������ ���� ������ �������, ����� ����� + ��������� &man.portlint.1;.</para> + </step> + </procedure> + </step> + + <step> + <para>��������� ������������ ���������� + <makevar>PKGORIGIN</makevar>. ������� ������ � ������� + ���������� �������� ���������� + <makevar>CATEGORIES</makevar> ��� ��������� ���������� + <makevar>PKGORIGIN</makevar>, ������� ����� ������������ + ��� ����� ������������� ������� � ���������� ������ + ������. ���� ��� ����� ����������� �����������, ���������� + ��������� ��������������� ������� ������ � �������, ����� + ��� &man.pkg.version.1; � &man.portupgrade.1;.</para> + + <para>��� �������� ������� ������������ ������ + <filename>chkorigin.sh</filename>: <command>env + PORTSDIR=<replaceable>/path/to/ports</replaceable> + sh -e <replaceable>/path/to/ports</replaceable>/Tools/scripts/chkorigin.sh + </command>. ��� ������� �������� + <emphasis>������</emphasis> ���� � ������, � ��� ����� � + ��, ��� �� �������� � ������� ������, ��� ��� �� ����� + ������������ ����� ����� ������������� �����������. + �����: �� �������� ��������� <makevar>PKGORIGIN</makevar> + ��� ��������� �� ���������� ���� ������!</para> + </step> + + <step> + <para>������������� ��������� ��������, �� ����� ������: + ��������������� ������ <makevar>SUBDIR</makevar> ��� + ������ ������, ����� ��������� ��������� ����� + ��������� � ����� <filename>ports/Makefile</filename>. + ��������� <command>make checksubdirs</command> � + ������������� ����������. �������, ��������� � �������� + <filename class="directory">ports/</filename> ������� + <command>make index</command>. �� ���������� ����� ������ + �� 40 ����� ���� �� ����������� ������, ������, ��� + ����������� ������� ��� ����, ����� �� ������� ������� + ��� ������.</para> + + <step> + <para>����� ���������� ���� �������� �� ������ ������� � + ����������� ��������� <filename>ports/Makefile</filename> + ��� ��������� ����� ��������� � ������� ������, � ����� + ����������� ������ ��������� <filename>Makefile</filename> + ��� ������ ���������.</para> + </step> + + <step> + <para>��������� ������ ��� ���������� ������� � ����� + <filename>CVSROOT-ports/modules</filename>.</para> + </step> + + <step> + <para>�������� ������ ������ � ���� + <filename>ports/MOVED</filename>.</para> + </step> + + <step> + <para>�������� ������ ��������� ��� &man.cvsup.1; � ����� + <filename>distrib/cvsup/sup/README</filename> � �������� + ��� ����� � ������� + <filename>cvsup/sup/ports-categoryname</filename>: + <filename>list.cvs</filename> � + <filename>releases</filename>. (�������� ��������: ��� + ����� ����������� � ����������� src, � �� ports).</para> + </step> + + <step> + <para>�������� PR � ��������� ������������ (doc) ��� + ���������� ����� ��������� ������ � <ulink + url="&url.books.porters-handbook;/makefile-categories.html#PORTING-CATEGORIES"> + ����������� FreeBSD �� �������� ������</ulink> � � ���� + <filename>www/en/ports/categories</filename>.</para> + </step> + + <step> + <para>��������� ���������� <ulink + url="&url.base;/ports/index.html">���-����������� ������</ulink> + ���� �� ����������.</para> + </step> + + <step> + <para>������ �������� ������ ����� ���� ������� �� + ����������� ������ ����� ����, ��� ��� ��������� ��������� + ����� ���������, � ����� �� �������� �� ����� ���������.</para> + </step> + </procedure> + </answer> + </qandaentry> + </qandadiv> + + <qandadiv> + <title>������ �������</title> + + <qandaentry> + <question> + <para>��� ��� ���������, ��� ��� ���� ��������� ����������?</para> + </question> + + <answer> + <para>� ������ ������� ��������� ���� ���� �� ������ + <ulink url="http://pointyhat.FreeBSD.org/errorlogs/"></ulink>. + ��� �� ������� ������� ������ ������� �� ���� �������������� + ������������ ��� ����������� ��������� ������ ����������.</para> + + <para>�������, ���������� ������ ����� ����� �������� � �������� + ��� �� ������, ��� �� ������� ���������� (��������, ����� �� + ���������� ���� �� ��������� ������). ����������� ���������� �� + ������ ����� �� ������ <hostid>pointyhat</hostid> � ��������� + <filename class="directory">/a/portbuild/<arch>/<major_version></filename>. + ������ ���� ����������� � ������� ������ �������� ��������� + �����������:</para> + +<programlisting>errors ������� ������ ��������� ������ ������ <major_version> �� ��������� <arch> +logs ��� ������� ��������� ������ ������ <major_version> �� ��������� <arch> +packages �������������� ������ ��� ������ <major_version> �� ��������� <arch> +bak/errors ������� ������ ��������� ������ ������ ������ <major_version> �� ��������� <arch> +bak/logs ��� ������� ��������� ������ ������ ������ <major_version> �� ��������� <arch> +bak/packages ������ ��������� ������ ������ ������ <major_version> �� ��������� <arch></programlisting> + + <para>����� �������: �����, �������������� � �������� + <filename>packages</filename> ��� �������� + <filename>logs</filename>, � ��� ���� ������������� � + <filename>errors</filename>, �������� �������. (������ �������� + <filename>errors</filename> �� ������ �� ���-������� + <hostid>pointyhat</hostid>).</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>� ������� ����� ����. ����� �� ��������� ��� � ���� + <filename>INDEX</filename>?</para> + </question> + + <answer> + <para>���. ����-��������� ����� ������ ������� �������������� + <filename>INDEX</filename> � ������ ��� � ����������� + &os;.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>����� ��� ����� � �� ������ �������?</para> + </question> + + <answer> + <para>����� ���� � �� ������� ������ <filename>ports/</filename>, + � ����� ��� ����� � ���������, ����� ������� ���������� � + ��������� ����� (��������, <filename>Mk/</filename>, + <filename>Tools/</filename> � �.�.). � ���������, ����� ��� + ��� ������� ����� <filename>ports/Mk/bsd.port*.mk</filename>, + ���� �� �� ������ �������� ����-���������� � ������!</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>����� ���������� ������� ���������� �����, ����� ��� + �������� ����� ���������, �� �� ������ ���?</para> + </question> + + <answer> + <para>��� ������������� ��������, ����� ����� ��������� + �������������� ����� ��� ��������� �������������� ������, + ��������� � ������� ������ ��������� ��������� �������� ����� + ���������� � ����������� ���������� ������, ����� ����� ���� + ���������, ��� ����� �� �������� � �� �������� ���������������. + ���� ������� ������ ����� ������������ ����������� �����, ����� + ������ ����� �������� �� ftp-�������� �������; � ��������� + ������ ������� ��������� � ������� ��� ������������ ����� ��� + ��������� ������ ������ ������.</para> + </answer> + </qandaentry> + </qandadiv> + </qandaset> + </sect1> + + <sect1 id="perks"> + <title>������� � ������ ������</title> + + <para>���, �����, ����������� �� ����, ��� �� ��������� �����������, + �� ��� �� �����. �������, ������������ ����������� �������������� + ������������� ����� ��������� ��� ��� ������������� �����������. + ��� �� �����, ���-����� ������ ��� �� ����������:</para> + + <variablelist> + + <varlistentry> + <term>������ ������ � ������ <hostid>cvsup-master</hostid></term> + + <listitem> + <para>������ �����������, �� ������ ���������� � &a.kuriyama;, ����� + �������� ������ � ������ + <hostid role="fqdn">cvsup-master.FreeBSD.org</hostid>, �������� + ����� ������� <command>cvpasswd + <replaceable>yourusername</replaceable>@FreeBSD.org + freefall.FreeBSD.org</command>. �������� ��������: � ��������� + ������ �� ������ ������� <hostid>freefall.FreeBSD.org</hostid>, + ���� �������� �������� ����� <hostid>cvsup-master</hostid>. + �������� � <hostid>cvsup-master</hostid> �� ������� ��������������: + ��� ������ ����������� ������.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>���������� �������� �� �������� �� 4 CD ��� DVD</term> + + <listitem> + <para>�������� <ulink url="http://www.freebsdmall.com">FreeBSD Mall, + Inc.</ulink> ������������� ��� ���� ����������� FreeBSD ����������� + ���������� �������� �� ������� FreeBSD. ������� �������� ���������� + � ������ �������� <email>developers@FreeBSD.org</email> ����� + ������� ������.</para> + </listitem> + </varlistentry> + + </variablelist> + </sect1> + + <sect1 id="misc"> + <title>������ �������</title> + + <qandaset> + <qandaentry> + <question> + <para>������ �� ������� ������� ������������ ��������� � ����� + ������������ (vendor branches)?</para> + </question> + + <answer> + <itemizedlist> + <listitem> + <para>����� ����� �������� ������ ����� ����� �� ������������ + ������� ������� ���������� � ����������� ������.</para> + </listitem> + + <listitem> + <para>��� ����, ������ ����� ����� �� ������������ ������� + ������ <emphasis>��������</emphasis> ����������� ������.</para> + </listitem> + + <listitem> + <para>����� CVS <option>-j</option> �� ������ ������ ��������. + ������ �������� &a.obrien;, �� ��������� ��� ������ + �������.</para> + </listitem> + </itemizedlist> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ��� �������� ���� � ����� CVS?</para> + </question> + + <answer> + <para>��� ���������� ����� � ����� ������ �������� �������� ����� + �� ������ �����, � ����� ����������� ������� + <command>cvs add</command>. ��������, ���� �� ������ ��������� + ���� <filename>src/sys/alpha/include/smp.h</filename> �� ����� + HEAD � ����� RELENG_4, � ������� �� ���� �� ����������, ����� + ������������ ��������� ������������������ ��������:</para> + + <example> + <title>MFC ��� ������ �����</title> + + <screen>&prompt.user; <userinput>cd sys/alpha/include</userinput> +&prompt.user; <userinput>cvs update -rRELENG_4</userinput> +cvs update: Updating . +U clockvar.h +U console.h +... +&prompt.user; <userinput>cvs update -kk -Ap smp.h > smp.h</userinput> +=================================================================== +Checking out smp.h +RCS: /usr/cvs/src/sys/alpha/include/smp.h,v +VERS: 1.1 +*************** +&prompt.user; <userinput>cvs add smp.h</userinput> +cvs add: scheduling file `smp.h' for addition on branch `RELENG_4' +cvs add: use 'cvs commit' to add this file permanently +&prompt.user; <userinput>cvs commit</userinput> + </screen> + </example> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>����� <quote>����-����������</quote> � ������ �������� � + ��������� ��� �������?</para> + </question> + + <answer> + <para>������ �������������� �������� ���������� ������� ��� ����� + ������������� �������� � ��������� �������������� + ����������.</para> + + <para>��� ������� �� ����� ��� ���������� ����� ����: �������� ����� + ��� ��������������, ���������, ��������� ��� ��������������, + ���������� �������������� ����������.</para> + + <para>��������� ������� ����� ����:</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry><literal>PR:</literal></entry> + <entry>������������� ��������� �� ������, �������������� + (��� �������, ������������) ������ ��������.</entry> + </row> + + <row> + <entry><literal>Submitted by:</literal></entry> + <entry>��� � e-mail ����� ����������� �����������; ��� + ����������� — ������ ��� ������������ � + �������� FreeBSD.</entry> + </row> + + <row> + <entry><literal>Reviewed by:</literal></entry> + <entry>��� � e-mail ����� ���� ��� ���, ��� ������������ + ���������; ��� ����������� — ��� ������������ � + �������� FreeBSD. ���� ��������� ���� ������� � ������ + �������� �� �������� � �������� ���������, ��� ������ + ��������.</entry> + </row> + + <row> + <entry><literal>Approved by:</literal></entry> + <entry>��� � e-mail ����� ���� ��� ���, ��� ������� + ���������; ��� � ������, ��� ����������� ������ ��� + ������������ � ��������. ������� ��������� �������� + ��������� ��������� ��� �������� � ����� ��� ��� ������� + ������. ����� ����, � ������ ����� ������ ������� ��� + ������� <emphasis>������</emphasis> ���� �������� ������� + ����������� ���������. � ������ ����� ������ �������� + �� ������ �������� ��������� �� ��� � ������ �������, � + ��������� ��� � ���� + <quote><replaceable>username-of-mentor</replaceable> + <literal>(mentor)</literal></quote>. + </entry> + </row> + + <row> + <entry><literal>Obtained from:</literal></entry> + <entry>��� �������, �� ��������� ���� �������� ���� ����� + ���������.</entry> + </row> + + <row> + <entry><literal>MFC after:</literal></entry> + + <entry>���� �� ������ �������� �� ����� ����������� �� + <acronym>MFC</acronym>, ������� ����� ����, ������ ��� + ������� � ������� ������������ �������, ����� ������� + �� ���������� ���������� <acronym>MFC</acronym>.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <example> + <title>��������� ��� �������, ����������� �� PR</title> + + <para>�� ����������� ������ ������, ���������� �� PR, ���������� + John Smith � ���������� ���� ��� ����������� ��������. ���� + ��������� ������ ������������� �������� ������ ��������:</para> + + <programlisting>... + +PR: foo/12345 +Submitted by: John Smith <John.Smith@example.com></programlisting> + </example> + + <example> + <title>��������� ��� �������, ���������� ��������</title> + + <para>�� ����������� �������� ���������� ������ � ����������� + �������. �� ������������ �������������� ��������� � + ��������������� ������ �������� (� ������ ������ + <literal>freebsd-arch</literal>), � ��������� ���� + ��������.</para> + + <programlisting>... + +Reviewed by: -arch</programlisting> + </example> + + <example> + <title>��������� ��� �������, ���������� ���������</title> + + <para>�� �������� ���������� ������ � ������� ������, ��� ������� + ��������� ������� (MAINTAINER). �� ��������������� ������ � + ������������, � �� ������������ <quote>�������. ��������� + ������.</quote></para> + + <programlisting>... + +Approved by: <replaceable>abc</replaceable></programlisting> + + <para>��� <replaceable>abc</replaceable> ��� ������������, + ����������� ��� ������.</para> + </example> + + <example> + <title>��������� ��� �������, ������������� ��� OpenBSD</title> + + <para>�� ����������� ������ ���������, ���������� �� ����, + �������������� �������� OpenBSD.</para> + + <programlisting>... + +Obtained from: OpenBSD</programlisting> + </example> + + <example> + <title>��������� ��� �������, ������������ ���������� �� + &os.current; � &os.stable; ����� ��������� �����</title> + + <para>�� ������ ������ ���������, ������� ������ ���� ������������� + �� &os.current; � ����� &os.stable; ����� ��� ������.</para> + + <programlisting>... + +MFC after: <replaceable>2 weeks</replaceable></programlisting> + + <para>��� <replaceable>2</replaceable> �������� ����������� ����, + ������ ��� �������, ����� ������� �� ���������� ������������� + (<acronym>MFC</acronym>) � &os.stable;. � �������� + <replaceable>weeks</replaceable> ����� ���� ������������ + <literal>week</literal>, <literal>weeks</literal>, + <literal>month</literal>, <literal>months</literal>, ���� + ���� �������� ����� ���� ������ (��� ���� ��������������� + <replaceable>X</replaceable> ����).</para> + </example> + + <para>� ��������� ������� ��� ����������� ������������� ����������� + �������.</para> + + <para>���������� ��������, ����� ����� ������� ��������� �� ������, + ���������� ��� �� ������� NetBSD. �� ���������������� ���� + �������, �� �� ���������� � ��� ����� ������, � ������� �� ������ + �� ���������, ��� ��� �� ������� ������ ��������� �� ������������ + ������ �������� <literal>arch</literal>. ��������� ��������� ���� + ���������� ������, �� ������� ������������� �� + (<acronym>MFC</acronym>) ����� �����, ����� ���������� ���������� + ����� ��� ������������.</para> + + <para>� ��������� ������ ��������� ��� ������� ����� ��������� + �������� ���:</para> + + <programlisting>PR: foo/54321 +Submitted by: John Smith <John.Smith@example.com> +Reviewed by: -arch +Obtained from: NetBSD +MFC after: 1 month</programlisting> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ��� �������� ������ � <hostid + role="fqdn">people.FreeBSD.org</hostid> ��� ���� ����� ���������� + ��� ������������ ���������� ��� ���������� � ���� ��������?</para> + </question> + + <answer> + <para><hostid role="fqdn">people.FreeBSD.org</hostid> — + ������� ��� <hostid role="fqdn">freefall.FreeBSD.org</hostid>. + ������ �������� ������� <filename>public_html</filename>. ���, + ��� �� ���������� � ���, ����� ������������� �������� �� ������ + <ulink url="http://people.FreeBSD.org/"></ulink>.</para> + </answer> + </qandaentry> + + <qandaentry> + <question> + <para>��� ����������� ������ ������� ��������?</para> + </question> + + <answer> + <para>������ �������� ������������ � �������� ��������� + <filename>/g/mail</filename>, ������� �� ���� ������� �������� ��� + <filename>/hub/g/mail</filename> (��. &man.pwd.1;). + </answer> + </qandaentry> + </qandaset> + </sect1> +</article>