diff options
Diffstat (limited to 'ru_RU.KOI8-R/articles/problem-reports/article.xml')
| -rw-r--r-- | ru_RU.KOI8-R/articles/problem-reports/article.xml | 164 |
1 files changed, 70 insertions, 94 deletions
diff --git a/ru_RU.KOI8-R/articles/problem-reports/article.xml b/ru_RU.KOI8-R/articles/problem-reports/article.xml index df0c165964..fec36707a6 100644 --- a/ru_RU.KOI8-R/articles/problem-reports/article.xml +++ b/ru_RU.KOI8-R/articles/problem-reports/article.xml @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="koi8-r"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> - +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> <!-- The FreeBSD Russian Documentation Project @@ -9,14 +8,13 @@ Original revision: r39655 --> - -<article lang="ru"> - <articleinfo> - <title>Составление сообщений о проблеме во &os;</title> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="ru"> + <info><title>Составление сообщений о проблеме во &os;</title> + <pubdate>$FreeBSD$</pubdate> - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.ibm; &tm-attrib.intel; @@ -33,22 +31,15 @@ </abstract> <authorgroup> - <author> - <firstname>Dag-Erling</firstname> - <surname>Smørgrav</surname> - <contrib>Текст предоставил </contrib> - </author> - - <author> - <firstname>Mark</firstname> - <surname>Linimon</surname> - </author> + <author><personname><firstname>Dag-Erling</firstname><surname>Smørgrav</surname></personname><contrib>Текст предоставил </contrib></author> + + <author><personname><firstname>Mark</firstname><surname>Linimon</surname></personname></author> </authorgroup> - </articleinfo> + </info> <indexterm><primary>сообщения о проблемах</primary></indexterm> - <section id="pr-intro"> + <section xml:id="pr-intro"> <title>Введение</title> <para>Одной из самых разочаровывающих практик, которую можно получить в @@ -79,7 +70,7 @@ руководство.</para> </section> - <section id="pr-when"> + <section xml:id="pr-when"> <title>Когда нужно отправлять сообщение о проблеме</title> <para>Имеется много классов ошибок, и не все они должны приводить к @@ -114,7 +105,7 @@ организациями, такие, как BIND или различные утилиты GNU).</para> <para>Для не поддерживаемых никем портов (переменная - <makevar>MAINTAINER</makevar> + <varname>MAINTAINER</varname> содержит <literal>ports@FreeBSD.org</literal>), такие уведомления о обновлении будут замечены заинтересовавшимся коммиттером и вас могут попросить предоставить патч для обновления порта; предоставление @@ -128,12 +119,10 @@ разработчиками над ней или они возможно тестируют её, чтобы убедиться в отсутствии регрессии и т.п.</para> - <para>В любом случае, следование процессу, описанному в <ulink - url="&url.books.porters-handbook;/port-upgrading.html">Руководстве по - созданию портов</ulink> даст наилучшие результаты. - (Также можно ознакомиться с статьей <ulink - url="&url.articles.contributing-ports;/article.html"> - Контрибуция в коллекцию портов FreeBSD</ulink>.)</para> + <para>В любом случае, следование процессу, описанному в <link xlink:href="&url.books.porters-handbook;/port-upgrading.html">Руководстве по + созданию портов</link> даст наилучшие результаты. + (Также можно ознакомиться с статьей <link xlink:href="&url.articles.contributing-ports;/article.html"> + Контрибуция в коллекцию портов FreeBSD</link>.)</para> </listitem> </itemizedlist> @@ -193,16 +182,14 @@ чем получение сообщения об ошибке, которую он уже исправил.</para> <para>Если проблема в базовой системе, то вам нужно сначала прочесть - раздел <ulink - url="&url.books.faq;/introduction.html#LATEST-VERSION">версии - &os;</ulink> из FAQ, если вы ещё не знакомы с данной темой. Для &os; + раздел <link xlink:href="&url.books.faq;/introduction.html#LATEST-VERSION">версии + &os;</link> из FAQ, если вы ещё не знакомы с данной темой. Для &os; возможно исправлять проблемы только для некоторых недавних веток базовой системы, поэтому отправка сообщения об ошибке для более старой версии приведёт к тому, что разработчик посоветует вам обновиться до поддерживаемой версии, чтобы посмотреть присутствует ли в ней - проблема. Команда офицеров безопасности поддерживает <ulink - url="&url.base;/security/">список поддерживаемых - версий.</ulink>.</para> + проблема. Команда офицеров безопасности поддерживает <link xlink:href="&url.base;/security/">список поддерживаемых + версий.</link>.</para> <para>Если проблема связана с портами, помните, что вы сначала должны обновиться до самой последней версии Коллекции Портов @@ -213,7 +200,7 @@ быть исправлены.</para> </section> - <section id="pr-prep"> + <section xml:id="pr-prep"> <title>Подготовка</title> <para>Нужно следовать хорошему правилу всегда сначала выполнять @@ -227,25 +214,23 @@ <itemizedlist> <listitem> <para>&os; - <ulink url="&url.books.faq;/index.html">FAQ</ulink> + <link xlink:href="&url.books.faq;/index.html">FAQ</link> (Ответы на часто задаваемые вопросы). FAQ содержит ответы на вопросы из самых разных категорий, в частности, - <ulink url="&url.books.faq;/hardware.html">аппаратной - совместимости</ulink>, - <ulink url="&url.books.faq;/applications.html">пользовательских - программ</ulink> - и <ulink url="&url.books.faq;/kernelconfig.html">конфигурации - ядра</ulink>.</para> + <link xlink:href="&url.books.faq;/hardware.html">аппаратной + совместимости</link>, + <link xlink:href="&url.books.faq;/applications.html">пользовательских + программ</link> + и <link xlink:href="&url.books.faq;/kernelconfig.html">конфигурации + ядра</link>.</para> </listitem> <listitem> - <para><ulink - url="&url.books.handbook;/handbook/eresources.html#ERESOURCES-MAIL">Списки - рассылки</ulink>—если Вы не подписаны на них, воспользуйтесь - <ulink - url="http://www.FreeBSD.org/search/search.html#mailinglists">поиском - в архивах</ulink> на сайте &os;. Если ваша проблема не + <para><link xlink:href="&url.books.handbook;/handbook/eresources.html#ERESOURCES-MAIL">Списки + рассылки</link>—если Вы не подписаны на них, воспользуйтесь + <link xlink:href="http://www.FreeBSD.org/search/search.html#mailinglists">поиском + в архивах</link> на сайте &os;. Если ваша проблема не обсуждалась в списках рассылки, вы можете попытаться опубликовать сообщение о ней и подождать несколько дней, пока кто-нибудь не сможет увидеть то, что вы не заметили.</para> @@ -260,8 +245,8 @@ <listitem> <para>Следующим пунктом должна быть - <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> - база данных PR &os;</ulink> (GNATS). Если только ваша проблема не + <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"> + база данных PR &os;</link> (GNATS). Если только ваша проблема не нова или редка, есть некоторый шанс, что о ней уже сообщено.</para> </listitem> @@ -271,8 +256,7 @@ <para>Для основного кода &os; вы должны тщательно изучить содержимое файла <filename>/usr/src/UPDATING</filename> или его текущую версию - по адресу <ulink - url="http://svnweb.freebsd.org/base/head/UPDATING?view=log"></ulink>. + по адресу <uri xlink:href="http://svnweb.freebsd.org/base/head/UPDATING?view=log">http://svnweb.freebsd.org/base/head/UPDATING?view=log</uri>. (Если вы переходите с одной версии на другую, особенно если вы обновляетесь до &os.current;, то в этом файле вы можете найти много важной информации).</para> @@ -281,14 +265,13 @@ обратиться к файлу <filename>/usr/ports/UPDATING</filename> (изменения, касающиеся индивидуальных портов) или к <filename>/usr/ports/CHANGES</filename> (изменения, касающиеся всей - коллекции портов). Они также доступны через интерфейс svnweb: <ulink - url="http://svnweb.freebsd.org/ports/head/UPDATING?view=log"></ulink> - и <ulink url="http://svnweb.freebsd.org/ports/head/CHANGES?view=log"></ulink>.</para> + коллекции портов). Они также доступны через интерфейс svnweb: <uri xlink:href="http://svnweb.freebsd.org/ports/head/UPDATING?view=log">http://svnweb.freebsd.org/ports/head/UPDATING?view=log</uri> + и <uri xlink:href="http://svnweb.freebsd.org/ports/head/CHANGES?view=log">http://svnweb.freebsd.org/ports/head/CHANGES?view=log</uri>.</para> </listitem> </itemizedlist> </section> - <section id="pr-writing"> + <section xml:id="pr-writing"> <title>Написание сообщения о проблеме</title> <para>Теперь, после того, как вы решили, что ваш вопрос подпадает под @@ -459,7 +442,7 @@ <para>Имеются ли какие-либо переменные окружения, которые переписывают первоначально-установленные в <filename>bsd.port.mk</filename>, такие как, - <makevar>PORTSDIR</makevar>)</para> + <varname>PORTSDIR</varname>)</para> </listitem> <listitem> @@ -489,7 +472,7 @@ <para><emphasis>Убедитесь, что ваша проблема еще никем не описана. </emphasis> Мы уже говорили об этом, но стоит повториться. Потратьте пару минут на составление запросов к базе PR: - <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query"></ulink>. + <uri xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query</uri>. (Несмотря на повторы, об этом постоянно забывают)</para> </listitem> @@ -512,7 +495,7 @@ следует поступать именно так (то есть, это <quote>Правильный Путь</quote>). Как отмечалось выше, аккуратный поиск по архиву списков рассылки - <ulink url="http://www.FreeBSD.org/search/search.html#mailinglists"></ulink> + <uri xlink:href="http://www.FreeBSD.org/search/search.html#mailinglists">http://www.FreeBSD.org/search/search.html#mailinglists</uri> никогда не помешает.</para> </listitem> @@ -542,8 +525,7 @@ которой вы запускаете &man.send-pr.1;, нельзя отправить почту, сообщение не попадёт в базу данных GNATS. О настройке электронной почты во &os; можно прочитать в главе <quote>Электронная - почта</quote> Руководства по &os; по адресу <ulink - url="http://www.FreeBSD.org/doc/ru_RU.KOI8-R/books/handbook/mail.html"></ulink>.</para> + почта</quote> Руководства по &os; по адресу <uri xlink:href="http://www.FreeBSD.org/doc/ru_RU.KOI8-R/books/handbook/mail.html">http://www.FreeBSD.org/doc/ru_RU.KOI8-R/books/handbook/mail.html</uri>.</para> <para>Убедитесь, что ваш почтовый клиент не исказит сообщение по пути в GNATS. В частности, если ваш почтовый клиент автоматически @@ -554,8 +536,7 @@ для читабельности PR на веб странице.</para> <para>Примерные соображения должны учитываться при отправке - сообщения об ошибке через <ulink - url="&url.base;/send-pr.html">веб-форму</ulink> вместо + сообщения об ошибке через <link xlink:href="&url.base;/send-pr.html">веб-форму</link> вместо &man.send-pr.1;. Помните, что операции копирования-вставки могут иметь сторонние эффекты в форматировании текста. В определённых случаях может быть необходимо использовать &man.uuencode.1; @@ -563,8 +544,7 @@ <para>И наконец, если ваше сообщение будет объёмным, вы должны приготовить его в offline, чтобы ничего не потерялось в случае, - если будет проблема при его отправке. Это особенно касается <ulink - url="&url.base;/send-pr.html">веб-формы</ulink>.</para> + если будет проблема при его отправке. Это особенно касается <link xlink:href="&url.base;/send-pr.html">веб-формы</link>.</para> </section> <section> @@ -669,8 +649,7 @@ </listitem> </itemizedlist> - <para>Далее описаны общие поля для почтового и <ulink - url="&url.base;/send-pr.html">веб интерфейса</ulink>:</para> + <para>Далее описаны общие поля для почтового и <link xlink:href="&url.base;/send-pr.html">веб интерфейса</link>:</para> <itemizedlist> <listitem> @@ -784,18 +763,17 @@ с &man.sh.1; или &man.mount.8;, то вам прежде всего необходимо определить принадлежность программы к базовой системе или к установке из коллекции портов. Если вы не уверены, - выполните команду <command>whereis <replaceable>имя - программы</replaceable></command>. В &os; для коллекции портов - существует договоренность: установка ведется в <filename - class="directory">/usr/local</filename>, однако это может быть + выполните команду <command>whereis имя + программы</command>. В &os; для коллекции портов + существует договоренность: установка ведется в <filename>/usr/local</filename>, однако это может быть переопределено системным администратором. Для таких программ следует использовать категорию <literal>ports</literal> (даже если категория порта <literal>www</literal>; см. ниже). Если программа располагается в - <filename class="directory">/bin</filename>, - <filename class="directory">/usr/bin</filename>, - <filename class="directory">/sbin</filename> или в - <filename class="directory">/usr/sbin</filename>, + <filename>/bin</filename>, + <filename>/usr/bin</filename>, + <filename>/sbin</filename> или в + <filename>/usr/sbin</filename>, то это часть базовой системы, и вам следует использовать категорию <literal>bin</literal>. (Несколько программ, например &man.gcc.1;, на самом деле используют категорию @@ -819,13 +797,12 @@ </listitem> <listitem> - <para>Если вы наблюдаете проблему на страницах <ulink - url="http://www.FreeBSD.org">сайта FreeBSD</ulink>, + <para>Если вы наблюдаете проблему на страницах <link xlink:href="http://www.FreeBSD.org">сайта FreeBSD</link>, то правильным выбором будет <literal>www</literal>.</para> <note> <para>Если проблема с чем-то из порта, называемого - <literal>www/<replaceable>someportname</replaceable> + <literal>www/someportname </literal>, то она все же принадлежит к категории <literal>ports</literal>.</para> </note> @@ -913,7 +890,7 @@ </itemizedlist> <para>Вот текущий перечень категорий (взят из - <ulink url="http://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories"></ulink>):</para> + <uri xlink:href="http://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories">http://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories</uri>):</para> <itemizedlist> <listitem> @@ -1119,8 +1096,7 @@ <para>При этом будет прочитан указанный файл, будет проверено содержимое, убраны комментарии и сообщение будет отослано.</para> - <para>Если вы используете <ulink - url="&url.base;/send-pr.html">веб форму</ulink>:</para> + <para>Если вы используете <link xlink:href="&url.base;/send-pr.html">веб форму</link>:</para> <para>Перед нажатием <literal>submit</literal> вам потребуется заполнить проверочное поле текстом, представленным на картинке рядом. @@ -1144,7 +1120,7 @@ </section> </section> - <section id="pr-followup"> + <section xml:id="pr-followup"> <title>Отслеживание</title> <para>После того, как ваше сообщение будет принято, вы получите по @@ -1166,9 +1142,8 @@ <listitem> <para>Самый простой путь это использовать соответствующую ссылку (followup) на индивидуальной веб страничке сообщения об ошибки, к - которой можно перейти, используя <ulink url - ="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">страничку - поиска PR</ulink>. Кликнув на этой ссылке откроется окно для + которой можно перейти, используя <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">страничку + поиска PR</link>. Кликнув на этой ссылке откроется окно для отправки email с уже корректно заполненными полями To: и Subject: (если ваш браузер сконфигурирован для этого).</para> </listitem> @@ -1205,7 +1180,7 @@ устранена.</para> </section> - <section id="pr-problems"> + <section xml:id="pr-problems"> <title>Проблемы взаимодействия с GNATS</title> <para>Большинство PR проходят сквозь систему и принимаются быстро; @@ -1234,15 +1209,15 @@ PR принят и ему присвоен номер, но он не отображается в списках PR ни на одной из страниц веб поиска PR. Вероятно, что рассинхронизировался индекс базы с самой базой. Этот случай можно проверить, обратившись - к страничке <ulink url="http://www.FreeBSD.org/cgi/query-pr.cgi"> - Query PR Database</ulink> и проконтролировав наличие вашего PR. + к страничке <link xlink:href="http://www.FreeBSD.org/cgi/query-pr.cgi"> + Query PR Database</link> и проконтролировав наличие вашего PR. Если он есть, пожалуйста, известите администраторов GNATS (<email>bugmeister@FreeBSD.org</email>). Следует отметить, что перестройка базы выполняется периодически по <literal>cron</literal>, и если вам не к спеху, то не предпринимайте никаких шагов.</para> </section> - <section id="pr-further"> + <section xml:id="pr-further"> <title>Дополнительная литература</title> <para>Это список информационных ресурсов, относящихся к правильному @@ -1251,18 +1226,19 @@ <itemizedlist> <listitem> - <para><ulink - url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"> - How to Report Bugs Effectively</ulink>—прекрасное эссе, которое + <para><link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"> + How to Report Bugs Effectively</link>—прекрасное эссе, которое написал Simon G. Tatham о составлении полезных (не специфичных для &os;) сообщений о проблемах.</para> </listitem> <listitem> - <para><ulink url="&url.articles.pr-guidelines;/article.html">Problem - Report Handling Guidelines</ulink>—интересный взгляд на + <para><link xlink:href="&url.articles.pr-guidelines;/article.html">Problem + Report Handling Guidelines</link>—интересный взгляд на обработку сообщений о проблемах самими разработчиками &os;.</para> </listitem> </itemizedlist> </section> + + <index/> </article> |