diff options
Diffstat (limited to 'ru_RU.KOI8-R/articles/cvs-freebsd/article.xml')
-rw-r--r-- | ru_RU.KOI8-R/articles/cvs-freebsd/article.xml | 85 |
1 files changed, 38 insertions, 47 deletions
diff --git a/ru_RU.KOI8-R/articles/cvs-freebsd/article.xml b/ru_RU.KOI8-R/articles/cvs-freebsd/article.xml index 12098a40de..dc7632515e 100644 --- a/ru_RU.KOI8-R/articles/cvs-freebsd/article.xml +++ b/ru_RU.KOI8-R/articles/cvs-freebsd/article.xml @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="koi8-r"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> - +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> <!-- The FreeBSD Russian Documentation Project @@ -9,18 +8,13 @@ Original revision: r42226 --> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="ru"> + <info><title>Настройка хранилища CVS - подход FreeBSD</title> + -<article lang="ru"> - <articleinfo> - <title>Настройка хранилища CVS - подход FreeBSD</title> - - <author> - <firstname>Stijn</firstname> - <surname>Hoop</surname> - <affiliation> + <author><personname><firstname>Stijn</firstname><surname>Hoop</surname></personname><affiliation> <address><email>stijn@win.tue.nl</email></address> - </affiliation> - </author> + </affiliation></author> <copyright> <year>2001</year> @@ -33,7 +27,7 @@ <releaseinfo>$FreeBSD$</releaseinfo> - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.general; </legalnotice> @@ -46,9 +40,9 @@ дереву исходных текстов и посылку содержательных сообщений электронной почты при каждом коммите.</para> </abstract> - </articleinfo> + </info> - <sect1 id="introduction"> + <sect1 xml:id="introduction"> <title>Введение</title> <para>Большинство программных проектов с открытым кодом используют @@ -72,7 +66,7 @@ основными методами работы с <application>CVS</application>.</para> </sect1> - <sect1 id="first-setup"> + <sect1 xml:id="first-setup"> <title>Первоначальная настройка</title> <warning> @@ -89,11 +83,11 @@ инициализировать, для чего выдать <application>CVS</application> такую команду:</para> - <screen>&prompt.user; <userinput>cvs -d <replaceable>path-to-repository</replaceable> init</userinput></screen> + <screen>&prompt.user; <userinput>cvs -d path-to-repository init</userinput></screen> <para>Результатом ее выполнения будет созданный <application>CVS</application> служебный - каталог <filename class="directory">CVSROOT</filename>, в котором выполняется вся + каталог <filename>CVSROOT</filename>, в котором выполняется вся настройка.</para> </sect2> @@ -105,12 +99,12 @@ могли писать в хранилище. Для этой группы мы примем стандартное для FreeBSD название <literal>ncvs</literal>.</para> - <screen>&prompt.root; <userinput>pw groupadd <replaceable>ncvs</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>pw groupadd ncvs</userinput></screen> <para>Затем вы должны при помощи команды &man.chown.8; сменить владельца и группу для только что добавленного каталога:</para> - <screen>&prompt.root; <userinput>chown -R :<replaceable>ncvs</replaceable> <replaceable>path-to-your-repository</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>chown -R :ncvs path-to-your-repository</userinput></screen> <para>Это нужно для того, чтобы никто не мог записывать в хранилище, не являясь членом группы.</para> @@ -119,25 +113,24 @@ <sect2> <title>Получение исходных текстов</title> - <para>Теперь вам нужно получить каталог <filename class="directory">CVSROOT</filename> из + <para>Теперь вам нужно получить каталог <filename>CVSROOT</filename> из хранилища FreeBSD. Проще всего это делается извлечением с анонимного - зеркала CVS FreeBSD. Обратитесь к <ulink - url="&url.books.handbook;/anoncvs.html">соответствующей главе - Руководства</ulink> для получения дополнительной информации. Мы будем + зеркала CVS FreeBSD. Обратитесь к <link xlink:href="&url.books.handbook;/anoncvs.html">соответствующей главе + Руководства</link> для получения дополнительной информации. Мы будем полагать, что исходные тексты хранятся в подкаталоге - <filename class="directory">CVSROOT-freebsd</filename> текущего каталога.</para> + <filename>CVSROOT-freebsd</filename> текущего каталога.</para> </sect2> <sect2> <title>Копирование скриптов FreeBSD</title> <para>Теперь мы скопируем исходные тексты FreeBSD из - <filename class="directory">CVSROOT</filename> в наше хранилище. Если вы знакомы с + <filename>CVSROOT</filename> в наше хранилище. Если вы знакомы с <application>CVS</application>, то для вас может иметь смысл попытаться импортировать скрипты, чтобы облегчить синхронизацию с последующими версиями. Однако при этом оказывается, что <application>CVS</application> имеет в этой области недостаток: при - импортировании исходных текстов в каталог <filename class="directory">CVSROOT</filename> + импортировании исходных текстов в каталог <filename>CVSROOT</filename> она не будет обновлять необходимые административные файлы. Чтобы в этом убедиться, вам нужно проверить каждый файл после импортирования, при этом смысл <literal>cvs import</literal> теряется. Поэтому @@ -145,10 +138,10 @@ <para>Не имеет значения, как вы относитесь к предыдущему параграфу—результат один и тот же. Просто поместите ваш - <filename class="directory">CVSROOT</filename> и скопируйте файлы FreeBSD поверх ваших + <filename>CVSROOT</filename> и скопируйте файлы FreeBSD поверх ваших локальных (неизмененных) копий:</para> - <screen>&prompt.user; <userinput>cvs -d <replaceable>path-to-your-repository</replaceable> checkout CVSROOT</userinput> + <screen>&prompt.user; <userinput>cvs -d path-to-your-repository checkout CVSROOT</userinput> &prompt.user; <userinput>cd CVSROOT</userinput> &prompt.user; <userinput>cp ../CVSROOT-freebsd/* .</userinput> &prompt.user; <userinput>cvs add *</userinput></screen> @@ -168,8 +161,7 @@ <itemizedlist> <listitem> <para><filename>access</filename> - по умолчанию при стандартной - настройке этот файл не используется. Он применяется в <link - linkend="freebsdspecific">специфичных для проекта FreeBSD + настройке этот файл не используется. Он применяется в <link linkend="freebsdspecific">специфичных для проекта FreeBSD настройках</link>, где он управляет доступом к хранилищу. Вы можете удалить этот файл, если вы не собираетесь использовать такую настройку.</para> @@ -297,7 +289,7 @@ исключаются из проверки. Вы должны добавить выражения в этот файл, если вы помещаете в хранилище файлы, которые не могут иметь заголовки с версиями. Для целей установки скриптов лучшим - решением может оказаться исключение <filename class="directory">CVSROOT/</filename> + решением может оказаться исключение <filename>CVSROOT/</filename> из проверки заголовков.</para> </listitem> @@ -441,8 +433,7 @@ <procedure> <step> - <para>Если вы не хотите использовать <link - linkend="freebsdspecific">специфичные для FreeBSD + <para>Если вы не хотите использовать <link linkend="freebsdspecific">специфичные для FreeBSD возможности</link> скриптов, то вы можете без последствий удалить файл <filename>access</filename>:</para> @@ -502,7 +493,7 @@ <para><literal>@LOG_FILE_MAP</literal> - измените этот массив по своему усмотрению - каждое регулярное выражение сравнивается с каталогом коммита, и протокольное сообщение при коммите - сохраняется в подкаталоге <filename class="directory">commitlogs</filename> + сохраняется в подкаталоге <filename>commitlogs</filename> в указанном файле.</para> </listitem> @@ -535,7 +526,7 @@ <literal>^CVSROOT/</literal>, и добавьте одну строку только с <literal>^CVSROOT/</literal>. После установки обработчика (wrapper) вы можете добавить свои заголовки к файлам в каталоге - <filename class="directory">CVSROOT</filename> и восстановить эти строки, но теперь + <filename>CVSROOT</filename> и восстановить эти строки, но теперь они будут иметь смысл, только когда вы попытаетесь выполнить коммит позже.</para> </step> @@ -578,7 +569,7 @@ закончить работу, является проверка того, что протоколы коммитов могут сохраняться. По умолчанию они сохраняются в хранилище, в подкаталоге <filename>commitlogs</filename> каталога - <filename class="directory">CVSROOT</filename>. Этот каталог должен быть создан, так + <filename>CVSROOT</filename>. Этот каталог должен быть создан, так что выполните следующее:</para> <screen>&prompt.user; <userinput>mkdir commitlogs</userinput> @@ -588,12 +579,12 @@ <para>А теперь, после тщательной проверки, вы должны выполнить коммит ваших изменений. Убедитесь, что вы дали сами себе доступ к каталогу - <filename class="directory">CVSROOT</filename> в вашем <filename>avail</filename> до + <filename>CVSROOT</filename> в вашем <filename>avail</filename> до того, как его делать, так как в противном случае вы заблокируете сами себя. Так что убедитесь, что всё именно так, как вы и предполагали, а затем выполните следующее:</para> - <screen>&prompt.user; <userinput>cvs commit -m '<replaceable>- Initial FreeBSD scripts commit</replaceable>'</userinput></screen> + <screen>&prompt.user; <userinput>cvs commit -m '- Initial FreeBSD scripts commit'</userinput></screen> </sect2> <sect2> @@ -603,7 +594,7 @@ <filename>avail</filename>, чтобы убедиться, что всё работает так, как ожидалось.</para> - <screen>&prompt.user; <userinput>cvs commit -f -m '<replaceable>Forced commit to test the new CVSROOT scripts</replaceable>' avail</userinput></screen> + <screen>&prompt.user; <userinput>cvs commit -f -m 'Forced commit to test the new CVSROOT scripts' avail</userinput></screen> <para>Если всё работает, поздравляем! Теперь у вас имеется работающая настройка скриптов FreeBSD для вашего хранилища. Если @@ -612,13 +603,13 @@ </sect2> </sect1> - <sect1 id="freebsdspecific"> + <sect1 xml:id="freebsdspecific"> <title>Специфичная для FreeBSD настройка</title> <para>Проект FreeBSD сам по себе использует несколько другую настройку, в которой также используются файлы из подкаталога - <filename class="directory">freebsd</filename> каталога FreeBSD - <filename class="directory">CVSROOT</filename>. Проект использует их из-за большого + <filename>freebsd</filename> каталога FreeBSD + <filename>CVSROOT</filename>. Проект использует их из-за большого количества коммиттеров, которые все должны быть в одной и той же группе. Поэтому был написан простой обработчик, проверяющий, что люди имеют правильные права на выполнение коммита, а затем устанавливающий @@ -691,7 +682,7 @@ проверить правильность установки группы при выполнении коммита. Исходные тексты для этого размещены в <filename>cvswrap.c</filename> из вашего - <filename class="directory">CVSROOT</filename>.</para> + <filename>CVSROOT</filename>.</para> <para>Откомпилируйте исходные тексты, которые вы редактировали для включения правильных путей:</para> @@ -703,7 +694,7 @@ <screen>&prompt.root; <userinput>mv /usr/bin/cvs /usr/bin/ncvs</userinput> &prompt.root; <userinput>mv cvs /usr/bin/cvs</userinput> -&prompt.root; <userinput>chown root:<replaceable>ncvs</replaceable> /usr/bin/cvs /usr/bin/ncvs</userinput> +&prompt.root; <userinput>chown root:ncvs /usr/bin/cvs /usr/bin/ncvs</userinput> &prompt.root; <userinput>chmod o-rx /usr/bin/ncvs</userinput> &prompt.root; <userinput>chmod u-w,g+s /usr/bin/cvs</userinput></screen> @@ -727,7 +718,7 @@ протестировать его, выполнив принудительный коммит в файл <filename>access</filename>:</para> - <screen>&prompt.user; <userinput>cvs commit -f -m '<replaceable>Forced commit to test the new CVSROOT scripts</replaceable>' access</userinput></screen> + <screen>&prompt.user; <userinput>cvs commit -f -m 'Forced commit to test the new CVSROOT scripts' access</userinput></screen> <para>И снова, если это не сработает, проверьте, правильно ли были выполнены все вышеперечисленные шаги.</para> |