CVS

LDP находиться в процессе предоставления CVS доступа авторам. На это есть несколько причин:

  1. В CVS всегда будет храниться копия ваших документов. В случае если вы передадите ответственность за свой документ другим авторам, им нужно будет просто получить документ из CVS и продолжить его написание. В случае если вам понадобиться одна из приведущих версий документа, вы всегда сможете получить её.

  2. Также CVS будет крайне полезен в случае, если над документом работает несколько человек. Вы сможете узнать какие изменения были сделаны другими авторами и объединить их с вашими.

  3. CVS хранит историю изменений. Эту историю (и дату) можно автоматически разместить внутри документа, когда вы используете специальные тэги,обрабатываемые до визуализации документа SGML процессором.

  4. C помощью CVS и специальной программы веб сайт LDP может быть автоматически обновлен, когда выкладывается новая документация. Это еще не сделано, но является одной из целей.

Если вы никогда не работали с CVS, то вам возможно поможет информация размещенная по следующим адресам.

Получение CVS аккаунта

Прежде всего вам необходимо получить аккаунт в CVS репозитарии LDP. Это корневая директория используемая CVS, с различными проектами (HOWTO,mini-HOWTO и т.д.) размещенными в поддиректориях.

Вам будет нужно создать зашифрованный пароль и идентификатор пользователя для аккаунта. Зашифрованный пароль можно послать в CVS группу, при этом им не нужно будет знать ваш пароль. Вы можете сделать это с помощью следующих комманд, из bash (или sh):

$ echo это_ваш_пароль | perl -e "print crypt(<>, join '',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\"" 
  

Пошлите вывод этой команды вместе с идентификатором пользователя (выберите сами) по адресу cvsadmin@cvslist.linuxdoc.org. Будет создан ваш уникальный CVSROOT и вам будет выслано уведомление по почте. Получив подтверждение, войдите в ваш CVSROOT и убедитесь что все работает правильно:

$ export CVSROOT=:pserver:your_userid@cvs.linuxdoc.org:/cvsroot
$ cvs -d $CVSROOT login 
  

(Замените CVSROOT на то , что было выслано вам по почте).

Вас спросят о вашем пароле, и затем вы получите доступ к CVS репозитарию с разрешением на чтение/запись. При первом использовании cvs login и получении доступа к системе, ваш пароль будет сохранен в .cvsroot и вам не придется больше использовать cvs login. Просто установите CVSROOT и продолжайте работу. Вы можете получить весь linuxdoc репозитарий с помощью команды:

$ cvs get LDP
  

Или вы можете получить SGML код вашего собственного документа с помощью следующих команд:

$ cvs get howto/ВАШЕ-HOWTO.sgml
$ cvs get minihowto/ВАШ-ДОКУМЕНТ.sgml
  

Также существует The Commit List, лист рассылки в котором сообщается обо всех изменениях в репозитарии. Будьте осторожны, этот список обладает большим трафиком. Вы можете подписаться послав e-mail по адресу: commits-subscribe@cvslist.linuxdoc.org. Отменить подписку можно послав пустое письмо по адресу commits-unsubscribe@cvslist.linuxdoc.org.

Другие замечания о CVS репозитарии

Обновление файлов и CVS

CVS имеет специальный тэг, который вы можете использовать для автоматической вставки даты и версии непосредственно в документ. Он выглядит так $Id$. Включив этот тэг в ваш документ вы получите обновление даты, при каждом изменении в документе.

Когда вы будете готовы загрузить сделанные вами документы на CVS сервер, используйте команду cvs ci -m "Комментарий" ВАШЕ-HOWTO.sgml. -m "Комментарий" не обязателен, но если вы не включите его, будет запущен ваш любимый текстовый редактор (обычно vi, или редактор на который указывает ваша переменная окружения EDITOR), чтобы вы могли ввести ваш комментарий.

Вы можете принять участие в обсуждении CVS в листе ldp-discuss. В настоящий момент, все документы по прежнему нужно посылать по адресу ldp-submit.