diff options
Diffstat (limited to 'documentation/content/ru/articles/committers-guide/_index.adoc')
| -rw-r--r-- | documentation/content/ru/articles/committers-guide/_index.adoc | 52 |
1 files changed, 26 insertions, 26 deletions
diff --git a/documentation/content/ru/articles/committers-guide/_index.adoc b/documentation/content/ru/articles/committers-guide/_index.adoc index 482bb63234..18dd58d8fe 100644 --- a/documentation/content/ru/articles/committers-guide/_index.adoc +++ b/documentation/content/ru/articles/committers-guide/_index.adoc @@ -184,7 +184,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs . Извлечение нужного модуля из репозитория: команда `co` или `checkout`. + -[source,bash] +[source,shell] .... % cvs checkout shazam .... @@ -210,7 +210,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs ** Извлечь модуль [.filename]#miscfs#, расположенный в каталоге репозитория [.filename]#src/sys/miscfs#: + -[source,bash] +[source,shell] .... % cvs co miscfs .... @@ -218,7 +218,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs После выполнения вы получите каталог [.filename]#miscfs#, содержащий подкаталоги [.filename]#CVS#, [.filename]#deadfs#, [.filename]#devfs# и т.д. Один из них ([.filename]#linprocfs#) будет пустым. ** Извлечь те же файлы, но с полным путем: + -[source,bash] +[source,shell] .... % cvs co src/sys/miscfs .... @@ -226,7 +226,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Теперь у вас есть каталог [.filename]#src#, содержащий подкаталоги [.filename]#CVS# и [.filename]#sys#. Каталог [.filename]#src/sys# содержит подкаталоги [.filename]#CVS# и [.filename]#miscfs# и т.д. ** Извлечь те же файлы, удалив при этом пустые подкаталоги: + -[source,bash] +[source,shell] .... % cvs co -P miscfs .... @@ -234,7 +234,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Вы получите каталог [.filename]#miscfs# с подкаталогами [.filename]#CVS#, [.filename]#deadfs#, [.filename]#devfs#... однако без подкаталога [.filename]#linprocfs#, поскольку он не содержит файлов. ** Извлечь каталог [.filename]#miscfs# без подкаталогов: + -[source,bash] +[source,shell] .... % cvs co -l miscfs .... @@ -242,7 +242,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Теперь в каталоге [.filename]#miscfs# будет только один подкаталог [.filename]#CVS#. ** Извлечь модуль [.filename]#miscfs# из ветви 6.X: + -[source,bash] +[source,shell] .... % cvs co -rRELENG_6 miscfs .... @@ -250,7 +250,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Теперь вы можете изменить исходные тексты и произвести коммит в эту ветвь. ** Извлечь модуль [.filename]#miscfs# по состоянию на момент выхода 6.0-RELEASE: + -[source,bash] +[source,shell] .... % cvs co -rRELENG_6_0_0_RELEASE miscfs .... @@ -258,7 +258,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs В этом случае вы не сможете внести изменения в репозиторий, поскольку `RELENG_6_0_0_RELEASE` описывает момент времени, а не ветвь разработки. ** Извлечь модуль [.filename]#miscfs# по состоянию на 15 января 2000 г: + -[source,bash] +[source,shell] .... % cvs co -D'01/15/2000' miscfs .... @@ -266,7 +266,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Как и в предыдущем случае, изменения не могут быть записаны. ** Извлечь модуль [.filename]#miscfs#, каким он был неделю назад: + -[source,bash] +[source,shell] .... % cvs co -D'last week' miscfs .... @@ -278,7 +278,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Аргументы опций `-D` and `-r` сохраняются (являются "клейкими", sticky), например, при последующем использовании команды `cvs update`. . Проверка состояния извлеченных файлов: команда `status`. + -[source,bash] +[source,shell] .... % cvs status shazam .... @@ -308,7 +308,7 @@ alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs Кроме того, будут показаны локальная версия и дата модификации, версия и дата последней из доступных (если вы применяли "клейкие" дату, тег или ветвь, последняя доступная версия может отличаться от вашей), а также клейкие теги, временные метки и опции. . Обновление извлеченного модуля: команда `update`. + -[source,bash] +[source,shell] .... % cvs update shazam .... @@ -372,14 +372,14 @@ CVS выводит букву `M` перед именем всех локаль ** Извлеките текущую версию модуля [.filename]#shazam# для ветви FreeBSD-STABLE: + -[source,bash] +[source,shell] .... % cvs co -rRELENG_6 shazam .... ** Приложите изменения между версиями 1.14 и 1.15: + -[source,bash] +[source,shell] .... % cvs update -j1.14 -j1.15 shazam/shazam.c .... @@ -387,7 +387,7 @@ CVS выводит букву `M` перед именем всех локаль Почти наверняка вы получите конфликт в строках, содержащих идентификатор файла (`$Id: article.xml,v 1.19 2007-05-09 06:08:50 bvs Exp $` или, в случае FreeBSD, `$FreeBSD: head/ru_RU.KOI8-R/articles/committers-guide/article.xml 45050 2014-06-13 14:53:24Z taras $`). Вам потребуется отредактировать файл для устранения конфликта (в данном случае достаточно убрать строки-разделители и вторую строку `$Id: article.xml,v 1.19 2007-05-09 06:08:50 bvs Exp $`, оставив лишь строку с `$Id: article.xml,v 1.19 2007-05-09 06:08:50 bvs Exp $` для FreeBSD-STABLE). . Просмотр изменение между локальной версией и версией из репозитория: команда `diff`. + -[source,bash] +[source,shell] .... % cvs diff shazam .... @@ -411,7 +411,7 @@ CVS выводит букву `M` перед именем всех локаль Вы можете сравнивать текущее состояние с версией, отличающейся от той, с которой вы извлекали файл, указав опцию `-r` или `-D` подобно командам `checkout` и `update`, или даже получить список изменений между любыми двумя версиями (вне зависимости от того, что лежит в вашей локальной копии), указав _две_ версии при помощи опций `-r` или `-D`. . Просмотр журнала изменений: команда `log`. + -[source,bash] +[source,shell] .... % cvs log shazam .... @@ -422,7 +422,7 @@ CVS выводит букву `M` перед именем всех локаль + Команда `log` используется для просмотра истории одного или нескольких файлов в том виде, как она сохранена в репозитории CVS. Используя опцию `-r__rev__`, вы можете посмотреть журнальное сообщение к одной определенной версии: + -[source,bash] +[source,shell] .... % cvs log -r1.2 shazam .... @@ -430,7 +430,7 @@ CVS выводит букву `M` перед именем всех локаль Эта команда покажет журнальное сообщение для версии `1.2` файла [.filename]#shazam# (или для версий `1.2` каждого из файлов в каталоге [.filename]#shazam#). . Кто что делал: команда `annotate`. Эта команда показывает перед каждой строкой указанного файла (файлов) имя пользователя, вносившего последние изменения в эту строку. + -[source,bash] +[source,shell] .... % cvs annotate shazam .... @@ -501,14 +501,14 @@ package:textproc/cdiff[] + Просто используйте его вместо man:more[1] или man:less[1]: + -[source,bash] +[source,shell] .... % cvs diff -Nu shazam | cdiff .... + Помимо этого, некоторые текстовые редакторы, такие как man:vim[1] (package:editors/vim[]) поддерживают цветовую синтаксическую разметку многих типов файлов, в том числе файлов изменений и журналов CVS/RCS. + -[source,bash] +[source,shell] .... % echo "syn on" >> ~/.vimrc % cvs diff -Nu shazam | vim - @@ -518,7 +518,7 @@ package:textproc/cdiff[] . CVS - старая, загадочная и порой слабо предсказуемая в своем поведении программа. Ни один человек не способен удержать в голове все тонкости ее работы, так что не бойтесь спрашивать совета у Искусственного Интеллекта (а именно `{cvsadm}`). . Не оставляйте компьютер в процессе работы команды `cvs commit` (в редакторе при написании журнального сообщения) слишком надолго (более чем на 2-3 минуты). Эта команда блокирует каталог репозитория, в котором она запущена, и не позволяет другим разработчикам изменять его содержимое. Если вам нужно написать длинное журнальное сообщение, подготовьте его заранее и вставьте в редакторе во время выполнения команды `cvs commit`, либо запишите его в файл и используйте опцию CVS `-F`: + -[source,bash] +[source,shell] .... % vi logmsg % cvs ci -F logmsg shazam @@ -541,7 +541,7 @@ Host pcvs.FreeBSD.org + Затем откройте постоянное соединение с машиной repoman: + -[source,bash] +[source,shell] .... % ssh -fNM ncvs.FreeBSD.org .... @@ -674,7 +674,7 @@ gnats/[a-ce-z]* . Установите порт GNATS из [.filename]#ports/databases/gnats#. После установки вы обнаружите различные служебные каталоги в дереве [.filename]#$PREFIX/shared/gnats#. . Создайте символьные ссылки на синхронизированные каталоги GNATS в служебный каталог GNATS: + -[source,bash] +[source,shell] .... # cd /usr/local/shared/gnats/gnats-db # ln -s /usr/gnats/docs @@ -695,7 +695,7 @@ docs:Documentation Bug:freebsd-doc: .... . Запустите [.filename]#$PREFIX/libexec/gnats/gen-index# для создания индекса. Вывод этой команды должен быть перенаправлен в файл [.filename]#$PREFIX/shared/gnats/gnats-db/gnats-adm/index#. Эту операцию можно выполнять периодически при помощи man:cron[8] или запускать man:cvsup[1] из скрипта, который затем сгенерирует новый индекс: + -[source,bash] +[source,shell] .... # /usr/local/libexec/gnats/gen-index \ > /usr/local/shared/gnats/gnats-db/gnats-adm/index @@ -703,7 +703,7 @@ docs:Documentation Bug:freebsd-doc: . Протестируйте созданную конфигурацию запросом к базе данных GNATS. Следующая команда выведет список открытых сообщений об ошибках в категории `docs`: + -[source,bash] +[source,shell] .... # query-pr -c docs -s open .... @@ -935,7 +935,7 @@ FreeBSD является хорошо портируемой операцион Проверьте его. Желательно убедиться в том, что порт и соответствующий пакет корректно собираются. Рекомендуемая последовательность действий такова: -[source,bash] +[source,shell] .... # make install # make package @@ -983,7 +983,7 @@ FreeBSD является хорошо портируемой операцион [example] ==== -[source,bash] +[source,shell] .... % cd sys/alpha/include % cvs update -rRELENG_6 |