# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR The FreeBSD Project
# This file is distributed under the same license as the FreeBSD Documentation package.
# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025.
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
"POT-Creation-Date: 2025-09-20 12:50+0300\n"
"PO-Revision-Date: 2025-09-05 04:45+0000\n"
"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
"documentation/articlesproblem-reports_index/ru/>\n"
"Language: ru\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
"X-Generator: Weblate 4.17\n"

#. type: Yaml Front Matter Hash Value: description
#: documentation/content/en/articles/problem-reports/_index.adoc:1
#, no-wrap
msgid "How to best formulate and submit a problem report to the FreeBSD Project"
msgstr "Как лучше сформулировать и отправить отчет о проблеме в проект FreeBSD"

#. type: Title =
#: documentation/content/en/articles/problem-reports/_index.adoc:1
#: documentation/content/en/articles/problem-reports/_index.adoc:11
#, no-wrap
msgid "Writing FreeBSD Problem Reports"
msgstr "Составление сообщений о проблеме во FreeBSD"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:44
msgid "Abstract"
msgstr "Аннотация"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:46
msgid ""
"This article describes how to best formulate and submit a problem report to "
"the FreeBSD Project."
msgstr ""
"Эта статья описывает, как наилучшим образом сформулировать и отправить "
"сообщение о проблеме в Проект FreeBSD."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:48
msgid "'''"
msgstr "'''"

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:52
#, no-wrap
msgid "Introduction"
msgstr "Введение"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:56
msgid ""
"One of the most frustrating experiences one can have as a software user is "
"to submit a problem report only to have it summarily closed with a terse and "
"unhelpful explanation like \"not a bug\" or \"bogus PR\".  Similarly, one of "
"the most frustrating experiences as a software developer is to be flooded "
"with problem reports that are not really problem reports but requests for "
"support, or that contain little or no information about what the problem is "
"and how to reproduce it."
msgstr ""
"Одной из самых разочаровывающих практик, которую можно получить в качестве "
"пользователя программного обеспечения, является отправка сообщения о "
"проблеме, которое вскоре закрывается с кратким и ничему не помогающим "
"объяснением типа \"это не проблема\" или \"неправильное PR\". Подобным же "
"образом одной из самых разочаровывающих практик, которую можно получить в "
"качестве разработчика программного обеспечения, является получение массы "
"сообщений о проблемах, которые на самом деле не являются сообщениями о "
"проблемах, а запросами на получение поддержки, или которые содержат мало или "
"вообще не содержат никакой информации о сути проблемы или способе ее "
"воспроизведения."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:59
msgid ""
"This document attempts to describe how to write good problem reports.  What, "
"one asks, is a good problem report? Well, to go straight to the bottom line, "
"a good problem report is one that can be analyzed and dealt with swiftly, to "
"the mutual satisfaction of both user and developer."
msgstr ""
"В этом документе делается попытка описать то, как составлять хорошие "
"сообщения о проблемах. Что же, спросите вы, является хорошим сообщением о "
"проблеме? Ну, если перейти прямо к сути, то хорошим сообщением об проблеме "
"является то, которое может быть быстро проанализировано и отработано, к "
"обоюдному удовлетворению как пользователя, так и разработчика."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:61
msgid ""
"Although the primary focus of this article is on FreeBSD problem reports, "
"most of it should apply quite well to other software projects."
msgstr ""
"Хотя в основном статья фокусируется на сообщениях о проблемах во FreeBSD, "
"большей частью она должна хорошо подходить и другим программным проектам."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:64
msgid ""
"Note that this article is organized thematically, not chronologically.  Read "
"the entire document before submitting a problem report, rather than treating "
"it as a step-by-step tutorial."
msgstr ""
"Заметьте, что эта статья организована по тематическому принципу, а не "
"хронологически, так что вы должны прочесть документ целиком прежде, чем "
"посылать сообщение о проблеме, и не воспринимать статью как пошаговое "
"руководство."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:66
#, no-wrap
msgid "When to Submit a Problem Report"
msgstr "Когда нужно отправлять сообщение о проблеме"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:72
msgid ""
"There are many types of problems, and not all of them should engender a "
"problem report.  Of course, nobody is perfect, and there will be times when "
"what seems to be a bug in a program is, in fact, a misunderstanding of the "
"syntax for a command or a typographical error in a configuration file "
"(though that in itself may sometimes be indicative of poor documentation or "
"poor error handling in the application).  There are still many cases where "
"submitting a problem report is clearly _not_ the right course of action, and "
"will only serve to frustrate both the submitter and the developers.  "
"Conversely, there are cases where it might be appropriate to submit a "
"problem report about something else than a bug—an enhancement or a new "
"feature, for instance."
msgstr ""
"Имеется много классов ошибок, и не все они должны приводить к появлению "
"сообщения о проблеме. Конечно же, нет идеальных людей, и будут моменты, "
"когда вы решите, что нашли ошибку в программе, а на самом деле вы "
"неправильно поняли синтаксис команды или сделали опечатку в конфигурационном "
"файле (хотя само по себе это иногда говорит о плохой документации или "
"неправильной обработке ошибок в прикладной программе). Есть еще много "
"случаев, когда посылка сообщения о проблеме явно _не_ является правильным "
"действием, а только приводит к разочарованию вас и разработчиков. И "
"наоборот, есть случаи, когда может быть нужно послать сообщение о чем-то, не "
"являющемся ошибкой - к примеру, запрос на доработку или расширение "
"функциональности."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:76
msgid ""
"So how does one determine what is a bug and what is not? As a simple rule of "
"thumb, the problem is _not_ a bug if it can be expressed as a question "
"(usually of the form \"How do I do X?\" or \"Where can I find Y?\").  It is "
"not always quite so black and white, but the question rule covers a large "
"majority of cases.  When looking for an answer, consider posing the question "
"to the {freebsd-questions}."
msgstr ""
"Но как же определить, что является ошибкой, а что нет? Простым правилом, "
"которому нужно следовать, является следующее - ваша проблема _не_ является "
"ошибкой, если она формулируется как вопрос (обычно в форме \"Как сделать X?"
"\" или \"Где можно найти Y?\"). Не всегда это так однозначно, но правило "
"вопроса покрывает большинство случаев. Если Вам нужен ответ, лучше всего "
"задать свой вопрос в {freebsd-questions}."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:78
msgid ""
"Consider these factors when submitting PRs about ports or other software "
"that is not part of FreeBSD itself:"
msgstr ""
"Вот некоторые случаи, в которых может оказаться полезным отправить сообщение "
"о чем-то, что не является ошибкой:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:80
msgid ""
"Please do not submit problem reports that simply state that a newer version "
"of an application is available. Ports maintainers are automatically notified "
"by portscout when a new version of an application becomes available. Actual "
"patches to update a port to the latest version are welcome."
msgstr ""
"Уведомление об обновлении программного обеспечения, которое поддерживается "
"сторонними разработчиками (в основном порты, но также и компоненты базовой "
"системы, разрабатываемые сторонними организациями, такие, как BIND или "
"различные утилиты GNU)."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:81
msgid ""
"For unmaintained ports (`MAINTAINER` is `ports@FreeBSD.org`), a PR without "
"an included patch is unlikely to get picked up by a committer. To become the "
"maintainer of an unmaintained port, submit a PR with the request (patch "
"preferred but not required)."
msgstr ""
"Для не поддерживаемых никем портов (переменная `MAINTAINER` содержит "
"`ports@FreeBSD.org`), такие уведомления о обновлении будут замечены "
"заинтересовавшимся коммиттером и вас могут попросить предоставить патч для "
"обновления порта; предоставление патча до того, как вас попросят об этом "
"сильно увеличит шансы того, что порт будет обновлён вовремя."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:82
msgid ""
"In either case, following the process described in extref:{porters-handbook}"
"upgrading/[Porter's Handbook] will yield the best results. (You might also "
"wish to read extref:{contributing}[Contributing to the FreeBSD Ports "
"Collection, ports-contributing].)"
msgstr ""
"В любом случае, следование процессу, описанному в extref:{porters-handbook}"
"upgrading[Руководстве по созданию портов] даст наилучшие результаты. "
"(Также можно ознакомиться с статьей extref:{contributing}[Вклад в "
"коллекцию портов FreeBSD, ports-contributing].)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:87
msgid ""
"A bug that cannot be reproduced can rarely be fixed.  If the bug only "
"occurred once and you cannot reproduce it, and it does not seem to happen to "
"anybody else, chances are none of the developers will be able to reproduce "
"it or figure out what is wrong.  That does not mean it did not happen, but "
"it does mean that the chances of your problem report ever leading to a bug "
"fix are very slim.  To make matters worse, often these kinds of bugs are "
"actually caused by failing hard drives or overheating processors—you should "
"always try to rule out these causes, whenever possible, before submitting a "
"PR."
msgstr ""
"Ошибка, которую нельзя воспроизвести, вряд ли будет исправлена. Если ошибка "
"возникла только единожды, и вы не можете ее воспроизвести, к тому же никто с "
"ней больше не сталкивался, нет никаких шансов, что разработчики смогут ее "
"воспроизвести или понять, что делается неправильно. Это не значит, что "
"такого не случается, но это значит, что шансов у вашего сообщения дойти "
"когда-либо до стадии исправления ошибки очень малы. Часто эти виды ошибок "
"возникают из-за неудовлетворительной работы жёстких дисков, перегревшихся "
"процессоров. Всегда, когда это возможно вы должны отслеживать такие случаи "
"перед посылкой сообщения об ошибке."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:89
msgid ""
"Next, to decide to whom you should file your problem report, you need to "
"understand that the software that makes up FreeBSD is composed of several "
"different elements:"
msgstr ""
"Теперь, чтобы определить кому вы должны отправить ваше сообщение об ошибке, "
"вы должны понимать, что программное обеспечение, которое входит во FreeBSD, "
"составляется из нескольких различных частей:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:91
msgid ""
"Code in the base system that is written and maintained by FreeBSD "
"contributors, such as the kernel, the C library, and the device drivers "
"(categorized as `kern`); the binary utilities (`bin`); the manual pages and "
"documentation (`docs`); and the web pages (`www`). All bugs in these areas "
"should be reported to the FreeBSD developers."
msgstr ""
"Код в базовой системе, который пишется и поддерживается контрибьюторами "
"FreeBSD. Такой, как ядро, библиотека C, драйвера устройств (входят в "
"категорию `kern`); утилиты (`bin`); страницы справочника и документация "
"(`docs`); веб-страницы (`www`). Все ошибки в этих областях должны быть "
"сообщены разработчикам FreeBSD."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:92
msgid ""
"Code in the base system that is written and maintained by others, and "
"imported into FreeBSD and adapted. Examples include man:clang[1], and "
"man:sendmail[8]. Most bugs in these areas should be reported to the FreeBSD "
"developers; but in some cases they may need to be reported to the original "
"authors instead if the problems are not FreeBSD-specific."
msgstr ""
"Код в базовой системе, который пишется и поддерживается другим, "
"импортируется во FreeBSD и адаптируется. Примеры включают в себя: bind, "
"man:gcc[1] и man:sendmail[8]. Большинство ошибок, попадающие в данные "
"области должны быть сообщены разработчикам FreeBSD, но в некоторых случаях "
"они должны быть отправлены изначальным разработчикам, если проблемы не "
"являются специфичными для FreeBSD. Обычно ошибки такого рода попадают под "
"категории `bin` или `gnu`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:93
msgid ""
"Individual applications that are not in the base system but are instead part "
"of the FreeBSD Ports Collection (category `ports`). Most of these "
"applications are not written by FreeBSD developers; what FreeBSD provides is "
"merely a framework for installing the application. Therefore, only report a "
"problem to the FreeBSD developers when the problem is believed to be FreeBSD-"
"specific; otherwise, report it to the authors of the software."
msgstr ""
"Отдельные приложения, не входящие в базовую систему, но являющиеся частью "
"Коллекции Портов FreeBSD (категория `ports`). Большинство этих приложений не "
"пишется разработчиками FreeBSD; что предоставляет FreeBSD, так это только "
"лишь инфраструктуру для установки приложения. Следовательно, вы должны "
"отправлять сообщение об ошибке разработчикам FreeBSD только тогда, когда вы "
"уверены в том, что проблема специфична для FreeBSD - иначе отправляйте её "
"авторам программного обеспечения."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:96
msgid ""
"Then, ascertain whether the problem is timely.  There are few things that "
"will annoy a developer more than receiving a problem report about a bug she "
"has already fixed."
msgstr ""
"Затем вы должны убедиться, действительно ли проблема существует. Существует "
"всего несколько вещей, которые раздражают разработчика больше, чем получение "
"сообщения об ошибке, которую он уже исправил."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:100
msgid ""
"If the problem is in the base system, first read the FAQ section on extref:"
"{faq}[FreeBSD versions, latest-version], if you are not already familiar "
"with the topic.  It is not possible for FreeBSD to fix problems in anything "
"other than certain recent branches of the base system, so filing a bug "
"report about an older version will probably only result in a developer "
"advising you to upgrade to a supported version to see if the problem still "
"recurs.  The Security Officer team maintains the link:https://"
"www.FreeBSD.org/security/[list of supported versions]."
msgstr ""
"Если проблема в базовой системе, то вам нужно сначала прочесть раздел extref:"
"{faq}[версии FreeBSD, latest-version] из FAQ, если вы ещё не знакомы с "
"данной темой. Для FreeBSD возможно исправлять проблемы только для некоторых "
"недавних веток базовой системы, поэтому отправка сообщения об ошибке для "
"более старой версии приведёт к тому, что разработчик посоветует вам "
"обновиться до поддерживаемой версии, чтобы посмотреть присутствует ли в ней "
"проблема. Команда офицеров безопасности поддерживает link:https://"
"www.FreeBSD.org/security/[список поддерживаемых версий.]."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:103
msgid ""
"If the problem is in a port, consider filing a bug with the upstream.  The "
"FreeBSD Project can not fix all bugs in all software."
msgstr ""
"Если проблема в порте, рассмотрите возможность сообщить об ошибке "
"разработчикам исходного проекта. Проект FreeBSD не может исправлять все "
"ошибки во всём программном обеспечении."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:105
#, no-wrap
msgid "Preparations"
msgstr "Подготовка"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:111
msgid ""
"A good rule to follow is to always do a background search before submitting "
"a problem report.  Maybe the problem has already been reported; maybe it is "
"being discussed on the mailing lists, or recently was; it may even already "
"be fixed in a newer version than what you are running.  You should therefore "
"check all the obvious places before submitting your problem report.  For "
"FreeBSD, this means:"
msgstr ""
"Нужно следовать хорошему правилу всегда сначала выполнять дополнительные "
"исследования перед тем, как послать сообщение о проблеме. Может быть, о "
"вашей проблеме уже сообщено; может быть, она недавно обсуждалась или "
"обсуждается в списках рассылки; она может быть уже исправлена в более новой "
"версии, чем та, что вы используете. Поэтому вы должны проверить все обычные "
"места до того, как послать ваше сообщение о проблеме. Для FreeBSD это значит:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:113
msgid ""
"The FreeBSD extref:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ "
"attempts to provide answers for a wide range of questions, such as those "
"concerning extref:{faq}[hardware compatibility, hardware], extref:{faq}[user "
"applications, applications], and extref:{faq}[kernel configuration, "
"kernelconfig]."
msgstr ""
"Список extref:{faq}[Часто задаваемых вопросов] (FAQ) по FreeBSD. FAQ "
"содержит ответы на широкий круг вопросов, таких как вопросы, касающиеся "
"extref:{faq}[совместимости оборудования, hardware], extref:{faq}"
"[пользовательских приложений, applications] и extref:{faq}[конфигурации "
"ядра, kernelconfig]."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:114
msgid ""
"The extref:{handbook}eresources/[mailing lists, eresources-mail]. If you are "
"not subscribed, use https://www.FreeBSD.org/search/#mailinglists[the "
"searchable archives] on the FreeBSD web site. If the problem has not been "
"discussed on the lists, you might try posting a message about it and waiting "
"a few days to see if someone can spot something that has been overlooked."
msgstr ""
"extref:{handbook}eresources/[Списки рассылки, eresources-mail] — если Вы не "
"подписаны на них, воспользуйтесь https://www.FreeBSD.org/search/"
"#mailinglists[поиском в архивах] на сайте FreeBSD. Если ваша проблема не "
"обсуждалась в списках рассылки, вы можете попытаться опубликовать сообщение "
"о ней и подождать несколько дней, пока кто-нибудь не сможет увидеть то, что "
"вы не заметили."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:115
msgid ""
"Optionally, the entire web-use your favorite search engine to locate any "
"references to the problem. You may even get hits from archived mailing lists "
"or newsgroups you did not know of or had not thought to search through."
msgstr ""
"Как вариант, весь веб-используйте вашу любимую поисковую систему для поиска "
"каких-либо ссылок по вашей проблеме. Вы можете даже увидеть ссылки на архивы "
"списков рассылки или телеконференций, о которых вы не знали или не думали "
"там искать."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:116
msgid ""
"Next, the searchable https://bugs.freebsd.org/bugzilla/query.cgi[FreeBSD PR "
"database] (Bugzilla). Unless the problem is recent or obscure, there is a "
"fair chance it has already been reported."
msgstr ""
"Следующим пунктом должна быть https://bugs.freebsd.org/bugzilla/"
"query.cgi[ база данных PR FreeBSD] (Bugzilla). Если только ваша проблема не "
"нова или редка, есть некоторый шанс, что о ней уже сообщено."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:117
msgid ""
"Most importantly, attempt to see if existing documentation in the source "
"base addresses your problem."
msgstr ""
"И самое важное, вы должны посмотреть не затрагивает ли документация в "
"базовой системе вашу проблему."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:120
msgid ""
"For the base FreeBSD code, you should carefully study the contents of "
"[.filename]#/usr/src/UPDATING# on your system or the latest version at "
"https://cgit.freebsd.org/src/tree/UPDATING[https://cgit.freebsd.org/src/tree/"
"UPDATING].  (This is vital information if you are upgrading from one version "
"to another, especially if you are upgrading to the FreeBSD-CURRENT branch)."
msgstr ""
"Для основного кода FreeBSD вы должны тщательно изучить содержимое файла "
"[.filename]#/usr/src/UPDATING# или его текущую версию по адресу  https://"
"cgit.freebsd.org/src/tree/UPDATING[https://cgit.freebsd.org/src/tree/"
"UPDATING]. (Если вы переходите с одной версии на другую, особенно если вы "
"обновляетесь до FreeBSD-CURRENT, то в этом файле вы можете найти много "
"важной информации)."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:123
msgid ""
"However, if the problem is in something that was installed as a part of the "
"FreeBSD Ports Collection, you should refer to [.filename]#/usr/ports/"
"UPDATING# (for individual ports) or [.filename]#/usr/ports/CHANGES# (for "
"changes that affect the entire Ports Collection).  https://cgit.freebsd.org/"
"ports/tree/UPDATING[https://cgit.freebsd.org/ports/tree/UPDATING] and "
"https://cgit.freebsd.org/ports/tree/CHANGES[https://cgit.freebsd.org/ports/"
"tree/CHANGES] are also available via cgit."
msgstr ""
"Если же ваша проблема связана с коллекцией портов FreeBSD, вы должны "
"обратиться к файлу [.filename]#/usr/ports/UPDATING# (изменения, касающиеся "
"индивидуальных портов) или к [.filename]#/usr/ports/CHANGES# (изменения, "
"касающиеся всей коллекции портов). Они также доступны через интерфейс cgit: "
"https://cgit.freebsd.org/ports/tree/UPDATING[https://cgit.freebsd.org/ports/"
"tree/UPDATING] и https://cgit.freebsd.org/ports/tree/CHANGES[https://"
"cgit.freebsd.org/ports/tree/CHANGES] ."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:125
#, no-wrap
msgid "Writing the Problem Report"
msgstr "Написание сообщения о проблеме"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:129
msgid ""
"Now that you have decided that your issue merits a problem report, and that "
"it is a FreeBSD problem, it is time to write the actual problem report.  "
"Before we get into the mechanics of the program used to generate and submit "
"PRs, here are some tips and tricks to help make sure that your PR will be "
"most effective."
msgstr ""
"Теперь, после того, как вы решили, что ваш вопрос подпадает под категорию "
"сообщения о проблеме, и это проблема FreeBSD, самое время написать "
"собственно сообщение о проблеме (PR). Прежде чем мы углубимся в частности "
"использования программы для создания и отправки PR, вот несколько советов, "
"которые помогут вам сделать PR более эффективным."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:131
#, no-wrap
msgid "Tips and Tricks for Writing a Good Problem Report"
msgstr "Как писать хорошие сообщения о проблемах"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:134
msgid ""
"_Do not leave the \"Summary\" line empty._ The PRs go both onto a mailing "
"list that goes all over the world (where the \"Summary\" is used for the "
"`Subject:` line), but also into a database. Anyone who comes along later and "
"browses the database by synopsis, and finds a PR with a blank subject line, "
"tends just to skip over it. Remember that PRs stay in this database until "
"they are closed by someone; an anonymous one will usually just disappear in "
"the noise."
msgstr ""
"_Не оставляйте поле \"Summary\" (краткое описание) пустым._ Сообщения о "
"проблемах попадают как в списки рассылки, которые затем расходятся по всему "
"миру (в них поле \"Summary\" определяет тему письма), так и в базу данных. "
"Просматривающий эту базу, как правило, пройдет мимо PR с пустым кратким "
"описанием. Не забудьте, что PR остается в базе до тех пор, пока кто-либо не "
"закроет его; сообщение-аноним, скорее всего, просто потеряется на общем фоне."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:135
msgid ""
"_Avoid using a weak \"Summary\" line._ You should not assume that anyone "
"reading your PR has any context for your submission, so the more you "
"provide, the better. For instance, what part of the system does the problem "
"apply to? Do you only see the problem while installing, or while running? To "
"illustrate, instead of `Summary: portupgrade is broken`, see how much more "
"informative this seems: `Summary: port ports-mgmt/portupgrade coredumps on "
"-current`. (In the case of ports, it is especially helpful to have both the "
"category and portname in the \"Summary\" line.)"
msgstr ""
"__Избегайте туманных описаний в поле \"Summary\"__. Не стоит предполагать, "
"что читающий ваше сообщение владеет контекстом; поэтому, чем подробнее вы "
"опишете ситуацию, тем лучше. В частности, к какой части системы относится "
"ваша проблема? Проявляется ли она на этапе установки или во время нормальной "
"работы? Например, вместо строки `Summary: portupgrade is broken` следовало "
"бы написать что-то вроде `Summary: port ports-mgmt/portupgrade coredumps on "
"-current`. В случае портированных приложений в поле \"Summary\" полезно "
"указывать не только имя порта, но и категорию."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:137
msgid ""
"_If you have a patch, say so._ The presence of a patch makes it much easier "
"to progress a report."
msgstr ""
"_Если у вас есть патч, сообщите об этом._ Наличие патча значительно упрощает "
"обработку отчёта."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:138
msgid "Do not use the `patch` or `patch-ready` keywords – they are deprecated."
msgstr ""
"Не используйте ключевые слова `patch` или `patch-ready` — они устарели."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:139
msgid ""
"_If you are a maintainer, say so._ If you are maintaining a part of the "
"source code (for instance, an existing port), you definitely should set the "
"\"Class\" of your PR to `maintainer-update`. This way any committer that "
"handles your PR will not have to check."
msgstr ""
"_Если вы сопровождаете код, укажите это._ Если вы сопровождаете часть "
"исходного кода (например, существующий порт), обязательно установите «Class» "
"вашего PR в значение `maintainer-update`. Таким образом, любой коммиттер, "
"обрабатывающий ваш PR, не будет вынужден проверять это."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:140
msgid ""
"_Be specific._ The more information you supply about what problem you are "
"having, the better your chance of getting a response."
msgstr ""
"_Будьте точны в формулировках._ Чем больше информации вы можете предоставить "
"о проблеме, тем больше у вас шансов получить ответ."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:142
msgid ""
"Include the version of FreeBSD you are running (there is a place to put "
"that, see below) and on which architecture. You should include whether you "
"are running from a release (e.g., from a CD-ROM or download), or from a "
"system maintained by Git (and, if so, what hash and branch you are at). If "
"you are tracking the FreeBSD-CURRENT branch, that is the very first thing "
"someone will ask, because fixes (especially for high-profile problems) tend "
"to get committed very quickly, and FreeBSD-CURRENT users are expected to "
"keep up."
msgstr ""
"Включите версию FreeBSD, которую вы используете (для этого есть специальное "
"поле, см. ниже), и архитектуру. Укажите, используете ли вы релиз (например, "
"с CD-ROM или загруженный) или систему, поддерживаемую через Git (и, если да, "
"укажите хэш и ветку). Если вы используете ветку FreeBSD-CURRENT, укажите это "
"в первую очередь, так как исправления (особенно для известных проблем) часто "
"добавляются очень быстро, и пользователи FreeBSD-CURRENT должны следить за "
"обновлениями."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:143
msgid ""
"Include which global options you have specified in your "
"[.filename]#make.conf#, [.filename]#src.conf#, and [.filename]#src-"
"env.conf#. Given the infinite number of options, not every combination may "
"be fully supported."
msgstr ""
"Включите информацию о том, какие глобальные опции вы указали в "
"[.filename]#make.conf#. На заметку: Объявление опций наподобие `-02` и "
"других, описанных в man:gcc[1] во многих случаях может быть причиной ошибок. "
"Хотя и разработчики FreeBSD будут принимать патчи, у них не будет желания "
"исследовать такие случаи из-за отсутствия времени и добровольцев, и вместо "
"этого они могут ответить, что это не поддерживается."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:144
msgid ""
"If the problem can be reproduced easily, include information that will help "
"a developer to reproduce it themselves. If a problem can be demonstrated "
"with specific input then include an example of that input if possible, and "
"include both the actual and the expected output. If this data is large or "
"cannot be made public, then do try to create a minimal file that exhibits "
"the same issue and that can be included within the PR."
msgstr ""
"Если проблему можно легко повторить, включите необходимую информацию, чтобы "
"разработчик смог воспроизвести ее самостоятельно. Если проблема проявляется "
"при некоторых вводимых данных, то, по возможности, приведите их вместе с "
"получаемым и ожидаемым выводом. Если же вводимых данных много или же их "
"нельзя разглашать, то попробуйте выделить из них лишь небольшой фрагмент, "
"приводящий к возникновению проблемы, и включите его в PR."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:145
msgid ""
"If this is a kernel problem, then be prepared to supply the following "
"information. (You do not have to include these by default, which only tends "
"to fill up the database, but you should include excerpts that you think "
"might be relevant):"
msgstr ""
"Если ваша проблема связана с ядром, будьте готовы предоставить следующую "
"информацию (вам не обязательно включать её всю, она пойдёт лишь на "
"заполнение базы данных, но вы должны включить информацию, которая по вашему "
"мнению актуальна):"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:147
msgid ""
"your kernel configuration (including which hardware devices you have "
"installed)"
msgstr "Вашу конфигурацию ядра, включая то, какие устройства у вас установлены"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:148
msgid ""
"whether or not you have debugging options enabled (such as `WITNESS`), and "
"if so, whether the problem persists when you change the sense of that option"
msgstr ""
"Включены ли у вас опции отладки (например, `WITNESS`), и если так, то "
"существует ли проблема после изменения значения этой опции"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:149
msgid ""
"the full text of any backtrace, panic or other console output, or entries in "
"[.filename]#/var/log/messages#, if any were generated"
msgstr ""
"Полный вывод обратной трассировки (backtrace), паники или иного консольного "
"вывода, или же записи из [.filename]#/var/log/messages#, если они были "
"сгенерированы"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:150
msgid ""
"the output of `pciconf -l` and relevant parts of your `dmesg` output if your "
"problem relates to a specific piece of hardware"
msgstr ""
"Вывод команды `pciconf -l`, а также соответствующие части вывода `dmesg`, в "
"случае, если проблема связана с конкретным оборудованием"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:151
msgid ""
"the fact that you have read [.filename]#src/UPDATING# and that your problem "
"is not listed there (someone is guaranteed to ask)"
msgstr ""
"Прочли ли вы [.filename]#src/UPDATING#, описана ли там ваша проблема (кто-"
"нибудь спросит обязательно)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:152
msgid ""
"whether or not you can run any other kernel as a fallback (this is to rule "
"out hardware-related issues such as failing disks and overheating CPUs, "
"which can masquerade as kernel problems)"
msgstr ""
"Запускается ли другое ядро (это для тех случаев, когда причиной сбоя стало "
"оборудование, например отказывающие винчестеры или перегревшиеся процессоры, "
"что может маскировать проблемы ядра)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:154
msgid ""
"If this is a ports problem, then be prepared to supply the following "
"information. (You do not have to include these by default, which only tends "
"to fill up the database, but you should include excerpts that you think "
"might be relevant):"
msgstr ""
"Если же ваша проблема связана с портами, то предоставьте следующую "
"информацию (вам не обязательно включать её всю, она пойдет лишь на "
"заполнение базы данных, но вы должны включить информацию, которая по вашему "
"мнению актуальна):"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:156
msgid "which ports you have installed"
msgstr "Какие порты вы устанавливали"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:157
msgid ""
"any environment variables that override the defaults in "
"[.filename]#bsd.port.mk#, such as `PORTSDIR`"
msgstr ""
"Имеются ли какие-либо переменные окружения, которые переписывают "
"первоначально-установленные в [.filename]#bsd.port.mk#, такие как, "
"`PORTSDIR`)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:158
msgid ""
"the fact that you have read [.filename]#ports/UPDATING# and that your "
"problem is not listed there (someone is guaranteed to ask)"
msgstr ""
"Прочли ли вы [.filename]#ports/UPDATING#, и описана ли там ваша проблема "
"(кто-нибудь спросит обязательно)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:160
msgid ""
"_Avoid vague requests for features._ PRs of the form \"someone should really "
"implement something that does so-and-so\" are less likely to get results "
"than very specific requests. Remember, the source is available to everyone, "
"so if you want a feature, the best way to ensure it being included is to get "
"to work! Also consider the fact that many things like this would make a "
"better topic for discussion on `freebsd-questions` than an entry in the PR "
"database, as discussed above."
msgstr ""
"_Избегайте нечетких запросов о новых возможностях._ Сообщение типа \"кто-то "
"обязательно должен сделать так, чтобы такая-то утилита вела себя так-то\" "
"имеет куда меньше шансов встретить позитивный отклик, чем более четко "
"сформулированный запрос. Помните, что исходные тексты доступны всем, так что "
"если вам нужна реализация какого-то нового свойства, лучший способ- взяться "
"за работу самому! Не забудьте также, что такие моменты лучше обсуждать в "
"списках рассылки, таких как `freebsd-questions`, чем делать это посредством "
"базы данных PR."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:161
msgid ""
"_Make sure no one else has already submitted a similar PR._ Although this "
"has already been mentioned above, it bears repeating here. It only take a "
"minute or two to use the web-based search engine at https://bugs.freebsd.org/"
"bugzilla/query.cgi[https://bugs.freebsd.org/bugzilla/query.cgi]. (Of course, "
"everyone is guilty of forgetting to do this now and then.)"
msgstr ""
"_Убедитесь, что ваша проблема еще никем не описана._ Мы уже говорили об "
"этом, но стоит повториться. Потратьте пару минут на составление запросов к "
"базе PR: https://bugs.freebsd.org/bugzilla/query.cgi[https://"
"bugs.freebsd.org/bugzilla/query.cgi]. (Несмотря на повторы, об этом "
"постоянно забывают)"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:162
msgid ""
"_Report only one issue per Problem Report._ Avoid including two or more "
"problems within the same report unless they are related. When submitting "
"patches, avoid adding multiple features or fixing multiple bugs in the same "
"PR unless they are closely related-such PRs often take longer to resolve."
msgstr ""
"_Сообщайте об одной проблеме в одном PR._ Избегайте описания двух и более "
"проблем в одном сообщении (исключением являются взаимосвязанные проблемы). "
"Оформляя патчи, не пытайтесь в них добавлять множество функциональных "
"возможностей или исправлять ими несколько ошибок в одном и том же сообщении "
"о проблеме (опять же, за исключением взаимосвязанных проблем) - для таких PR-"
"ов потребуется значительно больше времени на обработку."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:163
msgid ""
"_Avoid controversial requests._ If your PR addresses an area that has been "
"controversial in the past, you should probably be prepared to not only offer "
"patches, but also justification for why the patches are \"The Right Thing To "
"Do\". As noted above, a careful search of the mailing lists using the "
"archives at https://www.FreeBSD.org/search/#mailinglists[https://"
"www.FreeBSD.org/search/#mailinglists] is always good preparation."
msgstr ""
"_Избегайте полемики._ Если ваше сообщение касается области или способов "
"реализации, которые ранее вызвали разногласия, вам стоит быть готовым "
"предоставить не только патчи, но и внятные аргументы, почему следует "
"поступать именно так (то есть, это \"Правильный Путь\"). Как отмечалось "
"выше, аккуратный поиск по архиву списков рассылки https://www.FreeBSD.org/"
"search/#mailinglists[https://www.FreeBSD.org/search/#mailinglists] никогда "
"не помешает."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:164
msgid ""
"_Be polite._ Almost anyone who would potentially work on your PR is a "
"volunteer. No one likes to be told that they have to do something when they "
"are already doing it for some motivation other than monetary gain. This is a "
"good thing to keep in mind at all times on Open Source projects."
msgstr ""
"_Будьте вежливы._ Почти каждый из тех, кто может заниматься вашим "
"сообщением, является добровольцем. Никому не понравятся указания, как и что "
"делать, когда он и так занимается этим, да еще и по каким-либо причинам, "
"отличным от финансовых. Вообще говоря, этого подхода следует придерживаться, "
"имея дело с любым проектом с Открытыми Исходными текстами (Open Source)."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:166
#, no-wrap
msgid "Before Beginning"
msgstr "Прежде всего"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:170
msgid ""
"Similar considerations apply to use of the https://bugs.freebsd.org/bugzilla/"
"enter_bug.cgi[web-based PR submission form].  Be careful of cut-and-paste "
"operations that might change whitespace or other text formatting."
msgstr ""
"Аналогичные соображения применимы к использованию https://bugs.freebsd.org/"
"bugzilla/enter_bug.cgi[веб-формы для отправки PR]. Будьте осторожны с "
"операциями копирования и вставки, которые могут изменить пробелы или другое "
"форматирование текста."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:172
msgid ""
"Finally, if the submission is lengthy, prepare the work offline so that "
"nothing will be lost if there is a problem submitting it."
msgstr ""
"И наконец, если ваше сообщение будет объёмным, вы должны приготовить его в "
"offline, чтобы ничего не потерялось в случае, если будет проблема при его "
"отправке."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:174
#, no-wrap
msgid "Attaching Patches or Files"
msgstr "Вложение патчей или файлов"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:182
msgid ""
"In general, we recommend using `git format-patch` to generate one or a "
"series of unified diff against the base branch (e.g. `origin/main`).  "
"Patches generated this way would include the Git hashes and will include "
"your name and email address, making it easier for committers to apply your "
"patch and properly credit you as the author (using `git am`).  For minor "
"changes where you prefer not to use git, please be sure to use man:diff[1] "
"with the `-u` option to create a unified diff, as this would give developers "
"more context and are more readable than other diff formats."
msgstr ""
"В общем, мы рекомендуем использовать `git format-patch` для создания одного "
"или серии унифицированных diff-файлов относительно базовой ветки (например, "
"`origin/main`). Патчи, созданные таким образом, будут содержать хеши Git, а "
"также ваше имя и адрес электронной почты, что упростит применение вашего "
"патча коммиттерами и правильное указание вас как автора (с помощью `git "
"am`). Для небольших изменений, где вы предпочитаете не использовать git, "
"убедитесь, что используете man:diff[1] с опцией `-u` для создания "
"унифицированного diff-файла, так как это даст разработчикам больше контекста "
"и сделает его более читаемым по сравнению с другими форматами diff."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:185
msgid ""
"For problems with the kernel or the base utilities, a patch against FreeBSD-"
"CURRENT (the main Git branch) is preferred since all new code should be "
"applied and tested there first.  After appropriate or substantial testing "
"has been done, the code will be merged/migrated to the FreeBSD-STABLE branch."
msgstr ""
"Для проблем с ядром или базовыми утилитами предпочтителен патч для FreeBSD-"
"CURRENT (основной ветки Git), поскольку весь новый код должен сначала "
"применяться и тестироваться там. После проведения соответствующих или "
"достаточных тестов код будет объединён/перенесён в ветку FreeBSD-STABLE."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:187
msgid ""
"If you attach a patch inline, instead of as an attachment, note that the "
"most common problem by far is the tendency of some email programs to render "
"tabs as spaces, which will completely ruin anything intended to be part of a "
"Makefile."
msgstr ""
"Если вы вставляете патч в тело сообщения, учтите, что некоторые почтовые "
"программы имеют тенденцию заменять табуляции серией пробелов, что полностью "
"разрушит, например, часть файла сборки (Makefile)."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:190
msgid ""
"Do not send patches as attachments using `Content-Transfer-Encoding: quoted-"
"printable`.  These will perform character escaping and the entire patch will "
"be useless."
msgstr ""
"Не отсылайте патчи в виде вложений, используя `Content-Transfer-Encoding: "
"quoted-printable`. Это выполнит экранирование (escaping) символов и весь "
"патч будет бесполезным."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:195
msgid ""
"Also note that while including small patches in a PR is generally all right—"
"particularly when they fix the problem described in the PR-large patches and "
"especially new code which may require substantial review before committing "
"should be placed on a web or ftp server, and the URL should be included in "
"the PR instead of the patch.  Patches in email tend to get mangled, and the "
"larger the patch, the harder it will be for interested parties to unmangle "
"it.  Also, posting a patch on the web allows you to modify it without having "
"to resubmit the entire patch in a followup to the original PR.  Finally, "
"large patches simply increase the size of the database, since closed PRs are "
"not actually deleted but instead kept and simply marked as complete."
msgstr ""
"Следует также заметить, что включение небольших патчей в сообщение о "
"проблеме является приемлемой практикой, в особенности если они решают "
"проблему, описанную в сообщении, большие же патчи, а в особенности новый "
"код, который может требовать значительного просмотра перед тем, как он будет "
"внесен в дерево исходных текстов, должны быть размещены на web- или ftp-"
"сервере, а в сообщение о проблеме должен быть включён только URL указывающий "
"на этот патч. Очень часто патчи, пересылаемые по электронной почте, а в "
"особенности если задействована GNATS, бывают искажены, и, как следствие, чем "
"больше патч, тем труднее будет для заинтересованных людей привести его к "
"нормальному виду. Также то, что патч будет размещён отдельно от сообщения о "
"проблеме, даёт возможность изменять его не отсылая полный патч в дополнение "
"к изначальному сообщению о проблеме. И наконец, большие патчи просто "
"увеличивают размер базы данных, так как закрытые сообщения об ошибках на "
"самом деле не удаляются, а сохраняются и помечаются, как `closed`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:197
msgid ""
"You should also take note that unless you explicitly specify otherwise in "
"your PR or in the patch itself, any patches you submit will be assumed to be "
"licensed under the same terms as the original file you modified."
msgstr ""
"Вы должны также помнить, что пока вы явно не укажете обратного в вашем "
"сообщении о проблеме или в самих патчах, будет предполагаться, что они "
"подпадают под те же условия лицензирования, что и оригинальный файл, "
"измененный вами."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:199
#, no-wrap
msgid "Filling out the Form"
msgstr "Заполнение шаблона"

#. type: delimited block = 4
#: documentation/content/en/articles/problem-reports/_index.adoc:206
msgid ""
"The email address you use will become public information and may become "
"available to spammers.  You should either have spam handling procedures in "
"place, or use a temporary email account.  However, please note that if you "
"do not use a valid email account at all, we will not be able to ask you "
"questions about your PR."
msgstr ""
"Используемый вами адрес электронной почты станет общедоступной информацией и "
"может попасть к спамерам. У вас должны быть процедуры обработки спама или "
"следует использовать временный почтовый аккаунт. Однако учтите, что если вы "
"вообще не используете действительный почтовый аккаунт, мы не сможем задать "
"вам вопросы о вашем PR."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:209
msgid "When you file a bug, you will find the following fields:"
msgstr "При подаче сообщения об ошибке вы увидите следующие поля:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:211
msgid ""
"_Summary:_ Fill this out with a short and accurate description of the "
"problem. The synopsis is used as the subject of the problem report email, "
"and is used in problem report listings and summaries; problem reports with "
"obscure synopses tend to get ignored."
msgstr ""
"_Краткое описание:_ Заполните это кратким и точным описанием проблемы. "
"Краткое описание используется как тема письма с отчётом о проблеме, а также "
"в списках и сводках отчётов; отчёты с неясными описаниями часто остаются без "
"внимания."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:212
msgid ""
"_Severity:_ One of `Affects only me`, `Affects some people` or `Affects many "
"people`. Do not overreact; refrain from labeling your problem `Affects many "
"people` unless it really does. FreeBSD developers will not necessarily work "
"on your problem faster if you inflate its importance since there are so many "
"other people who have done exactly that."
msgstr ""
"_Серьезность:_ Одно из значений: `Затрагивает только меня (Affects only "
"me)`, `Затрагивает некоторых людей (Affects some people)` или `Затрагивает "
"многих людей (Affects many people)`. Не переоценивайте проблему; избегайте "
"отмечать её как `Затрагивает многих людей`, если это не так. Разработчики "
"FreeBSD не обязательно будут работать над вашей проблемой быстрее, если вы "
"преувеличите её важность, поскольку многие другие уже поступали точно так же."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:213
msgid "_Category:_ Choose an appropriate category."
msgstr "_Категория:_ Выберите подходящую категорию."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:218
msgid ""
"The first thing you need to do is to decide what part of the system your "
"problem lies in.  Remember, FreeBSD is a complete operating system, which "
"installs both a kernel, the standard libraries, many peripheral drivers, and "
"a large number of utilities (the \"base system\").  However, there are "
"thousands of additional applications in the Ports Collection.  You'll first "
"need to decide if the problem is in the base system or something installed "
"via the Ports Collection."
msgstr ""
"Первое, что вам нужно сделать, — это определить, в какой части системы "
"находится ваша проблема. Помните, что FreeBSD — это полноценная операционная "
"система, которая включает в себя ядро, стандартные библиотеки, множество "
"драйверов периферийных устройств и большое количество утилит («базовая "
"система»). Однако в Коллекции портов доступны тысячи дополнительных "
"приложений. Сначала вам нужно выяснить, связана ли проблема с базовой "
"системой или с чем-то, установленным через Коллекцию портов."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:220
msgid "Here is a description of the major categories:"
msgstr "Вот описание основных категорий:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:222
msgid ""
"If a problem is with the kernel, the libraries (such as standard C library "
"`libc`), or a peripheral driver in the base system, in general you will use "
"the `kern` category. (There are a few exceptions; see below). In general "
"these are things that are described in section 2, 3, or 4 of the manual "
"pages."
msgstr ""
"Если проблема в ядре, в библиотеках (таких как стандартная библиотека С "
"`libc`) или в драйвере из базовой системы, то используйте категорию `kern`. "
"(Есть несколько исключений, описанных ниже). В общем, это всё, что описано в "
"разделах 2, 3 или 4 справочника."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:223
msgid ""
"If a problem is with a binary program such as man:sh[1] or man:mount[8], you "
"will first need to determine whether these programs are in the base system "
"or were added via the Ports Collection. If you are unsure, you can do "
"`whereis _programname_`. FreeBSD's convention for the Ports Collection is to "
"install everything underneath [.filename]#/usr/local#, although this can be "
"overridden by a system administrator. For these, you will use the `ports` "
"category (yes, even if the port's category is `www`; see below). If the "
"location is [.filename]#/bin#, [.filename]#/usr/bin#, [.filename]#/sbin#, or "
"[.filename]#/usr/sbin#, it is part of the base system, and you should use "
"the `bin` category. These are all things that are described in section 1 or "
"8 of the manual pages."
msgstr ""
"Если проблема с бинарной программой, например с man:sh[1] или man:mount[8], "
"то вам прежде всего необходимо определить принадлежность программы к базовой "
"системе или к установке из коллекции портов. Если вы не уверены, выполните "
"команду `whereis _имя программы_`. В FreeBSD для коллекции портов существует "
"договоренность: установка ведется в [.filename]#/usr/local#, однако это "
"может быть переопределено системным администратором. Для таких программ "
"следует использовать категорию `ports` (даже если категория порта `www`; см. "
"ниже). Если программа располагается в [.filename]#/bin#, [.filename]#/usr/"
"bin#, [.filename]#/sbin# или в [.filename]#/usr/sbin#, то это часть базовой "
"системы, и вам следует использовать категорию `bin`. (Несколько программ, "
"например man:gcc[1], на самом деле используют категорию `gnu`, но не "
"беспокойтесь об этом сейчас.) Программы этой категории описаны в разделах 1 "
"и 8 справочной системы."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:224
msgid ""
"If you believe that the error is in the startup `(rc)` scripts, or in some "
"kind of other non-executable configuration file, then the right category is "
"`conf` (configuration). These are things that are described in section 5 of "
"the manual pages."
msgstr ""
"Если вы уверены, что в стартовых скриптах `(rc)` или в каком-то ином "
"неисполняемом конфигурационном файле присутствует ошибка, тогда верной "
"категорией будет `conf` (configuration). Эти сущности описываются в разделе "
"5 справочной системы."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:225
msgid ""
"If you have found a problem in the documentation set (articles, books, man "
"pages) or website the correct choice is `docs`."
msgstr ""
"Если вы нашли проблему в наборе документации (статьи, книги, страницы "
"справочной системы), правильным выбором будет `docs`."

#. type: delimited block = 4
#: documentation/content/en/articles/problem-reports/_index.adoc:229
msgid ""
"if you are having a problem with something from a port named `www/"
"_someportname_`, this nevertheless goes in the `ports` category."
msgstr ""
"Если проблема с чем-то из порта, называемого `www/_имяпорта_`, то она все же "
"принадлежит к категории `ports`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:232
msgid "There are a few more specialized categories."
msgstr "Далее представлены более специализированные категории."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:234
msgid ""
"If the problem would otherwise be filed in `kern` but has to do with the USB "
"subsystem, the correct choice is `usb`."
msgstr ""
"Если проблема принадлежит к `kern`, но в то же время имеет дело с "
"подсистемой USB, то правильным выбором будет `usb`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:235
msgid ""
"If the problem would otherwise be filed in `kern` but has to do with the "
"threading libraries, the correct choice is `threads`."
msgstr ""
"Если проблема принадлежит к `kern` и найдена в потоковых библиотеках, "
"правильным выбором будет `threads`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:236
msgid ""
"If the problem would otherwise be in the base system, but has to do with our "
"adherence to standards such as POSIX(R), the correct choice is `standards`."
msgstr ""
"Если проблема принадлежит к базовой системе и касается соблюдения "
"стандартов, таких как POSIX(R), правильным выбором будет `standards`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:237
msgid ""
"If you are convinced that the problem will only occur under the processor "
"architecture you are using, select one of the architecture-specific "
"categories: commonly `i386` for Intel-compatible machines in 32-bit mode; "
"`amd64` for AMD machines running in 64-bit mode (this also includes Intel-"
"compatible machines running in EMT64 mode); and less commonly `arm` or "
"`powerpc`."
msgstr ""
"Если вы уверены, что проблема возникнет только на используемой вами "
"архитектуре процессора, выберите одну из архитектурно-зависимых категорий: "
"обычно `i386` для Intel-совместимых машин в 32-битном режиме; `amd64` для "
"машин AMD, работающих в 64-битном режиме (это также включает Intel-"
"совместимые машины, работающие в режиме EMT64); и реже `arm` или `powerpc`."

#. type: delimited block = 4
#: documentation/content/en/articles/problem-reports/_index.adoc:241
msgid ""
"These categories are quite often misused for \"I do not know\" problems. "
"Rather than guessing, please just use `misc`."
msgstr ""
"Люди часто ошибаются в выборе категории. Если вы не уверены в правильности "
"выбора, то лучше не гадать, а выбрать `misc`."

#. type: Block title
#: documentation/content/en/articles/problem-reports/_index.adoc:243
#, no-wrap
msgid "Correct Use of Arch-Specific Category"
msgstr "Правильное использование архитектурно-зависимых категорий"

#. type: delimited block = 4
#: documentation/content/en/articles/problem-reports/_index.adoc:247
msgid ""
"You have a common PC-based machine, and think you have encountered a problem "
"specific to a particular chipset or a particular motherboard: `i386` is the "
"right category."
msgstr ""
"У вас простой ПК, и вы подозреваете, что столкнулись с проблемой, "
"специфичной для конкретного чипсета или материнской платы: верная категория "
"- `i386`."

#. type: Block title
#: documentation/content/en/articles/problem-reports/_index.adoc:249
#, no-wrap
msgid "Incorrect Use of Arch-Specific Category"
msgstr "Некорректное использование категории, зависящей от архитектуры"

#. type: delimited block = 4
#: documentation/content/en/articles/problem-reports/_index.adoc:253
msgid ""
"You are having a problem with an add-in peripheral card on a commonly seen "
"bus, or a problem with a particular type of hard disk drive: in this case, "
"it probably applies to more than one architecture, and `kern` is the right "
"category."
msgstr ""
"Если вы наблюдаете проблему с периферийной картой расширения на "
"распространенной шине или неполадки с конкретного типа жестким диском: в "
"этом случае возможно, что неисправность наблюдается на более чем одной "
"архитектуре, и верным выбором будет `kern`."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:255
msgid ""
"If you really do not know where the problem lies (or the explanation does "
"not seem to fit into the ones above), use the `misc` category. Before you do "
"so, you may wish to ask for help on the {freebsd-questions} first. You may "
"be advised that one of the existing categories really is a better choice."
msgstr ""
"Если вы не знаете в чем проблема (или вам кажется, что описание не попадает "
"ни под какую из вышеобозначенных), используйте категорию `misc`. Перед тем, "
"как написать PR, можно для начала спросить помощи в {freebsd-questions}. "
"Возможно, там вам подскажут, какую из существующих категорий следует выбрать."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:256
msgid ""
"_Environment:_ This should describe, as accurately as possible, the "
"environment in which the problem has been observed. This includes the "
"operating system version, the version of the specific program or file that "
"contains the problem, and any other relevant items such as system "
"configuration, other installed software that influences the problem, etc.—"
"quite simply everything a developer needs to know to reconstruct the "
"environment in which the problem occurs."
msgstr ""
"_Environment:_ Оно должно максимально точно описывать окружение, в котором "
"встречается проблема. Сюда включается версия операционной системы, версия "
"конкретной программы или файла, содержащего проблему, и любая другая "
"информация, такая, как конфигурация системы, другое программное обеспечение, "
"которое влияет на проблему, и так далее-просто все, что разработчик должен "
"знать для создания условий появления проблемы."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:257
msgid ""
"_Description:_ A complete and accurate description of the problem you are "
"experiencing. Try to avoid speculating about the causes of the problem "
"unless you are certain that you are on the right track, as it may mislead a "
"developer into making incorrect assumptions about the problem. It should "
"include the actions you need to take to reproduce the problem. If you know "
"any workaround, include it. It not only helps other people with the same "
"problem work around it, but may also help a developer understand the cause "
"for the problem."
msgstr ""
"_Описание:_ Полное и точное описание проблемы, с которой вы столкнулись. "
"Старайтесь избегать предположений о причинах проблемы, если не уверены в "
"своей правоте, так как это может ввести разработчика в заблуждение и "
"привести к неверным выводам. В описании должны быть указаны действия, "
"необходимые для воспроизведения проблемы. Если вам известен обходной путь, "
"укажите его. Это не только поможет другим людям с той же проблемой временно "
"её решить, но и может помочь разработчику понять причину возникновения "
"проблемы."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:259
#, no-wrap
msgid "Follow-up"
msgstr "Отслеживание"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:264
msgid ""
"Once the problem report has been filed, you will receive a confirmation by "
"email which will include the tracking number that was assigned to your "
"problem report and a URL you can use to check its status.  With a little "
"luck, someone will take an interest in your problem and try to address it, "
"or, as the case may be, explain why it is not a problem.  You will be "
"automatically notified of any change of status, and you will receive copies "
"of any comments or patches someone may attach to your problem report's audit "
"trail."
msgstr ""
"После того, как ваше сообщение будет принято, вы получите по электронной "
"почте уведомление, в котором будет указан номер для отслеживания, который "
"был назначен вашему сообщению о проблеме и URL, который вы можете "
"использовать для проверки его состояния. В случае удачи кто-нибудь проявит "
"интерес к вашей проблеме и попытается ее решить, или, как это бывает, "
"описать, почему это не является проблемой. Вы будете автоматически "
"оповещаться о любом изменении состояния и получать копии всех комментариев "
"или патчей, которые будут присоединяться в процессе отработки вашего "
"сообщения о проблеме."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:268
msgid ""
"If someone requests additional information from you, or you remember or "
"discover something you did not mention in the initial report, please submit "
"a follow up.  The number one reason for a bug not getting fixed is lack of "
"communication with the originator.  The easiest way is to use the comment "
"option on the individual PR's web page, which you can reach from the https://"
"bugs.freebsd.org/bugzilla/query.cgi[PR search page]."
msgstr ""
"Если кто-то запросит у вас дополнительную информацию, или вы вспомните или "
"обнаружите что-то, что не упомянули в первоначальном отчёте, пожалуйста, "
"отправьте уточнение. Основная причина, по которой ошибка не исправляется, — "
"это отсутствие связи с автором отчёта. Проще всего воспользоваться опцией "
"комментария на веб-странице конкретного PR, которую можно открыть с https://"
"bugs.freebsd.org/bugzilla/query.cgi[страницы поиска PR]."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:270
msgid ""
"If the problem report remains open after the problem has gone away, just add "
"a comment saying that the problem report can be closed, and, if possible, "
"explaining how or when the problem was fixed."
msgstr ""
"Если проблема исчезла, но отчёт о ней остаётся открытым, просто добавьте "
"комментарий с указанием, что отчёт можно закрыть, и, по возможности, "
"объясните, как или когда проблема была устранена."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:274
msgid ""
"Sometimes there is a delay of a week or two where the problem report remains "
"untouched, not assigned or commented on by anyone.  This can happen when "
"there is an increased problem report backlog or during a holiday season.  "
"When a problem report has not received attention after several weeks, it is "
"worth finding a committer particularly interested in working on it."
msgstr ""
"Иногда возникает задержка в одну-две недели, когда отчёт о проблеме остаётся "
"без внимания — никто не назначается на него и не оставляет комментариев. "
"Такое может произойти при увеличении очереди отчётов о проблемах или во "
"время праздничного сезона. Если отчёт о проблеме не получил внимания в "
"течение нескольких недель, стоит найти коммиттера, особенно "
"заинтересованного в работе над ним."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:276
msgid ""
"There are a few ways to do so, ideally in the following order, with a few "
"days between attempting each communication channel:"
msgstr ""
"Существует несколько способов сделать это, желательно в следующем порядке, с "
"перерывом в несколько дней между попытками использования каждого канала "
"связи:"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:278
msgid ""
"Send an e-mail to extref:{handbook}eresources/[the relevant list, eresources-"
"summary] seeking comments on the report."
msgstr ""
"Отправить письмо по электронной почте в extref:{handbook}eresources/"
"[соответствующий список, eresources-summary] для получения комментариев к "
"отчету."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:279
msgid ""
"Join the relevant IRC channels. A partial listing is here: https://"
"wiki.freebsd.org/IRC/Channels[]. Inform the people in that channel about the "
"problem report and ask for assistance. Be patient and stay in the channel "
"after posting, so that the people from different time zones around the world "
"have a chance to catch up."
msgstr ""
"Присоединитесь к соответствующим IRC-каналам. Частичный список доступен "
"здесь: https://wiki.freebsd.org/IRC/Channels[]. Сообщите участникам канала о "
"проблеме и запросите помощь. Будьте терпеливы и оставайтесь в канале после "
"отправки сообщения, чтобы у людей из разных часовых поясов была возможность "
"отреагировать."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:280
msgid ""
"Find committers interested in the problem that was reported. If the problem "
"was in a particular tool, binary, port, document, or source file, check the "
"https://cgit.FreeBSD.org[Git Repository]. Locate the last few committers who "
"made substantive changes to the file, and try to reach them via IRC or "
"email. A list of committers and their emails can be found in the extref:"
"{contributors}[Contributors to FreeBSD] article."
msgstr ""
"Найдите коммиттеров, заинтересованных в сообщенной проблеме. Если проблема "
"касается конкретного инструмента, бинарного файла, порта, документа или "
"исходного файла, проверьте https://cgit.FreeBSD.org[Git Repository]. "
"Определите последних коммиттеров, внесших существенные изменения в файл, и "
"попытайтесь связаться с ними через IRC или электронную почту. Список "
"коммиттеров и их адреса электронной почты можно найти в статье extref:"
"{contributors}[Участники проекта FreeBSD]."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:284
msgid ""
"Remember that these people are volunteers, just like maintainers and users, "
"so they might not be immediately available to assist with the problem "
"report.  Patience and consistency in the follow-ups is highly advised and "
"appreciated.  With enough care and effort dedicated to that follow-up "
"process, finding a committer to take care of the problem report is just a "
"matter of time."
msgstr ""
"Помните, что эти люди — добровольцы, как и сопровождающие и пользователи, "
"поэтому они могут быть не сразу доступны для помощи с отчётом о проблеме. "
"Терпение и последовательность в дальнейших действиях крайне рекомендуются и "
"ценятся. При достаточном внимании и усилиях, посвящённых этому процессу, "
"найти коммиттера, который займётся отчётом о проблеме — лишь вопрос времени."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:286
#, no-wrap
msgid "If There Are Problems"
msgstr "Если возникли проблемы"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:290
msgid ""
"If you found an issue with the bug system, file a bug! There is a category "
"for exactly this purpose.  If you are unable to do so, contact the bug "
"wranglers at mailto:bugmeister@FreeBSD.org[bugmeister@FreeBSD.org]."
msgstr ""
"Если вы обнаружили проблему в системе отслеживания ошибок, сообщите об "
"ошибке! Для этого существует специальная категория. Если у вас не получается "
"это сделать, свяжитесь с ответственными за обработку ошибок по адресу "
"mailto:bugmeister@FreeBSD.org[bugmeister@FreeBSD.org]."

#. type: Title ==
#: documentation/content/en/articles/problem-reports/_index.adoc:292
#, no-wrap
msgid "Further Reading"
msgstr "Для дальнейшего ознакомления"

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:296
msgid ""
"This is a list of resources relevant to the proper writing and processing of "
"problem reports.  It is by no means complete."
msgstr ""
"Это список информационных ресурсов, относящихся к правильному написанию и "
"обработке сообщений о проблемах. Он, без сомнения, не полон."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:298
msgid ""
"https://github.com/smileytechguy/reporting-bugs-effectively/blob/master/"
"ENGLISH.md[How to Report Bugs Effectively]: An excellent essay by Simon G. "
"Tatham on composing useful (non-FreeBSD-specific) problem reports."
msgstr ""
"https://github.com/smileytechguy/reporting-bugs-effectively/blob/master/"
"ENGLISH.md[How to Report Bugs Effectively]-прекрасное эссе, которое написал "
"Simon G. Tatham о составлении полезных (не специфичных для FreeBSD) "
"сообщений о проблемах."

#. type: Plain text
#: documentation/content/en/articles/problem-reports/_index.adoc:298
msgid ""
"extref:{pr-guidelines}[Problem Report Handling Guidelines]: Valuable insight "
"into how problem reports are handled by the FreeBSD developers."
msgstr ""
"extref:{pr-guidelines}[Problem Report Handling Guidelines]-интересный взгляд "
"на обработку сообщений о проблемах самими разработчиками FreeBSD."