CVS хранилището на проекта съдържа работни версии на вече преведени глави, както и оригиналната документация на английски език, доставяната с FreeBSD 5.2.1 RELEASE. Тя е във вид готов за вграждане сред останалите преводи в следващо FreeBSD издание.
За да изтеглите документацията от хранилището, използвайте анонимния достъп за четене. Името на потребителя е fdpread, а парола няма (натиснете просто Enter). Ето примерните команди, които ще направят локално копие на CVS хранилището на проекта в работна директория ~/FDP:
% cd; mkdir FDP; cd FDP % export CVSROOT=fdpread@bg-freebsd.org:/cvs CVS_RSH=ssh % cvs co doc
Ако искате просто да обновите вашето копие използвайте тези команди:
% cd; cd FDP && cvs update -dAP
Забележка: Когато бъдете запитани за паролa, натиснете Enter и изчакайте докато файловете бъдат изтеглени. Размерът на модула е около 8M.
На адрес http://cvsweb.bg-freebsd.org можете да разгледате CVS хранилището през уеб интерфейс.
Основната полза от CVS е възможността за проследяване на развитието на един документ. Това става като се използват уникални номера за всяка ревизия на документа. С помощта на тези номера можете да видите промените настъпили между ревизиите.
% cd FDP/fdpweb % cvs status progress.html
Password: =================================================================== File: progress.html Status: Needs Merge Working revision: 1.8 Repository revision: 1.22 /cvs/fdpweb/progress.html,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none)
Вече знаете, че версията на локалния документ е 1.8, докато последната версия на документа в хранилището е с версия 1.22. Също така документите трябва да бъдат сляти (merged) на ръка, за да се избегнат конфликти.
Ако искате да видите разликите между две ревизии, използвайте следната команда:
% cvs diff -r1.8 -r1.22
Можете да използвате и локален файл вместо номер на ревизия:
% cvs diff -r1.21 progress.html
Забележка: Тъй като уеб страниците на проекта са с UTF-8 кодировка, а преводът на документацията с CP1251 кодировка, при използване на командата cvs diff ще трябва да имате подходящо настроен терминал, за да видите текста. Ако не желаете да променяте настройките на терминала, можете да използвате пренасочване на стандартния вход/изход към файл, който по-късно да разгледате с текстов редактор:
% cvs diff -r1.21 progress.html 1 > progress.diff 2>&1
Ако имате права за писане в хранилището, отделете специално внимание на това, с коя версия на документа работите. Поддържайте локалните копия в синхрон с хранилището и нанасяйте промени в най-актуалната версия на документа. Ако въпреки това сте направили промени по документ, който вече има по-нова версия в хранилището, отделете времето и слейте двата документа на ръка, за да не се губи контекста. Избягвайте обновяването на много документи в хранилището наведнъж и добавяйте смислен коментар, описващ промените в новата версия. Записването на промените в хранилището е лесно:
% cvs commit -m "fix foo; add bar" progress.html
Password: Checking in progress.html; /cvs/fdpweb/progress.html,v <-- progress.html new revision: 1.22; previous revision: 1.21 done
Ако нещо не мине както сте запланували или имате съмнения, че нещо не е в ред, се свържете с team преди се да опитате да го поправите.