데비안 문서 프로젝트(Debian Documentation Project)는 웹 페이지와 많은 매뉴얼 텍스트를 cvs.debian.org에 있는 데비안 CVS 서버에 저장합니다.
누구나 CVS 서버에서 소스를 내려받을 수 있습니다. 데비안 문서 프로젝트에 참여하는 사람들만 CVS 서버의 파일을 업데이트할 수 있습니다.
viewCVS 인터페이스를 사용해 웹을 통해 파일에 개별적으로 접근할 수 있고 http://cvs.debian.org/?cvsroot=debian-doc에서 변경 사항을 확인할 수 있습니다.
모든 매뉴얼을 내려받으려면 CVS 서버에 직접 접근하는 것이 때론 더 좋은 방법입니다. cvs 패키지를 설치해야 합니다.
다음 명령을 실행합니다.
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login
패스워드를 물어보면 엔터만 누르면 됩니다.
그리고 나서 일반적인 CVS 명령(CVS info 페이지 참고)으로 파일을 꺼내올(check out) 수 있습니다. 하지만 파일을 수정하거나 커밋할 수는 없습니다.
파일을 처음 내려받는다면 파일을 보관할 디렉터리를 만들고 그 디렉터리로 이동합니다. CVS와 ddp가 이 디렉터리 안에 만들어질 것입니다.
다음 명령으로 모든 파일을 내려받습니다.
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
This will recursively create the directories and populate them.
지역 복사본(local copy)을 업데이트하려면 ddp/manuals.sgml 디렉터리에서 다음 명령을 실행합니다.
cvs -z3 update -d -P
CVS 원격 세션을 끝내려면 다음 명령을 실행합니다.
cvs logout
이 방법으로 CVS 서버에 접근하기 전에 먼저 쓰기 권한을 받아야만 합니다. 갱신 권한 요청에 대해 먼저 읽어보기 바랍니다.
다음 명령으로 접속합니다.
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc login
문서 프로젝트 진행자(coordinator)와 상의해 받은 암호를 입력합니다. 위의 명령에서 userid를 CVS 패스워드 서버에 등록된 자신의 사용자 이름으로 바꿉니다. 이것은 cvs.debian.org의 로그인 이름과 같은 필요는 없습니다.
그리고 나서 일반적인 CVS 명령(CVS info 페이지 참고)으로 파일을 꺼내오고(check out) 커밋할 수 있습니다.
파일을 처음 내려받는다면 파일을 보관할 디렉터리를 만들고 그 디렉터리로 이동합니다. CVS와 ddp가 이 디렉터리 안에 만들어질 것입니다.
다음 명령으로 모든 파일을 내려받습니다.
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
This will recursively create the directories and populate them.
지역 복사본을 갱신하려면 ddp/manuals.sgml 디렉터리에서 다음 명령을 실행합니다.
cvs -z3 update -d -P
CVS 원격 세션을 끝내려면 다음 명령을 실행합니다.
cvs logout
이 방법은 등록된 데비안 개발자만 사용할 수 있고 위의 pserver보다 더 추천하는 방법입니다. 최근에 데비안 개발자로 등록됐다면 문서 프로젝트 진행자에게 pserver 계정을 삭제(nuke)해 달라고 알리기 바랍니다.
ssh로 접속하려면 먼저 CVS 서버에 알려야 합니다.
export CVS_RSH=ssh
파일을 보관할 디렉터리를 만들고 그 디렉터리로 이동합니다. 그리고 다음 명령을 실행합니다.
cvs -d :ext:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout module
위의 명령에서 userid는 CVS 서버에 등록된 자신의 사용자 이름으로 바꿉니다. 이것은 모든 데비안 장비에 등록된 자신의 로그인 이름과 같습니다. module은 꺼내려는 모듈 이름으로 바꿉니다. 보통 ddp/manuals.sgml입니다. 그리고 나서 패스워드를 입력하는 프롬프트가 나옵니다. 자신의 장비와 혼동하면 안 됩니다.
CVS와 ddp, 두 디렉터리가 이 디렉터리 안에 만들어질 것입니다. CVS will recursively create any modules(i.e. directories) you requested and populate them with files.
그리고 나서 일반적인 CVS 명령(CVS info 페이지 참고)으로 파일을 꺼내고 커밋할 수 있습니다.
지역 복사본을 갱신하려면 ddp/manuals.sgml 디렉터리에서 다음 명령을 실행합니다.
cvs -z3 update -d -P
업데이트 권한은 매뉴얼 작성에 참여하고 싶은 사람에게 주어집니다. 일반적으로 유용한 패치를 먼저 몇 건 제출하기를 요청합니다.
업데이트 권한을 얻으려면 데비안 문서 메일링 리스트에 요청을 보냅니다. 접근 권한이 필요한 이유를 설명하세요. 접근 권한을 얻기 전에 문서 코디네이터나 데비안 문서 팀 관련 멤버에게 승인을 얻어야 합니다. 승인을 받으면 사인한 요청을 debian-admin으로 보내야 합니다.
데비안 개발자는 요청이 승인되면 cvs.debian.org의 cvs_doc 그룹에 포함되고 CVS를 업데이트할 수 있습니다.
데비안 개발자가 아닐 경우 요청이 승인되면 로그인 이름과 열쇠글을 제공해야 합니다. 로그인이름은 기존 데비안 계정과 달라야 합니다(db.debian.org를 확인해 보세요). cvs가 열쇠글을 암호화하지 않고 보내기는 하지만 열쇠글을 메일로 보낼 때는 암호화해서 보내야 합니다.
makepasswd로 열쇠글을 생성하려면 패키지를 설치하고 다음과 같이 실행하세요.
$ echo "SECRET" |makepasswd --clearfrom=- --crypt
열쇠글을 암호화하는 또 다른 간단한 방법은 다음과 같은 펄 구문 한 줄을 사용하는 것입니다. 펄은 데비안 GNU/리눅스에 이미 설치되어 있습니다.
$ perl -e "printf \"%s\n\", crypt ("SECRET", join ('', ('.', '/', 0..9, 'A'.. 'Z', 'a'..'z')[rand (64), rand (64)]))"
결과를 쓰고 싶은 계정 이름과 함께 Martin Schulze에게 보내세요. Martin Schulze의 GnuPG 열쇠로 전체 메일을 암호화해야 합니다.
좀더 자세한 정보는 Martin Schulze의 절차에 관한 노트를 읽기 바랍니다.
이 그림은 CVS 디렉터리의 구조를 보여줍니다.
Please note that the DDP web site is located in the webwml module of the Debian CVS repository, to be integrated with the rest of the Debian web pages.
매뉴얼은 매일 15:39(Pacific time) 이후에 www-master.debian.org에서 수행되는 cron 작업에 의해 웹 페이지로 출판됩니다.
스크립트가 cvs update -d -P와 make -C manuals.sgml
clean publish를 ddp 디렉터리에서 실행합니다.
The makefile is set up to rebuild each subdirectory (that contains
maintained documentation), and to install the files from each subdirectory
in doc/manuals/ subdirectory of the web site. The subdirectory
makefiles are derived from ddp/manuals.sgml/standard.makefile.
업데이트 스크립트가 생성한 문서 파일은 http://www.debian.org/doc/manuals/에서 찾을 수 있습니다.
업데이트 스크립트가 만든 로그 파일은 http://www-master.debian.org/build-logs/ddp/에서 볼 수 있습니다.