From 62b1c45fc39a993866afa91586105771a8716924 Mon Sep 17 00:00:00 2001 From: Vitaly Bogdanov Date: Wed, 5 Apr 2006 07:18:49 +0000 Subject: MFen: 1.6 --> 1.8 linux-compatison/article.sgml 1.4 --> 1.6 problem-reports/Makefile 1.36 --> 1.44 problem-reports/article.sgml 1.14 --> 1.17 pr-guidelines/article.sgml 1.4 --> 1.6 pr-guidelines/Makefile Obtained from: The FreeBSD Russian Documentation Project --- .../articles/linux-comparison/article.sgml | 136 ++++++------ ru_RU.KOI8-R/articles/pr-guidelines/Makefile | 12 +- ru_RU.KOI8-R/articles/pr-guidelines/article.sgml | 246 ++++++++++++++++++--- ru_RU.KOI8-R/articles/problem-reports/Makefile | 11 +- ru_RU.KOI8-R/articles/problem-reports/article.sgml | 167 ++++++++++---- 5 files changed, 428 insertions(+), 144 deletions(-) (limited to 'ru_RU.KOI8-R') diff --git a/ru_RU.KOI8-R/articles/linux-comparison/article.sgml b/ru_RU.KOI8-R/articles/linux-comparison/article.sgml index d4123af3ef..3a9107e898 100644 --- a/ru_RU.KOI8-R/articles/linux-comparison/article.sgml +++ b/ru_RU.KOI8-R/articles/linux-comparison/article.sgml @@ -33,10 +33,10 @@ Copyright (c) 2005 Dru Lavigne - FreeBSD: Open Source альтернатива Linux + &os;: Open Source альтернатива &linux; Dru @@ -75,8 +75,8 @@ Copyright (c) 2005 Dru Lavigne Цель данной статьи - объяснить некоторые из характеристик и - преимуществ, предоставляемых FreeBSD, и где возможно, сравнить - эти характеристики с Linux. Эта статья предоставляет начальную + преимуществ, предоставляемых &os;, и где возможно, сравнить + эти характеристики с &linux;. Эта статья предоставляет начальную точку для тех, кто заинтересован в изучении Open Source альтернатив Линуксу. @@ -85,15 +85,15 @@ Copyright (c) 2005 Dru Lavigne Введение - FreeBSD - это &unix; подобная операционная система, основанная на - Berkeley Software Distribution. Хотя и FreeBSD и Linux обычно воспринимаются, + &os; - это &unix; подобная операционная система, основанная на + Berkeley Software Distribution. Хотя и &os; и &linux; обычно воспринимаются, как очень похожие, существуют различия: - Linux сам по себе - ядро. Дистрибутивы (например: Red Hat, + &linux; сам по себе - ядро. Дистрибутивы (например: Red Hat, Debian, Suse и другие) предоставляют установщик и утилиты доступные пользователю. На http://www.linux.org/dist представлен список, в котором перечислено более 300 существующих дистрибутивов. @@ -105,7 +105,7 @@ Copyright (c) 2005 Dru Lavigne оконными менеджерами и процедурами установки и корректирования (patching) программного обеспечения. - FreeBSD - это полноценная операционная система (ядро и + &os; - это полноценная операционная система (ядро и пользовательское окружение) с хорошо зарекомендовавшим себя наследием, уходящим своими корнями в истоки разработки Unix.[1] Так как и ядро и предлагаемые утилиты находятся под контролем одной группы @@ -115,11 +115,11 @@ Copyright (c) 2005 Dru Lavigne возможности ядра пользователю просто надо прочесть один файл (Release Notes, Замечания по релизу), который публично доступен на главной странице веб-сайта FreeBSD. + url="http://www.FreeBSD.org">веб-сайта &os;. - FreeBSD имеет большую и хорошо организованную программную + &os; имеет большую и хорошо организованную программную базу, которая гарантирует, что изменения будут осуществляться быстро и под контролем. Существует несколько тысяч программистов, которые вносят код на регулярной основе, но @@ -142,11 +142,11 @@ Copyright (c) 2005 Dru Lavigne - Хотя и FreeBSD и Linux используют Open Source модель + Хотя и &os; и &linux; используют Open Source модель лицензирования, сами лицензии различаются. Linux ядро находится под GPL лицензией, а - FreeBSD использует BSD лицензию. Эти и другие Open Source лицензии более детально описаны на веб-сайте Open Source @@ -169,31 +169,31 @@ Copyright (c) 2005 Dru Lavigne - Характеристики FreeBSD + Характеристики &os; Поддерживаемые платформы - FreeBSD имеет репутацию безопасной, стабильной операционной - системы для Intel (i386) платформы. Тем не менее, FreeBSD также + &os; имеет репутацию безопасной, стабильной операционной + системы для &intel; (&i386;) платформы. Тем не менее, &os; также поддерживает следующие архитектуры: alpha amd64 ia64 - i386 + &i386; pc98 - sparc64 + &sparc64; - В дополнение, продолжается работа по портированию FreeBSD на + В дополнение, продолжается работа по портированию &os; на следующие архитектуры: - ARM - MIPS - PowerPC + &arm; + &mips; + &powerpc; Постоянно обновляющиеся списки поддерживаемого оборудования @@ -201,24 +201,24 @@ Copyright (c) 2005 Dru Lavigne поддерживается ли ваше оборудование. Для серверов имеется отличная поддержка аппаратного RAID и сетевых интерфейсов. - FreeBSD также является великолепной рабочей станцией и операционной + &os; также является великолепной рабочей станцией и операционной системой для лэптопов! Она поддерживает X Window System, ту же, что - используется в Linux дистрибутивах для обеспечения настольного + используется в &linux; дистрибутивах для обеспечения настольного пользовательского интерфейса. FreeBSD также поддерживает более 13,000 простых в установке приложений от третьих лиц, включая KDE, Gnome и OpenOffice. - Существует несколько проектов, призванных облегчить установку FreeBSD в + Существует несколько проектов, призванных облегчить установку &os; в качестве десктопа. Наиболее заметные: FreeSBIE, предоставляющий - LiveCD для FreeBSD. + LiveCD для &os;. PC-BSD, предоставляющий простой в - использовании GUI установщик для FreeBSD, ориентированный на + использовании GUI установщик для &os;, ориентированный на десктоп пользователя. @@ -226,7 +226,7 @@ Copyright (c) 2005 Dru Lavigne Расширяемые подсистемы - FreeBSD предлагает большое количество расширяемых + &os; предлагает большое количество расширяемых подсистем, что позволяет вам настроить FreeBSD окружение под ваши собственные нужды. Некоторые из основных подсистем: @@ -293,7 +293,7 @@ Copyright (c) 2005 Dru Lavigne MAC - MAC, + MAC, Mandatory Access Control (Принудительный контроль доступа) предоставляет хорошо регулируемый доступ к файлам и предназначен для улучшения традиционной авторизации @@ -303,7 +303,7 @@ Copyright (c) 2005 Dru Lavigne варьирующейся от HIPAA согласованности до нужд системы военного класса. - FreeBSD поставляется с модулями, реализующими следующие + &os; поставляется с модулями, реализующими следующие политики; тем не менее подсистема позволяет вам разработать любую требующуюся политику: @@ -320,12 +320,12 @@ Copyright (c) 2005 Dru Lavigne PAM - Как и Linux, FreeBSD имеет поддержку PAM, + Как и &linux;, &os; имеет поддержку PAM, Pluggable Authentication Modules (Подключаемые модули аутенфикации). Это позволяет администратору улучшить - традиционную Unix модель аутенфикации, логин/пароль. - FreeBSD предлагает модули для интегрирования во многие + традиционную &unix; модель аутенфикации, логин/пароль. + &os; предлагает модули для интегрирования во многие механизмы аутенфикации, включая: @@ -348,7 +348,7 @@ Copyright (c) 2005 Dru Lavigne Безопасность Безопасность очень важна для Группы + url="&url.base;/doc/ru_RU.KOI8-R/articles/releng/">Группы подготовки релизов FreeBSD. This manifests itself in several concrete areas: @@ -361,26 +361,26 @@ Copyright (c) 2005 Dru Lavigne безопасностью. Полная информация относительно процедур работы с безопасностью во FreeBSD и где искать информацию по безопасности доступна на . + url="http://www.FreeBSD.org/security/">. Одна из проблем, связанная с Open Source программным обеспечением - это точное количество пригодных приложений. Существуют почти что десятки тысяч проектов Open Source приложений, и каждый с различными уровнями ответной реакции на инциденты, связанные с - безопасностью. FreeBSD приняла этот вызов вместе с VuXML. Всё программное обеспечение, поставляемое с операционной системой FreeBSD, так же, как и любое программное обеспечение доступное в Коллекции портов + url="&url.base;/ports/">Коллекции портов сравнивается с базой данных известных, неисправленных - уязвимостей. Администратор может использовать portaudit - утилиту, чтобы быстро определить, есть ли на FreeBSD системе + уязвимостей. Администратор может использовать &man.portaudit.1; + утилиту, чтобы быстро определить, есть ли на &os; системе уязвимое программное обеспечение, и если есть, получить описание проблемы и URL, содержащее более детальное описание уязвимости. - FreeBSD также предоставляет множество механизмов, которые + &os; также предоставляет множество механизмов, которые позволяют администратору настраивать операционную систему под его нужды, связанные с безопасностью: @@ -395,12 +395,12 @@ Copyright (c) 2005 Dru Lavigne предотвратить изменение или удаление указанных файлов даже суперпользователем. - FreeBSD предлагает 3 встроенных, поддерживающих + &os; предлагает 3 встроенных, поддерживающих NAT файерволов, предлагая больше возможностей для выбора набора правил наиболее подходящего для нужд безопасности. - Ядро FreeBSD легко модифицируется, позволяя - администратору убирать ненужную функциональность. FreeBSD + Ядро &os; легко модифицируется, позволяя + администратору убирать ненужную функциональность. &os; также имеет поддержку загрузочных модулей ядра и предоставляет утилиты для просмотра, загрузки и выгрузки модулей ядра. @@ -412,7 +412,7 @@ Copyright (c) 2005 Dru Lavigne Поддержка - Как и Linux, FreeBSD предлагает много видов поддержки, как свободно + Как и &linux;, &os; предлагает много видов поддержки, как свободно доступных, так и коммерческих. @@ -420,46 +420,46 @@ Copyright (c) 2005 Dru Lavigne - FreeBSD - одна из лучше всего документированных + &os; - одна из лучше всего документированных операционных систем, и документация доступна и как часть операционной системы, так и в Интернете. Страницы справочника конкретны, кратки и предоставляют рабочие примеры. В + url="&url.base;/doc/ru_RU.KOI8-R/books/handbook/"> Руководство по FreeBSD предоставляет вводную информацию и примеры конфигурации почти для каждой задачи, которую кто-то захочет - решить, используя FreeBSD. + решить, используя &os;. - FreeBSD предлагает много поддерживаемых списков + &os; предлагает много поддерживаемых списков рассылки, где ответы архивируются и полностью доступны для поиска. Если у вас есть вопрос, который не затрагивается Руководством, он почти наверняка уже отвечался в списке рассылки. И Руководство и списки рассылки также доступны на нескольких языках, все из которых легко доступны с - . + . Существует множество IRC каналов, посвящённых FreeBSD, форумов и групп пользователей. Смотрите для + url="http://www.FreeBSD.org/support.html"> для выбора. - Если вы ищите администратора FreeBSD, разработчика или + Если вы ищите администратора &os;, разработчика или поддерживающий персонал пошлите описание работы, включающее - географическое местоположение в freebsd-jobs@FreeBSD.org. + географическое местоположение в freebsd-jobs@FreeBSD.org. Коммерческие предложения Существует много поставщиков, которые занимаются коммерческой - поддержкой FreeBSD. Ресурсы по поиску поставщика, находящегося + поддержкой &os;. Ресурсы по поиску поставщика, находящегося поблизости от вас включают в себя: Страничка коммерческих поставщиков на сайте - FreeBSD: + &os;: FreeBSDMall, который продаёт контракты на поддержку примерно 10 лет: . Если ваш проект требует Common Criteria certification, - FreeBSD включает подсистему TrustedBSD MAC для облегчения процесса сертификации. - Преимущества выбора FreeBSD + Преимущества выбора &os; - Существует много преимуществ для включения решений FreeBSD в + Существует много преимуществ для включения решений &os; в вашу IT инфраструктуру: - FreeBSD хорошо документирована и следует множеству + &os; хорошо документирована и следует множеству стандартов. Это позволит вашим существующим вспомогательным и опытным системным администраторам быстро приспособить их существующие Linux и Unix навыки для администрирования FreeBSD. @@ -499,7 +499,7 @@ Copyright (c) 2005 Dru Lavigne которые предоставляют контекст для изменений и исправлений ошибок. Дополнительно, разработчик может легко скопировать любой релиз, просто закачав код с требуемой меткой. В противоположность - сказанному, Linux по традиции не следовал данной модели, но недавно + сказанному, &linux; по традиции не следовал данной модели, но недавно адаптировал более совершенную модель разработки. [5] Разработчики, работающие из дома также имеют @@ -507,7 +507,7 @@ Copyright (c) 2005 Dru Lavigne url="http://www.gnu.org/software/gnats/">GNATS. Они могут и запрашивать и прослеживать существующие ошибки также, как и предоставлять свои патчи на одобрение и возможное внесение в базовый код FreeBSD. - + BSD лицензия позволяет вам свободно модифицировать код, чтобы он подходил для ваших бизнес целей. В отличии от GPL, @@ -519,10 +519,10 @@ Copyright (c) 2005 Dru Lavigne Заключение - FreeBSD - это зрелая Unix-подобная операционная система, включающая в себя - множество возможностей, которые можно ожидать в современной Unix + &os; - это зрелая &unix;-подобная операционная система, включающая в себя + множество возможностей, которые можно ожидать в современной &unix; системе. Для тех, кто хочет внедрить Open Source решение в их - существующую инфраструктуру, FreeBSD будет хорошим выбором. + существующую инфраструктуру, &os; будет хорошим выбором. @@ -538,14 +538,14 @@ Copyright (c) 2005 Dru Lavigne url="http://en.wikipedia.org/wiki/BSD_and_GPL_licensing">. Используя Коллекцию портов + url="&url.base;/ports">Коллекцию портов FreeBSD: для установки программного обеспечения достаточно просто набрать pkg_add -r имя_приложения. Плюс ко всему, весь код доступен через веб-интерфейс: . + url="http://www.FreeBSD.org/cgi/cvsweb.cgi/">. Интересный обзор развивающейся модели разработки Linux может быть найден на -%man; - -%mailing-lists; - -%freebsd; - -%trademarks; + +%articles.ent; ]> @@ -109,12 +103,12 @@ - Через несколько таких итераций Вася и Респондент удавлетворяются + Через несколько таких итераций Вася и Респондент удовлетворяются получающимся патчем, и Вася переносит его в дерево -CURRENT (или непосредственно в -STABLE, если этой проблемы в -CURRENT не наблюдается), при этом при выполнении - коммита в сопутствующем сообщении делается ссылка на сообщение о + коммитта в сопутствующем сообщении делается ссылка на сообщение о проблеме (а также упоминается Респондент, если он последний весь или часть патча), и, если это нужно, начинается отсчёт для MFC. @@ -235,7 +229,7 @@ Состояние patched напрямую связано с предлагаемыми решениями, так что вы можете перейти сразу к состоянию - closed, если Респондент не может простестировать патч, + closed, если Респондент не может протестировать патч, либо на ваших тестовых прогонах он работает. @@ -250,6 +244,10 @@ вы будете иметь дело с несколькими различными типами PR. + + PR, которые ещё никому не назначены. + + PR, которые уже кому-то назначены. @@ -272,8 +270,206 @@ иные типы PR, условия отнесения PR к одному из этих типов, и какое внимание нужно уделять каждому из этих типов. +
+ Неназначенные никому PR + + При появлении, новые PR изначально закрепляются за + общим ответственным. Они обычно именуются, начиная с + freebsd-. Точное значение зависит от + категории; в большинстве случаев это указатель на конкретный + список рассылки &os;. Вот несколько примеров: + + + ответственные по умолчанию + + + + Type + Категории + Ответственный по умолчанию + + + + + + базовая система + bin, conf, gnu, kern, misc + freebsd-bugs + + + + зависит от архитектуры + alpha, i386, ia64, powerpc, sparc64 + freebsd-arch + + + + Коллекция Портов + ports + freebsd-ports-bugs + + + + документация, поставляемая вместе с системой + docs + freebsd-doc + + + + web-страницы сайта &os; (не включая документацию) + www + freebsd-www + + + + соответствие стандартам + standards + freebsd-standards + + + + проблемы с JVM + java + freebsd-java + + + + усилия по адвакатуре + advocacy + freebsd-advocacy + + +
+ + Не удивляйтесь, обнаружив, что сабмиттер PR присвоил его в + неверную категорию. Если вы измените категорию, не забудьте + также изменить присваивание. (Похоже, что наши сабмиттеры + с трудом понимают, что только потому что проблема объявлена на + i386 системе, она может быть общей и для всех систем, на + которых работает &os;, и поэтому более бы подходила для + категории kern. Обратное естесвенно + тоже верно.) + + PR могут быть переназначены от этих общих ответственных + кем угодно. Для отвественных, являющихся списками рассылки + используйте полное название при присваиваниии (к примеру, + freebsd-foo вместо foo); + это предотвратит от дублированных сообщений, посланных в + список рассылки. + + + Вот примерный список этих ответственных; он вероятно не полон. + Элементы, имеющие короткую форму являются псевдонимами, + а не списками рассылки. + + + + Common Assignees + + + + Type + Suggested Assignee + + + + + + проблемы с Linux или SVR4 эмуляцией + emulation + + + + проблемы с сетевым стеком + freebsd-net + + + + проблемы с PicoBSD + freebsd-small + + + + проблемы с инфраструктурой портов + (а не с отдельным портом!) + portmgr + + + + проблемы с подсистемой SCSI + freebsd-scsi + + + + проблемы с звуковой подсистемой + sound + + + + проблемы с подсистемой тредов + freebsd-threads + + + + проблемы с sysinstall + freebsd-qa + + + + проблемы с USB подсистемой + freebsd-usb + + + + порт, который поддерживается gnome@FreeBSD.org + gnome + + + + порт, который поддерживается haskell@FreeBSD.org + haskell + + + + порт, который поддерживается kde@FreeBSD.org + kde + + + + порт, который поддерживается + openoffice@FreeBSD.org + freebsd-openoffice + + + + порт, который поддерживается perl@FreeBSD.org + freebsd-perl + + + + порт, который поддерживается x11@FreeBSD.org + freebsd-x11 + + +
+ + Ports PRs which have a maintainer who is a ports committer + may be reassigned by anyone (but note that not every &os; + committer is necessarily a ports committer, so you cannot + simply go by the email address alone.) + + + Для других сообщений об ошибках, пожалуйста не переназначайте + их другим лицам (кроме себя), если вы не уверены, что данный человек + действительно желает заниматься PR. Это поможет предотвратить + случаи, когда никто не будет попытаться решить определённую + проблему, потому что каждый будет думать, что назначенное лицо + уже занимается ей. + +
+
- Назначение PR + Назначеные PR Если в PR в заполненном поле responsible указано имя разработчика FreeBSD, это значит, что PR взята этим человеком для @@ -294,7 +490,7 @@ Если вы обнаружите, что один и тот же вопрос описывается более чем в одном PR, выберите то, что содержит максимальный объём полезной информации и закройте все остальные, чётко указав номер более полного - PR. Если несколько PR содержат непересекающуюся информацию, перенесите + PR. Если несколько PR содержат не пересекающуюся информацию, перенесите всю недостающую информацию в какой-либо отклик, включая ссылки на остальные PR; затем закройте другие PR (которые теперь полностью перекрыты). @@ -304,7 +500,7 @@ Просроченные PR PR считается простроченным, если оно не модифицировалось в течение - более полугода. При обработке просроченных PR испольщуйте следующую + более полугода. При обработке просроченных PR используйте следующую процедуру: @@ -329,7 +525,7 @@ Если в PR описывается ошибка, которая, как вы знаете, была исправлена как в -CURRENT, так и - -STABLE, закройте его с сообшением, указывающим + -STABLE, закройте его с сообщением, указывающим на даты исправлений в каждой ветке. @@ -396,8 +592,8 @@ Это не реальное PR, а какое-то случайное сообщение, посланное - на адрес bug-followup@freebsd.org или - freebsd-gnats-submit@freebsd.org. + на адрес bug-followup@FreeBSD.org или + freebsd-gnats-submit@FreeBSD.org. @@ -409,7 +605,7 @@ деле требует самых больших усилий от разработчиков. Это не настоящие PR, описывающие отдельные ошибки. Когда по одному из адресов, который прослушивает GNATS на предмет обработки - входящих сообщений, принимается ответ на существуещее PR, то тема + входящих сообщений, принимается ответ на существующее PR, то тема ответа должна быть всегда в таком виде: Subject: Re: category/number: старая тема @@ -424,8 +620,8 @@ Все разработчики FreeBSD, имеющие прямой доступ к базе данных GNATS, могут регулярно проверять наличие таких PR и перемещать заинтересовавшие их в отклики к оригинальному PR (послав корректный - отклик на сообщение об ошиюке на адрес - bug-followup@freebsd.org). Затем неправильно + отклик на сообщение об ошибке на адрес + bug-followup@FreeBSD.org). Затем неправильно оформленное PR может быть закрыто с примерно таким пояснением: Your problem report was misfiled. Please use the format @@ -488,7 +684,7 @@ This was misfiled because the subject didn't have the format: которые проделывают странные вещи с обычными текстовыми сообщениями. Это происходит не постоянно, и может быть исправлено программой edit-pr; это требует некоторых усилий со стороны - разработчика, которые перевводит PR, однако в большинстве случаев + разработчика, которые переводит PR, однако в большинстве случаев это можно сделать относительно легко.
@@ -501,7 +697,7 @@ This was misfiled because the subject didn't have the format: сообщениями об ошибках, которые форматированы при помощи шаблона &man.send-pr.1;. Они не могут обрабатывать любые сообщения электронной почты. Вот почему сообщения об ошибках, посылаемые на - адрес freebsd-gnats-submit@freebsd.org, должны + адрес freebsd-gnats-submit@FreeBSD.org, должны быть оформлены по шаблону команды send-pr, хотя сообщения по электронной почте можно послать на &a.bugs;. @@ -548,7 +744,7 @@ This was misfiled because the subject didn't have the format: Как писать + url="&url.articles.problem-reports;/article.html">Как писать Сообщения об ошибках FreeBSD—руководство для авторов PR. diff --git a/ru_RU.KOI8-R/articles/problem-reports/Makefile b/ru_RU.KOI8-R/articles/problem-reports/Makefile index 303d5b0028..ba3d0cf1b5 100644 --- a/ru_RU.KOI8-R/articles/problem-reports/Makefile +++ b/ru_RU.KOI8-R/articles/problem-reports/Makefile @@ -2,22 +2,23 @@ # The FreeBSD Russian Documentation Project # # $FreeBSD$ -# $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/problem-reports/Makefile,v 1.2 2003/11/08 14:35:28 phantom Exp $ +# $FreeBSDru: frdp/doc/ru_RU.KOI8-R/articles/problem-reports/Makefile,v 1.3 2005/06/30 03:23:24 gad Exp $ # -# Original revision: 1.4 +# Original revision: 1.6 # +# Article: Writing FreeBSD Problem Reports DOC?= article FORMATS?= html +WITH_ARTICLE_TOC?= YES INSTALL_COMPRESSED?=gz INSTALL_ONLY_COMPRESSED?= -WITH_ARTICLE_TOC?=YES - -SRCS= article.sgml +SRCS= article.sgml +URL_RELPREFIX?= ../../../.. DOC_PREFIX?= ${.CURDIR}/../../.. .include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/ru_RU.KOI8-R/articles/problem-reports/article.sgml b/ru_RU.KOI8-R/articles/problem-reports/article.sgml index 7ee5ad2d4c..65da81cfeb 100644 --- a/ru_RU.KOI8-R/articles/problem-reports/article.sgml +++ b/ru_RU.KOI8-R/articles/problem-reports/article.sgml @@ -1,9 +1,9 @@ + + Для не поддерживаемых никем портов (переменная MAINTAINER + содержит ports@FreeBSD.org), такие уведомления о + обновлении будут замечены заинтересовавшимся коммиттером и вас + могут попросить предоставить патч для обновления порта; предоставление патча + до того, как вас попросят об этом сильно увеличит шансы того, + что порт будет обновлён вовремя. + + Если порт поддерживается, PR-ы, указывающие о появлении новых + улучшенных (upstream) релизов обычно не очень полезны, так как они + прибавляют много вспомогательной работы для коммиттеров, а мэйнтейнер + наверняка уже знает о новой версии. Они уже наверняка работали с + разработчиками над ней или они возможно тестируют её, чтобы убедиться + в отсутствии регрессии и т.п. + + В любом случае, следование процессу, описанному в Руководстве по + созданию портов даст наилучшие результаты. + - Кроме того, если система, на которой вы столкнулись с ошибкой, давно - не обновлялась, вы должны серьезно подумать об обновлении и попытаться - воспроизвести проблему на обновленной системе прежде, чем посылать - сообщение о проблеме. Есть лишь несколько вещей, которые выводят из - себя разработчика больше, чем получение сообщений об уже исправленных - ошибках. - - И наконец, ошибка, которую нельзя воспроизвести, вряд ли будет + Ошибка, которую нельзя воспроизвести, вряд ли будет исправлена. Если ошибка возникла только единожды, и вы не можете ее воспроизвести, к тому же никто с ней больше не сталкивался, нет никаких шансов, что разработчики смогут ее воспроизвести или понять, что делается @@ -132,6 +144,71 @@ работы жёстких дисков, перегревшихся процессоров. Всегда, когда это возможно вы должны отслеживать такие случаи перед посылкой сообщения об ошибке. + + Теперь, чтобы определить кому вы должны отправить ваше сообщение об + ошибке, вы должны понимать, что программное обеспечение, которое входит + во &os;, составляется из нескольких различных частей: + + + + Код в базовой системе, который пишется и поддерживается + контрибьюторами &os;. Такой, как ядро, библиотека C, + драйвера устройств (входят в категорию kern); + утилиты (bin); страницы справочника и + документация (docs); web-страницы + (www). Все ошибки в этих областях + должны быть сообщены разработчикам &os;. + + + + Код в базовой системе, который пишется и поддерживается + другим, импортируется во &os; и адаптируется. Примеры + включают в себя: bind, &man.gcc.1; и + &man.sendmail.8;. Большинство ошибок, попадающие в данные + области должны быть сообщены разработчикам &os;, но в + некоторых случаях они должны быть отправлены изначальным + разработчикам, если проблемы не являются специфичными + для &os;. Обычно ошибки такого рода попадают под + категории bin или gnu. + + + + Отдельные приложения, не входящие в базовую систему, + но являющиеся частью Коллекции Портов &os; (категория + ports). Большинство этих приложений + не пишется разработчиками &os;; что предоставляет &os;, + так это только лишь инфраструктуру для установки приложения. + Следовательно, вы должны отправлять сообщение об ошибке + разработчикам &os; только тогда, когда вы уверены в том, что + проблема специфична для &os; - иначе отправляйте её авторам + программного обеспечения. + + + + Затем вы должны убедиться, действительно ли проблема существует. + Существует всего несколько вещей, которые раздражают разработчика больше, + чем получение сообщения об ошибке, которую он уже исправил. + + Если проблема в базовой системе, то вам нужно сначала прочесть + раздел версии &os; + из FAQ, если вы ещё не знакомы с данной темой. Для &os; возможно + исправлять проблемы только для некоторых недавних веток базовой + системы, поэтому отправка сообщения об ошибке для более старой версии + приведёт к тому, что разработчик посоветует вам обновиться до + поддерживаемой версии, чтобы посмотреть присутствует ли в ней + проблема. Команда офицеров безопасности поддерживает список поддерживаемых + версий.. + + Если проблема связана с портами, помните, что вы сначала + должны обновиться до самой последней версии Коллекции Портов + и проверить, существует ли в ней проблема. Из-за быстрых + внесений изменений в эти приложения, неосуществимым для &os; + является поддержка чего-либо, кроме самых последних версий, и + проблемы со устаревшими версиями приложений просто не могут + быть исправлены. +
@@ -209,25 +286,6 @@ - - Теперь вам нужно добиться того, чтобы сообщение о проблеме - попало в нужные руки. - - Здесь первым правилом будет то, что если проблема является ошибкой в - программном обеспечении сторонних разработчиков (порт или пакет, которые - вы установили), то вы должны сообщить об ошибке автору программы, а не в - Проект &os;. Есть два исключения из этого правила: во-первых, если - ошибка не проявляется на других платформах, то в этом случае проблема - может заключаться в том, как программное обеспечение было перенесено на - &os;; во-вторых, если автор уже исправил ошибку и выпустил патч или - новую версию своей программы, а порт &os; еще не был обновлен. - - Вторым правилом является то, что система отслеживания ошибок &os; - сортирует сообщения о проблеме в соответствии с категорией, выбранной - тем, кто сообщает о проблеме. Таким образом, если вы выберете - неправильную категорию при отправке сообщения о проблеме, есть большая - вероятность того, что его не заметят до тех пор, пока кто-нибудь не - сменит его категорию.
@@ -437,7 +495,7 @@
Прежде всего - Перед запуском утилиты &man.send-pr.1; проверьте, что переменная + Если вы используйте утилиту &man.send-pr.1; проверьте, что переменная вашего окружения VISUAL (или EDITOR, если VISUAL не задана) задана подходящим образом. @@ -449,6 +507,27 @@ почты во &os; можно прочитать в главе Электронная почта Руководства по &os; по адресу . + + Убедитесь, что ваш почтовый клиент не исказит сообщение по + пути в GNATS. В частности, если ваш почтовый клиент автоматически + переносит строки, изменяет символы табуляции на пробелы или + предотвращает интерпретацию символов новой строки, любой патч, + который вы пришлёте окажется непригодным. Для текста мы хотели + бы, чтобы вы делали строчки размером примерно в 70 символов + для читабельности PR на веб странице. + + Примерные соображения должны учитываться при отправке + сообщения об ошибке через web-форму вместо &man.send-pr.1;. + Помните, что операции копирования-вставки могут иметь + сторонние эффекты в форматировании текста. В определённых + случаях может быть необходимо использовать &man.uuencode.1; + для гарантии того, что патчи придут не изменёнными. + + И наконец, если ваше сообщение будет объёмным, вы должны + приготовить его в offline, чтобы ничего не потерялось в случае, + если будет проблема при его отправке. Это особенно касается + web-формы. +
@@ -482,6 +561,11 @@ почтовые программы имеют тенденцию заменять табуляции серией пробелов, что полностью разрушит, например, часть файла сборки (Makefile). + Не отсылайте патчи в виде вложений, используя + Content-Transfer-Encoding: quoted-printable. + Это выполнит экранирование (escaping) символов и весь патч + будет бесполезным. + Следует также заметить, что включение небольших патчей в сообщение о проблеме является приемлемой практикой, в особенности если они решают проблему, описанную в сообщении, большие же патчи, а в особенности @@ -494,7 +578,10 @@ заинтересованных людей привести его к нормальному виду. Также то, что патч будет размещён отдельно от сообщения о проблеме, даёт возможность изменять его не отсылая полный патч в дополнение к изначальному - сообщению о проблеме. + сообщению о проблеме. И наконец, большие патчи просто увеличивают + размер базы данных, так как закрытые сообщения об ошибках на самом + деле не удаляются, а сохраняются и помечаются, как + closed. Вы должны также помнить, что пока вы явно не укажете обратного в вашем сообщении о проблеме или в самих патчах, будет предполагаться, @@ -532,6 +619,14 @@ вы используете &os.stable;. + + Confidential: Предварительно заполнено как + no, его изменение не имеет значения, так как нет + такого понятия, как конфиденциальное сообщение о + проблеме—база данных PR распространяется по всему миру + посредством CVSup. + + Originator: Обычно оно заполнено полем дополнительной информации учетной записи пользователя. Пожалуйста, @@ -544,14 +639,6 @@ указать. Это поле не содержит значительной информации. - - Confidential: Предварительно заполнено как - no, его изменение не имеет значения, так как нет - такого понятия, как конфиденциальное сообщение о - проблеме—база данных PR распространяется по всему миру - посредством CVSup. - - Synopsis: Заполняется кратким и точным описанием проблемы. Краткое описание используется в качестве темы @@ -829,7 +916,7 @@ Или просто просто пошлите письмо на адрес - bug-followup@FreeBSD.org, включив отслеживаемый номер + &a.bugfollowup;, включив отслеживаемый номер в теме письма, чтобы система отслеживания сообщений могла знать, к какому сообщению о проблеме его присоединить. -- cgit v1.3