Index: hb-portage-files.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/ru/handbook/hb-portage-files.xml,v
retrieving revision 1.7
diff -u -b -B -r1.7 hb-portage-files.xml
--- hb-portage-files.xml	31 Mar 2006 07:41:50 -0000	1.7
+++ hb-portage-files.xml	11 May 2007 21:43:41 -0000
@@ -10,8 +10,13 @@
 
 <sections>
 
-<version>1.7</version>
-<date>2005-06-27</date>
+<abstract>
+Чтобы поближе познакомиться с Portage, вам потребуется узнать, где же хранятся
+его файлы и данные.
+</abstract>
+
+<version>1.9</version>
+<date>2007-03-25</date>
 
 <section>
 <title>Файлы Portage</title>
@@ -293,9 +298,118 @@
 Portage может создавать отдельные файлы журнала для каждого файла ebuild, но 
 только тогда, когда переменная PORT_LOGDIR указывает на место, доступное для 
 записи для Portage (пользователя <e>portage</e>). По умолчанию эта переменная 
-не установлена.
+не установлена.  Если вы не установили PORT_LOGDIR, то вы не будете получать
+никаких сообщений от текущей системы журналирования, хотя сможете получать
+некоторые из них от нового <c>elog</c>. Если вы определили PORT_LOGDIR и
+используете elog, то вы будете получать сообщения о сборке и все сообщения,
+сохраненные elog, как это описывается ниже.
+</p>
+
+<p>
+Portage предлагает отточенный контроль над файлами журнала через использование
+<c>elog</c>:
 </p>
 
+<ul>
+  <li>
+    PORTAGE_ELOG_CLASSES &mdash; сообщения какого типа будут регистрироваться.
+    Вы можете использовать любую комбинацию из <c>info</c>, <c>warn</c>,
+    <c>error</c> и <c>log</c>, разделенных запятыми.
+    <ul>
+      <li>
+        info &mdash; регистрировать сообщения &laquo;einfo&raquo;, выводимые
+        файлом сборки
+      </li>
+      <li>
+        warn &mdash; регистрировать сообщения &laquo;ewarn&raquo;, выводимые
+        файлом сборки
+      </li>
+      <li>
+        error &mdash; регистрировать сообщения &laquo;eerror&raquo;, выводимые
+        файлом сборки
+      </li>
+      <li>
+        log &mdash; регистрировать сообщения &laquo;elog&raquo;, которые могут
+        быть найдены в некоторых файлах сборки
+      </li>
+    </ul>
+  </li>
+  <li>
+    PORTAGE_ELOG_SYSTEM &mdash; этот параметр выбирает модуль(и) для обработки
+    сообщений. Если он пуст, то ведение журналов отключено. Вы можете
+    использовать любую комбинацию из <c>save</c>, <c>custom</c>, <c>syslog</c>,
+    и <c>mail</c>, разделенных пробелами. Вы должны выбрать по крайней мере
+    один модуль для использования elog.
+    <ul>
+      <li>
+        save &mdash; сохраняет одно сообщение на каждый пакет в
+        <path>$PORT_LOGDIR/elog</path> или <path>/var/log/portage/elog</path>,
+        если $PORT_LOGDIR не определен;
+      </li>
+      <li>
+        custom &mdash; пропускать все сообщения через определенную
+        пользователем команду $PORTAGE_ELOG_COMMAND (см. описание ниже);
+      </li>
+      <li>syslog &mdash; отправлять все сообщения службе журналирования;</li>
+      <li>
+        mail &mdash; отправлять все сообщения через определенный в
+        $PORTAGE_ELOG_MAILURI почтовый сервер (см. описание ниже). Для этой
+        возможности необходим &gt;=<c>portage-2.1.1</c>.
+      </li>
+    </ul>
+  </li>
+  <li>
+    PORTAGE_ELOG_COMMAND &mdash; используется только для модуля <c>custom</c>.
+    В этой переменной указывается команда, обрабатывающая сообщения. Помните,
+    что вы можете использовать две переменные: ${PACKAGE} для имени пакета и
+    его версии и ${LOGFILE} для полного пути к файлу журналирования. Вот пример
+    возможного использования:
+    <ul>
+      <li>
+        PORTAGE_ELOG_COMMAND="/path/to/logger -p '\${PACKAGE}' -f '\${LOGFILE}'"
+      </li>
+    </ul>
+  </li>
+  <li>
+    PORTAGE_ELOG_MAILURI &mdash; содержит настройки для модуля <c>mail</c>:
+    адрес, пользователь, пароль, почтовый сервер и порт. По умолчанию:
+    &laquo;root@localhost localhost&raquo;.
+  </li>
+  <li>
+    Вот пример для сервера SMTP, использующего аутентификацию на основе имени
+    пользователя и его пароля, а также особенный порт (по умолчанию &mdash; 25):
+    <ul>
+      <li>
+        PORTAGE_ELOG_MAILURI="user@some.domain
+        username:password@smtp.some.domain:995"
+      </li>
+    </ul>
+  </li>
+  <li>
+    PORTAGE_ELOG_MAILFROM &mdash; указывает адрес в поле &laquo;from&raquo;;
+    если не установлено, то используется &laquo;portage&raquo;.
+  </li>
+  <li>
+    PORTAGE_ELOG_MAILSUBJECT &mdash; указывает тему сообщения. Вы можете
+    использовать две переменные &mdash; ${PACKAGE} для имени пакета и его
+    версии, и ${HOST} для отображения полного доменного имени источника.
+  </li>
+  <li>
+    Вот пример:
+    <ul>
+      <li>
+        PORTAGE_ELOG_MAILSUBJECT="package \${PACKAGE} was merged on \${HOST}
+        with some messages"
+      </li>
+    </ul>
+  </li>
+</ul>
+
+<impo>
+Если вы используете <c>enotice</c> с Portage-2.0.*, то вы должны полностью
+удалить его, так как он несовместим с elog.
+</impo>
+
 </body>
 </subsection>
 </section>
@@ -303,9 +417,10 @@
 
 <!-- *$Localization:
 target-language: Russian
-target-version: 1.7-r3
-target-date: 2005-11-27
-source-cvs-revision: 1.11
+target-version: 1.9-r1
+target-date: 2007-05-11
+source-cvs-revision: 1.15
 translated-by: Vasiliy Golubev [vas@nightmail.ru]
 edited-by:  Alexey Chumakov [achumakov@gentoo.org]
+  Azamat Hackimov <azamat.hackimov@gmail.com>
 -->