From e1cabaaef94e4191f7122bc13566e3cc4e12039a Mon Sep 17 00:00:00 2001
From: Taras Korenko <taras@FreeBSD.org>
Date: Tue, 23 Jul 2013 06:44:24 +0000
Subject: [PATCH] + ru/handbook: add translation of "pkgng-intro" subsection.

---
 ru_RU.KOI8-R/books/handbook/ports/chapter.xml | 383 +++++++++++++++++-
 1 file changed, 378 insertions(+), 5 deletions(-)

diff --git a/ru_RU.KOI8-R/books/handbook/ports/chapter.xml b/ru_RU.KOI8-R/books/handbook/ports/chapter.xml
index 319cfe473d..d3e4054e92 100644
--- a/ru_RU.KOI8-R/books/handbook/ports/chapter.xml
+++ b/ru_RU.KOI8-R/books/handbook/ports/chapter.xml
@@ -7,7 +7,6 @@
 
      Original revision: r41718
 -->
-<!-- Translation of <sect1 id="pkgng-intro"/> is currently not available. -->
 
 <chapter id="ports">
   <chapterinfo>
@@ -606,11 +605,385 @@ docbook                     =
   </sect1>
 
   <sect1 id="pkgng-intro">
-    <!-- XXX Not translated yet -->
-    <title>*Using <application>pkgng</application> for Binary Package
-      Management</title>
+    <title>������������� <application>pkgng</application> ��� ����������
+      ��������� ��������</title>
 
-    <para>���� ������ �� ���������.</para>
+    <para><application>pkgng</application> &mdash; ��� �������������������
+      ����������, ��������� �� ����� ������������ �������� ���������� ��������
+      &os;.  �� �������� ���������� �������������� ������������, ����������
+      � ����������� ������ � ��������� ��������.  ������ �����
+      <application>pkgng</application> ��������� � ������� 2012 ����.</para>
+
+    <para><application>pkgng</application> �� �������� ������� ��� ������
+      ���������� �������, ����� ���
+      <filename role="package">ports-mgmt/portmaster</filename> ���
+      <filename role="package">ports-mgmt/portupgrade</filename>.  � �� �����,
+      ��� <filename role="package">ports-mgmt/portmaster</filename> �
+      <filename role="package">ports-mgmt/portupgrade</filename> ���������
+      ������������� ���������� ��������� ������������� ��� �� ��������
+      �������, ��� � ��
+      ��������� ������, ������� <application>pkgng</application>
+      ���� ����������� ������������� ���������� ������������� �� ��������
+      �������.</para>
+
+    <sect2 id="pkgng-initial-setup">
+      <title>������ ������ � <application>pkgng</application></title>
+
+      <para>�� &os;&nbsp;9.1 � ����� ������� �������� ���������
+	&quot;�������������&quot; (&quot;bootstrap&quot;)
+	<application>pkgng</application>.  ��� ��������� � �������������
+	�������� ������� <application>pkgng</application>.</para>
+
+      <para>��� ������� �������������, ���������:</para>
+
+      <screen>&prompt.root; <userinput>/usr/sbin/pkg</userinput></screen>
+
+      <para>��� ����� ������ ������ &os; �������
+	<application>pkgng</application> ���������� ���������� �� ���������
+	������ ��� �� �������� �������.</para>
+
+      <para>��� ��������� <application>pkgng</application> �� �����, ���������
+	���������:</para>
+
+      <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/pkg</userinput>
+&prompt.root; <userinput>make</userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+      <para>��� ��������� �� ��������� ������, ���������:</para>
+
+      <screen>&prompt.root; <userinput>pkg_add -r pkg</userinput></screen>
+
+      <para>����������� ����������� &os; ������� �������������� ���� ������
+	������������� ������� ������� <application>pkg_install</application>
+	� ������ �������.  ��� ���������� ���������������, ���������:</para>
+
+      <screen>&prompt.root; <userinput>pkg2ng</userinput></screen>
+
+      <para>��������������� ��� �� ��������� ��� ����� �����������, � �������
+	�� ���� ����������� �������� ��������� �������������.</para>
+
+      <important>
+	<para>���� ��� ���������.  ����� �������� ���� ������ �������������
+	  ������� � ������� <application>pkgng</application> ���������
+	  <application>pkg_install</application> ����� ������������
+	  �� �������.</para>
+      </important>
+
+      <note>
+	<para>� �������� ��������������� ���� ������ ������������� �������
+	  ����� ��������� ��������� �� �������.  �� ������ ����� �� �����
+	  ������������, ��� ��� �������� �������� ��������� �������������,
+	  ���������� � ������� �� ���� �������������, ����� ����������
+	  �� ���������� ������ <command>pkg2ng</command>.  ��� ���� ��������
+	  �������� ���������� �������.</para>
+      </note>
+
+      <para>����� ���������, ��� ��������� ������&nbsp;&os; ������������
+	����� ��������� ��� ������ <application>pkgng</application>, � ��
+	<application>pkg_install</application>, ��� ������ &os;, ��������������
+	10.<replaceable>X</replaceable>, � ����
+	<filename>/etc/make.conf</filename> ���������� ������ ���������
+	������:</para>
+
+      <programlisting>WITH_PKGNG=	yes</programlisting>
+    </sect2>
+
+    <sect2 id="pkgng-pkg-conf">
+      <title>��������� ��������� <application>pkgng</application></title>
+
+      <para>������� ���������� �������� <application>pkgng</application>
+	��� ���������� ����������� �������� ���������� � ���������
+	�����������.  ����� ������������� �� ��������� ����������� ������
+	� <filename>/usr/local/etc/pkg.conf</filename> ��� � ����������
+	��������� <envar>PACKAGESITE</envar>.  ��������� ��������������
+	�����, ��������� � ���������������� �����.</para>
+
+      <para>�������������� ����� ������������ <application>pkgng</application>
+	������� � pkg.conf(5).</para>
+    </sect2>
+
+    <sect2 id="pkgng-basic-usage">
+      <title>�������� �������� <application>pkgng</application></title>
+
+      <para>���������� �� ������ � <application>pkgng</application> �����
+	����� �� �������� ����������� pkg(8), ��� � ������ �������
+	<command>pkg</command>, ���������� ��� ����������.</para>
+
+      <para>������ �������� ������� <application>pkgng</application> ������ ��
+	��������������� �������� �����������.  ��������, ����� ������������
+	�� ��������� ����������� ��� <command>pkg install</command>,
+	��������� ����� �� ���� ������������� ������:</para>
+
+      <screen>&prompt.root; <userinput>pkg help install</userinput></screen>
+
+      <screen>&prompt.root; <userinput>man pkg-install</userinput></screen>
+
+      <sect3 id="pkgng-pkg-info">
+	<title>��������� ���������� �� ������������� ������� ��� ������
+	  <application>pkgng</application></title>
+
+	<para>���������� �� ������������� � ������� ������� ����� ����
+	  ���������� ��� ������ ������� <command>pkg info</command>.  �������
+	  �� &man.pkg.info.1;, � ������ ������������� ������ � �������� ����
+	  ������������� �������.</para>
+
+	<para>���� ���������� ���������� � ���������� ������, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg info <replaceable>packagename</replaceable></userinput></screen>
+
+	<para>��������, ��� ��������� ������ <application>pkgng</application>,
+	  ������� ���������� � �������, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg info pkg</userinput>
+pkg-1.0.2			New generation package manager</screen>
+      </sect3>
+
+      <sect3 id="pkgng-installing-deinstalling">
+	<title>��������� � �������� ������� ��� ������
+	  <application>pkgng</application></title>
+
+	<para>� �����, �������� ������ ��������������� ��� ������:</para>
+
+	<screen>&prompt.root; <userinput>pkg install <replaceable>packagename</replaceable></userinput></screen>
+
+	<para>������� <command>pkg install</command> ���������� � ���������
+	  �����������, ��� ����������� � <xref linkend="pkgng-pkg-conf"/>.
+	  ������� pkg-add(8), ��������, �� ��������� ��������� � ���������
+	  �����������, � ����� ���������� ����������
+	  <envar>PACKAGESITE</envar>.  ��� ��������� &mdash; �����������
+	  �� �������������, � ����������� ��������� ���������� �� �����������
+	  � ���������� ���������.  � ���� ������� ������� ������ �
+	  <command>pkg install</command>.  �� ������������� ������ �
+	  <command>pkg add</command> ���������� � ���������� �������� ��
+	  pkg-add(8).</para>
+
+	<para>������� <command>pkg install</command> ����� �������������
+	  �������������� �������� ������.  ��������, ��� ���������
+	  <application>curl</application>, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg install curl</userinput>
+Updating repository catalogue
+Repository catalogue is up-to-date, no need to fetch fresh copy
+The following packages will be installed:
+
+	Installing ca_root_nss: 3.13.5
+	Installing curl: 7.24.0
+
+The installation will require 4 MB more space
+
+1 MB to be downloaded
+
+Proceed with installing packages [y/N]: <userinput>y</userinput>
+ca_root_nss-3.13.5.txz		100%	255KB 	255.1KB/s 255.1KB/s	00:00
+curl-7.24.0.txz			100%	1108KB	1.1MB/s	1.1MB/s		00:00
+Checking integrity... done
+Installing ca_root_nss-3.13.5... done
+Installing curl-7.24.0... done</screen>
+
+	<para>����� �����, ��� � ����� �������������� ������, ������� ����
+	  ����������� ��� �����������, ������������� � ������ �������������
+	  �������:</para>
+
+	<screen>&prompt.root; <userinput>pkg info</userinput>
+ca_root_nss-3.13.5	The root certificate bundle from the Mozilla Project
+curl-7.24.0	Non-interactive tool to get files from FTP, GOPHER, HTTP(S) servers
+pkg-1.0.2	New generation package manager</screen>
+
+	<para>������, � ������� ����� ��� �������������, ����� ���� �������
+	  ��� ������ <command>pkg delete</command>.  ��������, ���� ���������,
+	  ��� <application>curl</application> �� �����:</para>
+
+	<screen>&prompt.root; <userinput>pkg delete curl</userinput>
+The following packages will be deleted:
+
+	curl-7.24.0_1
+
+The deletion will free 3 MB
+
+Proceed with deleting packages [y/N]: <userinput>y</userinput>
+Deleting curl-7.24.0_1... done</screen>
+      </sect3>
+
+      <sect3 id="pkgng-upgrading">
+	<title>���������� ������������� ������� ��� ������
+	  <application>pkgng</application></title>
+
+	<para>������, ������ ������� ��������, ����� ����� ��� ������ �������
+	  <command>pkg version</command>.  ������ ������������� �������
+	  ������������ � �������� ���������� �� ���������� ������ ������,
+	  � � ������ ���������� ������ pkg-version(8) ���������� � ����������
+	  ����������� �������.</para>
+
+	<para>��� ������ <application>pkgng</application> ����� ���������
+	  ������ �� ����� ������.  �����������, ����� ����� ������
+	  <application>curl</application>.  ������������� ����� �����
+	  �������� � ����� ������, ��������:</para>
+
+	<screen>&prompt.root; <userinput>pkg upgrade</userinput>
+Updating repository catalogue
+repo.txz		100%	297KB 296.5KB/s 296.5KB/s	00:00
+The following packages will be upgraded:
+
+	Upgrading curl: 7.24.0 -> 7.24.0_1
+
+1 MB to be downloaded
+
+Proceed with upgrading packages [y/N]: <userinput>y</userinput>
+curl-7.24.0_1.txz	100% 1108KB	1.1MB/s	1.1MB/s		00:00
+Checking integrity... done
+Upgrading curl from 7.24.0 to 7.24.0_1... done</screen>
+      </sect3>
+
+      <sect3 id="pkgng-auditing">
+	<title>����� ������������ ������� ��� ������
+	  <application>pkgng</application></title>
+
+	<para>������� � ����������� �� ��������� ������ ��������������
+	  ����������.  � <application>pkgng</application> �������� �����������
+	  ��������� ����� ������������, ����������� ������� ���������� ��
+	  <filename role="package">ports-mgmt/portaudit</filename>.  ���
+	  ���������� ������ ������������� � ������� ��������, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg audit -F</userinput></screen>
+      </sect3>
+    </sect2>
+
+    <sect2 id="pkgng-advanced-usage">
+      <title>������� ������� ������ � <application>pkgng</application></title>
+
+      <sect3 id="pkgng-autoremove">
+	<title>�������������� �������� �������������� ������������ ���
+	  ������ <application>pkgng</application></title>
+
+	<para>����� �������� ������ � ������� ����� �������� ��������������
+	  �����������, ��������� <filename
+	    role="package">security/ca_root_nss</filename> �� ������� ����.
+	  ����� ������ �������� ��������������, �������� �� ��, ��� ���
+	  ����� �� ��������� ������ �������.  ���������� � �������
+	  �������������� ������, ������� ���� ����������� ��� �����������,
+	  ����� ��� ������:</para>
+
+	<screen>&prompt.root; <userinput>pkg autoremove</userinput>
+Packages to be autoremoved:
+	ca_root_nss-3.13.5
+
+The autoremoval will free 723 kB
+
+Proceed with autoremoval of packages [y/N]: <userinput>y</userinput>
+Deinstalling ca_root_nss-3.13.5... done</screen>
+      </sect3>
+
+      <sect3 id="pkgng-backup">
+	<title>��������� ����������� ���� ������ ������������� �������
+	  <application>pkgng</application></title>
+
+	<para>� ������� �� ������������ ������� ���������� ��������,
+	  <application>pkgng</application> ����������� ����� �����������
+	  ���������� ���������� ����������� ���� ������.  ��� ������� ��������
+	  ��������� ����� ���� ������ ������������� �������, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg backup -d <replaceable>pkgng.db</replaceable></userinput></screen>
+
+	<note>
+	  <para>�������� ��� ����� <replaceable>pkgng.db</replaceable> ��
+	    ����� ����������.</para>
+	</note>
+
+	<para>� ����������, <application>pkgng</application> �������� ������
+	  &man.periodic.8;, ����������� ��������� ���������� ��������������
+	  ����������� ���� ������ ������������� �������.
+	  ��� ��������� ������ ����������� ������� ����������
+	  <literal>daily_backup_pkgng_enable</literal> ��������
+	  <literal>YES</literal> � ����� &man.periodic.conf.5;.</para>
+
+	<tip>
+	  <para>��� �������������� �������������� ������� ������������ �������
+	    ������� <application>pkg_install</application>, ����� ������������
+	    ��������� ����������� ���� ������ ������������� �������, �������
+	    ���������� <literal>daily_backup_pkgdb_enable</literal> ��������
+	    <literal>NO</literal> � ����� &man.periodic.conf.5;.</para>
+	</tip>
+
+	<para>��� �������������� ����������� ���� ������ ������������� �������
+	  �� ��������� �����, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg backup -r <replaceable>/path/to/pkgng.db</replaceable></userinput></screen>
+      </sect3>
+
+      <sect3 id="pkgng-clean">
+	<title>�������� ����� ���������� ������� � �������
+	  <application>pkgng</application></title>
+
+	<para>�� ���������, <application>pkgng</application> ��������� �����
+	  ������������� �������� ������� � �������, ��������� ����������
+	  <envar>PKG_CACHEDIR</envar> � pkg.conf(5).  ��� ���������� �������
+	  �������� <command>pkg upgrade</command> ������ ������ �����������
+	  ������� ������������� �� ���������.</para>
+
+	<para>��� �������� ���������� ������ �������� ������� �� ���-��������,
+	  ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg clean</userinput></screen>
+      </sect3>
+
+      <sect3 id="pkgng-set">
+	<title>��������� ���������� �������
+	  <application>pkgng</application></title>
+
+	<para>�� �������� ��������� �� ��������� ������ ����� ������������
+	  ��������� �������� (major) ������ ������.  � ������� ��
+	  <application>pkg_install</application>,
+	  <application>pkgng</application> ����������� ���������� �������� ���
+	  ���������� ���������� � ������������� (origin) ������.  ��������,
+	  ���������� ���� <filename role="package">lang/php5</filename>
+	  ��� ������ <literal>5.3</literal>.  ����� ���� ���� ��� ������������
+	  � <filename role="package">lang/php53</filename>, � ��� ������
+	  <filename role="package">lang/php5</filename> ��� ������ ���� ������
+	  <literal>5.4</literal>.  �������� �������
+	  <application>pkg_install</application> ��� ���������� ����������
+	  � ������������� (origin) ������ � ����������� ���� ������
+	  ������������� ������� ������������� �� ������ ���������������
+	  ������������ �����������, ������ ���
+	  <filename role="package">ports-mgmt/portmaster</filename>.</para>
+
+	<para>� ������� ��
+	  <filename role="package">ports-mgmt/portmaster</filename> �
+	  <filename role="package">ports-mgmt/portupgrade</filename> ���
+	  ������, ������� ������������ ����� � ������ ������ ����������.
+	  ��� <application>pkgng</application> ��������� ���������
+	  �������:</para>
+
+	<screen>&prompt.root; <userinput>pkg set -o <replaceable>category/oldport</replaceable>:<replaceable>category/newport</replaceable></userinput></screen>
+
+	<para>��������, � ��������������� ������ ��� ������ ����������
+	  � ������������� ������, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg set -o lang/php5:lang/php53</userinput></screen>
+
+	<para>��� ���� ������: ��� ��������� ���������� � �������������
+	  ������ � <filename role="package">lang/ruby18</filename> ��
+	  <filename role="package">lang/ruby19</filename>, ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg set -o lang/ruby18:lang/ruby19</userinput></screen>
+
+	<para>� ��������� ������: ��� ������ ���������� � ������������� ������
+	  ����������� ���������� <filename>libglut</filename> �
+	  <filename role="package">graphics/libglut</filename> ��
+	  <filename role="package">graphics/freeglut</filename>,
+	  ���������:</para>
+
+	<screen>&prompt.root; <userinput>pkg set -o graphics/libglut:graphics/freeglut</userinput></screen>
+
+	<note>
+	  <para>�������� ������ ���������� � ������������� �������, �
+	    ����������� ������� ����� ��������� �������������� ������, �������
+	    ������� �� ������������� ������.  ��� �������������� �������������
+	    ��������� �������, ���������:</para>
+
+	  <screen>&prompt.root; <userinput>pkg install -Rf <replaceable>graphics/freeglut</replaceable></userinput></screen>
+	</note>
+      </sect3>
+    </sect2>
   </sect1>
 
   <sect1 id="ports-using">