7. CVS

Le LDP est en train de mettre un place un acc�s CVS pour les auteurs. Il y a en effet de bonnes raisons d'utiliser CVS�:

  1. CVS g�re une sauvegarde des documents. Si vous passez un document � un autre auteur, ce dernier peut r�cup�rer le document depuis CVS et continuer � travailler dessus. Si vous avez besoin de revenir � une ancienne version, vous pouvez �galement la r�cup�rer.

  2. CVS est tr�s appr�ciable si plusieurs auteurs travaillent sur le m�me document. Vous pouvez lui demander de vous indiquer quelles modifications ont �t� faites pendant que vous travailliez sur le document, et directement int�grer ces changements.

  3. CVS garde un historique des modifications du document. Cet historique peut �tre plac� automatiquement dans le document si vous utilisez certaines balises qui seront ex�cut�es avant l'interpr�teur SGML.

  4. CVS peut permettre, gr�ce � un programme, la mise � jour automatique du site Web du LDP, et ce d�s qu'un document est termin� et soumis � CVS. Cela n'est pas encore en place, mais est envisag�. Pour l'instant, les mises � jour par CVS signalent au coordinateur des HOWTO qu'une mise � jour du site Web est n�cessaire. Si vous utilisez CVS, vous n'avez donc plus besoin d'envoyer votre document SGML par courrier �lectronique.

Si CVS est quelque chose de nouveau pour vous, voici quelques pages Web qui pourront vous aider�:

7.1. Obtenir un compte CVS

D'abord, il vous faudra obtenir un compte dans le "repository" CVS du LDP (NdT�: lieu de stockage et de d�p�t des documents pour CVS). Il s'agit souvent du r�pertoire racine utilis� par CVS, o� chaque projet (HOWTO, Mini-HOWTO, ...) dispose d'un sous-r�pertoire.

Vous devrez cr�er un mot de passe crypt� et un identifiant d'utilisateur pour votre compte. Crypter votre mot de passe vous permet de l'envoyer au groupe CVS sans qu'on ait besoin de le voir en clair. Vous pouvez le faire par les commandes suivantes, depuis un shell bash (ou sh)�:

bash$ echo your_password | perl -e "print crypt(<>,\ join
'',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\""

Envoyez la sortie de cette commande avec l'identifiant d'utilisateur � . Votre propre r�pertoire CVSROOT sera cr�� et vous recevrez un e-mail avec une r�ponse. Quand vous aurez obtenu la r�ponse, connectez-vous sur votre CVSROOT et v�rifiez que tout est configur� correctement�:

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

(Remplacez your_userid par ce qui vous a �t� indiqu� dans la r�ponse.)

On vous demandera de saisir votre mot de passe, � la suite de quoi vous aurez acc�s au repository CVS en lecture-�criture. Apr�s avoir utilis� cvs login une fois et obtenu l'acc�s au syst�me, votre mot de passe sera stock� dans .cvsroot et vous n'aurez plus besoin d'utiliser cvs login. Positionnez CVSROOT correctement et c'est parti. Vous pouvez r�cup�rer le repository linuxdoc en entier avec cette commande�:

bash$ cvs get LDP 

Ou vous pouvez obtenir le fichier source SGML de votre propre document par�:

bash$ cvs get howto/YOUR-HOWTO.sgml 
bash$ cvs get minihowto/YOURDOC.sgml 

7.2. Autres informations sur CVS

7.2.1. Acc�s CVS anonyme

Un acc�s CVS anonyme est disponible pour ceux qui n'ont pas besoin de compte (tels ceux d�sirant juste r�cup�rer les documents du LDP). Ce repository est en lecture seule�:

bash$ cvs -d \
:pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login 

Utilisez "cvs" comme mot de passe. Vous pouvez alors acc�der aux modules linuxdoc comme d�crit ci-dessus. Notez que les changements apparaissent sur le CVS anonyme une demi-heure environ apr�s le site principal.

7.2.2. Acc�s CVS par le Web

Vous pouvez acc�der au repository CVS par le Web � l'adresse http://cvsweb.linuxdoc.org/index.cgi/linuxdoc.

7.2.3. Acc�s graphique � CVS

Il existe des interfaces graphiques pour CVS, et vous en trouverez une liste sur le site http://freshmeat.net/appindex. Lancez-y une recherche sur: "CVS".

7.3. CVS et la mise � jour des fichiers

CVS reconna�t une balise sp�ciale, $Id, que vous pouvez utiliser pour ins�rer automatiquement la date et le num�ro de version dans votre document. Lors de la mise � jour, CVS remplace cette balise par quelque chose comme $Id: HOWTO-HOWTO.sgml,v 1.5 2000/06/12 21:45:51 gferg Exp $. En pla�ant cette balise dans votre document, elle sera modifi�e � chaque changement du document, permettant une incr�mentation automatique du num�ro de version.

Quand vous voulez copier votre fichier modifi� sur le serveur CVS, utilisez la commande cvs ci -m "commentaires" VOTRE-HOWTO.sgml. Le param�tre -m "commentaires" n'est pas obligatoire, mais si vous ne le mettez pas, votre �diteur de texte sera lanc� (en g�n�ral vi, ou du moins l'�diteur indiqu� par la variable d'environnement EDITOR) et vous pourrez taper un commentaire � propos des changements.

Vous pouvez suivre toutes les discussions � propos de CVS sur la liste ldp-discuss. Pour l'instant, les soumissions LDP doivent toujours �tre envoy�es � .

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:30