Pour télécharger un manuel complet, un accès direct au serveur CVS est souvent une meilleure solution. Vous aurez besoin du paquet cvs sur votre propre machine.
Se connecter anonymement (en mode lecture seule) sur le serveur CVS
Pour vous connecter, entrez cette commande :
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login
et pressez la touche [entrée] quand il vous est demandé un mot de passe.
Vous pouvez dès lors utiliser les commandes CVS usuelles (se référer aux pages info de CVS) pour sortir des fichiers, mais vous ne pouvez ni les modifier ni les enregistrer.
Pour télécharger les fichiers la première fois, placez-vous dans le répertoire que vous aurez préalablement créé pour les récupérer. Deux nouveaux répertoires nommés CVS et ddp seront créés dans ce répertoire.
Utilisez cette commande pour télécharger tous les fichiers :
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
Cela créera récursivement les répertoires et les remplira.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Quand vous avez fini une session distante CVS, utilisez cette commande pour vous déconnecter du serveur :
cvs logout
Se connecter au serveur CVS avec des privilèges de mise à jour
Avant d'accéder au serveur CVS en utilisant cette méthode, vous devez avoir le droit d'écriture. Lisez d'abord comment demander les permissions de mise à jour.
Pour vous connecter, entrez cette commande :
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc login
puis entrez le mot de passe que vous avez négocié avec le coordinateur de la documentation. Dans la commande ci-dessus, remplacez userid avec votre propre nom d'utilisateur sur le serveur de mot de passe CVS. Ce n'est pas nécessairement le même que votre nom de connexion sur cvs.debian.org, si vous en avez un.
Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les pages info de CVS) pour copier ou enregistrer des fichiers.
Pour télécharger les fichiers la première fois, placez-vous dans le répertoire que vous aurez préalablement créé pour les récupérer. Deux nouveaux répertoires nommés CVS et ddp seront créés dans ce répertoire.
Utilisez cette commande pour télécharger tous les fichiers :
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml
Cela créera récursivement les répertoires et les remplira.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Quand vous avez fini une session distante CVS, utilisez cette commande pour vous déconnecter du serveur :
cvs logout
Se connecter à travers SSH au serveur CVS avec des privilèges de mise à jour
Cette méthode est disponible uniquement pour les développeurs Debian enregistrés et on la préférera à la méthode précédente. Si vous êtes un nouveau développeur Debian, il faut demander au coordinateur de la documentation de supprimer votre compte pserver.
Une connexion utilisant ssh doit être signalée à CVS avec :
export CVS_RSH=ssh
Puis placez-vous dans un répertoire créé pour tout récupérer et entrez cette commande :
cvs -d :ext:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout module
Dans la commande ci-dessus, remplacez userid avec votre propre nom d'utilisateur sur le serveur CVS. Il est identique à votre nom de connexion sur toutes les machines Debian. Remplacez module avec le nom du module que vous souhaitez sortir : c'est généralement ddp/manuals.sgml. On va alors vous demander votre mot de passe sur le serveur CVS. Ne le confondez pas avec celui de votre propre machine.
Deux répertoires, CVS et ddp, seront créés dans ce répertoire. CVS va récursivement créer les modules (c'est-à-dire les répertoires) que vous avez demandés et va les remplir avec les fichiers.
Vous pouvez dès lors utiliser les commandes habituelles de CVS (voir les pages info de CVS) pour copier ou enregistrer des fichiers.
Pour actualiser votre copie locale avec les changements effectués par d'autres personnes, entrez dans le répertoire ddp/manuals.sgml et lancez la commande :
cvs -z3 update -d -P
Les privilèges de mise à jour sont accessibles à quiconque souhaite participer à la rédaction de manuel. Mais en général, vous ne les obtenez qu'après avoir soumis une ou deux corrections utiles.
Pour obtenir des privilèges de mise à jour, envoyez un courrier
chiffré avec la clé publique Debian de aph@debian.org au coordinateur de la documentation, en
indiquant le nom d'utilisateur que vous voulez utiliser sur le pserver
(ainsi qu'un second au cas où le premier ne serait pas disponible) et en
fournissant un mot de passe (en clair ou chiffré).
Ce schéma montre la structure de l'arborescence CVS :
Veuillez noter que le site web du DDP est placé dans le module webwml du référentiel CVS Debian, pour être intégré avec le reste des pages web Debian.
Les pages publiées sur le web sont produites par une tâche cron lancée quotidiennement sur www-master.debian.org, après 15:39 (temps Pacifique).
Le script lance cvs update -d -P, puis make -C manuals.sgml
clean publish, toutes deux dans le répertoire ddp.
Le makefile est configuré pour reconstruire chaque sous-répertoire (qui
contient la documentation maintenue), et pour installer les fichiers de chaque
sous-répertoire dans le sous-répertoire doc/manuals/ du site web.
Les makefiles des sous-répertoires sont dérivés du
ddp/manuals.sgml/standard.makefile.
Les fichiers de documentation produits par le script de mise à jour sont disponibles sur http://www.debian.org/doc/manuals/.
Les fichiers-journaux produits par le script de mise à jour sont disponibles sur