From dbb44744c1f61ea24d719f3d6052bc61551e5770 Mon Sep 17 00:00:00 2001 From: Dmitry Morozovsky Date: Sun, 5 Feb 2006 17:55:22 +0000 Subject: MFen: 1.229 -> 1.235 committers-guide/article.sgml 1.15 -> 1.16 cvs-freebsd/article.sgml 1.7 -> 1.9 portbuild/article.sgml Obtained from: The FreeBSD Russian Documentation Project --- .../articles/committers-guide/article.sgml | 127 ++++++++++++++++----- ru_RU.KOI8-R/articles/cvs-freebsd/article.sgml | 34 +++--- ru_RU.KOI8-R/articles/portbuild/article.sgml | 69 ++++++----- 3 files changed, 160 insertions(+), 70 deletions(-) (limited to 'ru_RU.KOI8-R') diff --git a/ru_RU.KOI8-R/articles/committers-guide/article.sgml b/ru_RU.KOI8-R/articles/committers-guide/article.sgml index 4937674f15..e3b1b72d7a 100644 --- a/ru_RU.KOI8-R/articles/committers-guide/article.sgml +++ b/ru_RU.KOI8-R/articles/committers-guide/article.sgml @@ -2,9 +2,9 @@ @@ -111,6 +111,7 @@ Наиболее значимые метки CVS RELENG_4 (ветвь 4.X-STABLE), RELENG_5 (ветвь 5.X-STABLE), + RELENG_6 (ветвь 6.X-STABLE), HEAD (ветвь -CURRENT) @@ -745,11 +746,11 @@ alias scvs env CVS_RSH=ssh cvs -d user@ncvs.FreeBSD.o Почти наверняка вы получите конфликт в строках, содержащих - идентификатор файла ($Id: article.sgml,v 1.11 2005-09-25 06:48:30 marck Exp $ или, в случае FreeBSD, + идентификатор файла ($Id: article.sgml,v 1.12 2006-02-05 17:55:22 marck Exp $ или, в случае FreeBSD, $FreeBSD$). Вам потребуется отредактировать файл для устранения конфликта (в данном случае достаточно убрать строки-разделители и вторую строку - $Id: article.sgml,v 1.11 2005-09-25 06:48:30 marck Exp $, оставив лишь строку с $Id: article.sgml,v 1.11 2005-09-25 06:48:30 marck Exp $ + $Id: article.sgml,v 1.12 2006-02-05 17:55:22 marck Exp $, оставив лишь строку с $Id: article.sgml,v 1.12 2006-02-05 17:55:22 marck Exp $ для &os.stable;). @@ -2635,6 +2636,30 @@ docs:Documentation Bug:freebsd-doc: кто поддерживает актуальное состояние дерева портов целиком, и, наконец, что подобные предложения неизбежно вызовут споры и расхождения во мнениях. + + + Обратитесь к разделу + + Proposing a New Category Руководства по созданию портов. + После передачи PR группе &a.portmgr; решение о создании категории + остается за ней. В случае утверждения новой категории кто-либо + из &a.portmgr; делает следующее: + + + + Производит нужные репозиторные копирования. + + + + Обновляет определения VALID_CATEGORIES + в файле ports/Mk/bsd.port.mk. + + + + + Возвращает PR вам. + + @@ -2647,18 +2672,6 @@ docs:Documentation Bug:freebsd-doc: Процедура является надстройкой над уже описанной процедурой репозиторного копирования отдельного порта. - Создайте в GNATS PR с описанием - причин для создания новой категории. Желательно, чтобы запрос - содержал патчи к файлам Makefile - переносимых портов, их старых категорий, а также к определению - списка VALID_CATEGORIES в файле - ports/Mk/bsd.port.mk. Передайте PR группе - &a.portmgr; (portmgr). Если порт-менеджер - одобрит изменения, он передаст PR группе &a.cvsadm; - (cvs), один из членов которой выполнит - копирование и вернет PR вам. В завершение вам нужно произвести - следующие действия: - Обновите файлы Makefile для всех @@ -2737,6 +2750,18 @@ docs:Documentation Bug:freebsd-doc: для старых категорий. + + Добавьте в файл CVSROOT-ports/modules + строку + ports_categoryname   categoryname + + + Поля должны быть разделены табуляцией. + + Если categoryname + содержит дефисы, замените их на подчеркивания. + + Поменяйте строки для затронутых модулей в файле CVSROOT-ports/modules. @@ -2748,21 +2773,69 @@ docs:Documentation Bug:freebsd-doc: - Обновите список коллекций для &man.cvsup.1; в файле - distrib/cvsup/sup/README и добавьте - два файла в каталог - cvsup/sup/ports-categoryname: - list.cvs и - releases. (Обратите внимание: эти - файлы расположены в репозитории src, а не ports). + Обновите инструкции для &man.cvsup.1;: + + + + + Добавьте категорию в файл + distrib/cvsup/sup/README + + + + + + Добавьте в каталог + distrib/cvsup/sup/ports-categoryname + два файла: + list.cvs и + releases. + + + + + Добавьте категорию в файл + src/share/examples/cvsup/ports-supfile + + + + + + (Обратите внимание: эти + файлы расположены в репозитории src, а не ports). + Если вы не являетесь коммиттером src, вам потребуется + создать PR. - Создайте PR в категории документации (doc) для - добавления новой категории портов в Обновите документацию: + + + + + - Руководстве FreeBSD по созданию портов и в файл - www/en/ports/categories. + Руководство FreeBSD по созданию портов + + + + + Файл www/en/ports/categories. + Обратите внимание, что строки в них сгруппированы по + категориям, описанным в файле + www/en/ports/categories.descriptions. + + + + + Раздел Руководства, перечисляющий + + cvsup коллекции. + + + (Внимание: все эти файлы находятся в репозитории + документации. Если вы не являетесь коммиттером в этой области, + создайте PR в категории документации (doc). diff --git a/ru_RU.KOI8-R/articles/cvs-freebsd/article.sgml b/ru_RU.KOI8-R/articles/cvs-freebsd/article.sgml index 4ca9059830..50a7cc89e0 100644 --- a/ru_RU.KOI8-R/articles/cvs-freebsd/article.sgml +++ b/ru_RU.KOI8-R/articles/cvs-freebsd/article.sgml @@ -1,9 +1,9 @@ &prompt.user; cvs -d path-to-repository init - Разультатом ее выполнения будет созданный + Результатом ее выполнения будет созданный CVS служебный - каталог CVSROOT, в котором выполняется вся + каталог CVSROOT, в котором выполняется вся настройка. @@ -117,25 +117,25 @@ Получение исходных текстов - Теперь вам нужно получить каталог CVSROOT из + Теперь вам нужно получить каталог CVSROOT из хранилища FreeBSD. Проще всего это делается извлечением с анонимного зеркала CVS FreeBSD. Обратитесь к соответствующей главе Руководства для получения дополнительной информации. Мы будем полагать, что исходные тексты хранятся в подкаталоге - CVSROOT-freebsd текущего каталога. + CVSROOT-freebsd текущего каталога. Копирование скриптов FreeBSD Теперь мы скопируем исходные тексты FreeBSD из - CVSROOT в наше хранилище. Если вы знакомы с + CVSROOT в наше хранилище. Если вы знакомы с CVS, то для вас может иметь смысл попытаться импортировать скрипты, чтобы облегчить синхронизацию с последующими версиями. Однако при этом оказывается, что CVS имеет в этой области недостаток: при - импортировании исходных текстов в каталог CVSROOT + импортировании исходных текстов в каталог CVSROOT она не будет обновлять необходимые административные файлы. Чтобы в этом убедиться, вам нужно проверить каждый файл после импортирования, при этом смысл cvs import теряется. Поэтому @@ -143,7 +143,7 @@ Не имеет значения, как вы относитесь к предыдущему параграфу—результат один и тот же. Просто поместите ваш - CVSROOT и скопируйте файлы FreeBSD поверх ваших + CVSROOT и скопируйте файлы FreeBSD поверх ваших локальных (неизмененных) копий: &prompt.user; cvs -d path-to-your-repository checkout CVSROOT @@ -295,7 +295,7 @@ исключаются из проверки. Вы должны добавить выражения в этот файл, если вы помещаете в хранилище файлы, которые не могут иметь заголовки с версиями. Для целей установки скриптов лучшим - решением может оказаться исключение CVSROOT/ + решением может оказаться исключение CVSROOT/ из проверки заголовков. @@ -500,7 +500,7 @@ @LOG_FILE_MAP - измените этот массив по своему усмотрению - каждое регулярное выражение сравнивается с каталогом коммита, и протокольное сообщение при коммите - сохраняется в подкаталоге commitlogs + сохраняется в подкаталоге commitlogs в указанном файле. @@ -533,7 +533,7 @@ ^CVSROOT/, и добавьте одну строку только с ^CVSROOT/. После установки обработчика (wrapper) вы можете добавить свои заголовки к файлам в каталоге - CVSROOT и восстановить эти строки, но теперь + CVSROOT и восстановить эти строки, но теперь они будут иметь смысл, только когда вы попытаетесь выполнить коммит позже. @@ -575,8 +575,8 @@ Последним действием, которое нужно сделать перед тем, как закончить работу, является проверка того, что протоколы коммитов могут сохраняться. По умолчанию они сохраняются в хранилище, в - подкаталоге commitlogs каталога - CVSROOT. Этот каталог должен быть создан, так + подкаталоге commitlogs каталога + CVSROOT. Этот каталог должен быть создан, так что выполните следующее: &prompt.user; mkdir commitlogs @@ -586,7 +586,7 @@ А теперь, после тщательной проверки, вы должны выполнить коммит ваших изменений. Убедитесь, что вы дали сами себе доступ к каталогу - CVSROOT в вашем avail до + CVSROOT в вашем avail до того, как его делать, так как в противном случае вы заблокируете сами себя. Так что убедитесь, что всё именно так, как вы и предполагали, а затем выполните следующее: @@ -616,7 +616,7 @@ Проект FreeBSD сам по себе использует несколько другую настройку, в которой также используются файлы из подкаталога freebsd каталога FreeBSD - CVSROOT. Проект использует их из-за большого + CVSROOT. Проект использует их из-за большого количества коммиттеров, которые все должны быть в одной и той же группе. Поэтому был написан простой обработчик, проверяющий, что люди имеют правильные права на выполнение коммита, а затем устанавливающий @@ -689,7 +689,7 @@ проверить правильность установки группы при выполнении коммита. Исходные тексты для этого размещены в cvswrap.c из вашего - CVSROOT. + CVSROOT. Откомпилируйте исходные тексты, которые вы редактировали для включения правильных путей: diff --git a/ru_RU.KOI8-R/articles/portbuild/article.sgml b/ru_RU.KOI8-R/articles/portbuild/article.sgml index a23a29f4e0..49ded79573 100644 --- a/ru_RU.KOI8-R/articles/portbuild/article.sgml +++ b/ru_RU.KOI8-R/articles/portbuild/article.sgml @@ -2,9 +2,9 @@ @@ -24,6 +24,8 @@ 2003 2004 + 2005 + 2006 Группа поддержки портов &os; @@ -52,7 +54,7 @@ каталога. ${arch} используется для указания на архитектуру платформы сборки (&i386;, alpha, &sparc64;, ia64 или amd64); ${branch} описывает ветвь построения - (4, 5, 4-exp). + (4, 4-exp, 5, 5-exp, 6, 7). @@ -69,7 +71,7 @@ несвязанных (disconnected) узлов кластера. Несвязанный узел не монтирует мастер-машину кластера по NFS, и может, таким образом, быть достаточно удален от центра. Мастер-машина копирует - нужные данные (иерархии портов, исходных текстов системы и документации, + нужные данные (иерархии портов, исходных текстов системы, архивы системы, скрипты и т.п.) при помощи rsync на этапе начальной конфигурации узлов. Затем, каталог portbuild монтируется как nullfs для сборок пакетов. @@ -155,21 +157,38 @@ + + dopackages.4 - собирает пакеты для версии 4.X + + + + + dopackages.4-exp - производит сборку ветви + для версии 4.X с экспериментальными изменениями (ветвь 4-exp) + + + dopackages.5 - собирает пакеты для версии 5.X - dopackages.4 - собирает пакеты для версии 4.X + dopackages.5-exp - производит сборку ветви + для версии 5.X с экспериментальными изменениями (ветвь 5-exp) - dopackages.4-exp - производит сборку ветви - для версии 4.X с экспериментальными изменениями (ветвь 4-exp) + dopackages.6 - собирает пакеты для версии 6.X + + + dopackages.7 - собирает пакеты для версии 7.X + + + Все они вызывают универсальный скрипт dopackages, @@ -282,7 +301,7 @@ -nodoccvs - Не обновлять (cvs update) дерево документации - (doc) в ходе препроцессинга. + (doc) в ходе препроцессинга. (устаревшая опция) @@ -359,12 +378,6 @@ - - Извлечение из CVS-репозитория текущего дерева - doc [*] - - - Извлечение из CVS-репозитория дерева src необходимой ветви [*] @@ -429,6 +442,10 @@ а журналы портов, собравшихся неудачно, в ${arch}/${branch}/errors. + + Ранее из репозитория извекалось также дерево документации; + в настоящий момент это считается ненужным. + @@ -595,7 +612,7 @@ исправлений общей инфраструктуры портов (bsd.port.mk), а также для тестирования крупных обновлений, затрагивающих существенную часть пакетов, проводится сборка с экспериментальными патчами. Текущей - экспериментальной веткой является 4-exp в архитектуре + экспериментальной веткой является 5-exp в архитектуре &i386;. В целом, экспериментальная сборка производится так же, как и обычная. @@ -608,7 +625,7 @@ Для создания контрольного экземпляра для сравнения следует сначала произвести сборку той ветви архитектуры &i386;, на которой основана экспериментальная ветвь (в настоящее время это ветвь - 4). Перед экспериментальной сборкой выгрузите + 5). Перед экспериментальной сборкой выгрузите деревья src и ports на момент произведения контрольной сборки. В этом случае вы можете быть уверены, что сравниваете яблоки с яблоками. @@ -619,20 +636,20 @@ По завершении сборки сравните результаты контрольной и экспериментальной сборок примерно такой командой (предполагается, что - контрольной является ветка 4, а - экспериментальной — 4-exp): + контрольной является ветка 5, а + экспериментальной — 5-exp): - &prompt.user; cd /var/portbuild/i386/4-exp/errors -&prompt.user; find . -name \*.log\* | sort > /tmp/4-exp-errs -&prompt.user; cd /var/portbuild/i386/4/errors -&prompt.user; find . -name \*.log\* | sort > /tmp/4-errs + &prompt.user; cd /var/portbuild/i386/5-exp/errors +&prompt.user; find . -name \*.log\* | sort > /tmp/5-exp-errs +&prompt.user; cd /var/portbuild/i386/5/errors +&prompt.user; find . -name \*.log\* | sort > /tmp/5-errs Если с момента завершения одной из сборок прошло достаточно много времени, журналы сборки могут быть автоматически архивированы bzip2. В этом случае используйте sort | sed 's,\.bz2,,g'. - &prompt.user; comm -3 /tmp/4-errs /tmp/4-exp-errs | less + &prompt.user; comm -3 /tmp/5-errs /tmp/5-exp-errs | less Результатом работы последней команды будет отчет, состоящий из двух столбцов. В первой колонке будут перечислены порты, сборка которых не @@ -683,21 +700,21 @@ содержимое обоих столбцов. Чтобы отличить ситуации [1] и [2], можно пересобрать соответствующие пакеты в контрольной ветке: - &prompt.user; cd /var/portbuild/i386/4/ports + &prompt.user; cd /var/portbuild/i386/5/ports Не забудьте обновить дерево портов до той же даты, что и дерево экспериментальной сборки. Для подготовки контрольной ветви используйте команду: - &prompt.user; /var/portbuild/scripts/dopackages.4 -noportscvs -nobuild -nocvs -nofinish + &prompt.user; /var/portbuild/scripts/dopackages.5 -noportscvs -nobuild -nocvs -nofinish Сборка должна производиться из каталога packages/All. Изначально этот каталог должен быть пуст, за исключением символьной ссылки Makefile. Если этой ссылки нет, создайте ее: - &prompt.user; cd /var/portbuild/i386/4/packages/All + &prompt.user; cd /var/portbuild/i386/5/packages/All &prompt.user; ln -sf ../../Makefile . &prompt.user; make -k -j<#> <список пакетов для сборки> -- cgit v1.2.3