
                          Documentation de daCode
                           http://www.dacode.org
                               Janvier  2001

               Denis Barbier <barbier@imacs.polytechnique.fr>

   Introduction
   ============

   Ce document explique comment participer au dveloppement de
   daCode. Outre ce document, les principales ressources pour
   trouver des rponses  vos questions sont le site web
   <URL:http://www.dacode.org/> et la liste de diffusion de daCode,
   archive sur <URL:http://www.somelist.com/mail.php/230>.
   Pour s'abonner, envoyer un mail  <URL:mailto:sympa@linuxfr.org>
   avec dans le sujet  sub dacode-dev , par exemple en excutant
     mail -s 'sub dacode-dev' sympa@linuxfr.org < /dev/null


   Comment participer
   ==================

   Quels que soient vos talents de dveloppeur, vous pouvez aider 
   la mise au point de daCode. D'ailleurs, il n'est nul besoin d'tre
   dveloppeur, il y a plein de choses  faire comme crire de la
   documentation, retoucher les images, traduire des documents, faire la
   chasse aux bogues, etc qui ne ncessitent aucune connaissance de PHP.
   Ce document ne traite que de la faon de participer au
   dveloppement du code source, vous pouvez demander sur la liste de
   diffusion comment participer aux autres tches.

   Tlcharger les sources
   =======================

   La version stable actuelle est 1.2.0, tlchargeable 

     http://www.daCode.org/download.php3

   La version en cours de dveloppement est disponible sur
   sourceforge.net avec CVS:

     cvs -d \
       :pserver:anonymous@cvs.dacode.sourceforge.net:/cvsroot/dacode \
       login

   (appuyez sur Enter  la demande du mot de passe)

     cvs -z3 -d \
       :pserver:anonymous@cvs.dacode.sourceforge.net:/cvsroot/dacode \
       checkout -P daCode

   Plus tard, lorsque vous voulez mettre  jour vos fichiers, il
   suffit d'aller dans le rpertoire daCode et de taper
     cvs -z3 update -P -d

   Remarque : il est fastidieux de taper les mmes options  chaque
           fois. Heureusement pour les fainants, il existe une
           solution, qui consiste  placer les options qui sont
           toujours utilises dans le fichier $HOME/.cvsrc ; ainsi,
           on peut y mettre les lignes suivantes :
              cvs -z3
              checkout -P
              update -P -d
              diff -u
           Une fois cette manoeuvre effectue, toutes les commandes
           CVS se feront avec l'option -z3, les checkout avec -P,
           etc, rendant ces options sur la ligne de commande
           inutiles. Cependant, nous continuerons  les crire dans
           ce document, par souci de clart.

   Pour ceux n'ayant pas d'accs CVS, une archive est faite tous les
   matins  6h, heure de Paris, et disponible 
      http://perso.linuxfr.org/penso/daCode.tar.gz

   Installation
   ============

   Lire la doc incluse dans daCode, et demander de l'aide sur la
   liste de diffusion en cas de problme.

   Faire des corrections
   =====================

   Seules quelques personnes sont habilites  faire des
   modifications dans le source. Quand vous avec des corrections 
   proposer, il faut envoyer un patch sur la liste de diffusion (voir
   ci-dessous).  Dans la journe, un des dveloppeurs habilits
   devrait rpondre, en disant si le patch a t incorpor ou non, et
   dans ce dernier cas pourquoi.
   Si personne n'a rpondu au bout de quelques jours, c'est que votre
   message a t lu puis oubli, donc n'hsitez pas  vous signaler 
   nouveau, si possible en fournissant un lien vers votre message
   archiv sur <URL:http://www.somelist.com/mail.php/230>.

     Cration d'un patch avec accs CVS
     ----------------------------------

   C'est la solution la plus simple, pour tout le monde. Vous
   rcuprez la version la plus rcente du CVS de daCode, vous faites
   les changements dans le source, puis
        cvs diff -u > ~/dacode.patch
   Si vous ajoutez de nouveaux fichiers, il faut en plus les inclure dans le
   patch. Ce n'est pas faisable avec CVS  cause d'un bogue, il faut
   donc le faire manuellement ; par exemple, pour ajouter le fichier
   src/htdocs/new.php3, tapez
        diff -u /dev/null src/htdocs/new.php3 >> ~/dacode.patch

     Cration d'un patch sans accs CVS
     ----------------------------------

   Vous devez alors rcuprer 
      http://perso.linuxfr.org/penso/daCode.tar.gz
   et le dsarchiver. Il faut ensuite renommer le rpertoire daCode en
   daCode.orig, puis dsarchiver  nouveau, c'est--dire :

      wget http://perso.linuxfr.org/penso/daCode.tar.gz
      tar zxf daCode.tar.gz
      mv daCode daCode.orig
      tar zxf daCode.tar.gz

   Vous avez maintenant deux rpertoires: daCode.orig qui contient
   les sources originales,  ne pas modifier, et dacode, qui est
   votre arborescence de travail.
   Aprs avoir fait les modifications sous ce rpertoire, revenez
   dans le rpertoire contenant daCode et daCode.orig, et lancez
   la commande
      diff -ur --exclude CVS daCode.orig daCode > ~/dacode.patch

   Si vous avez ajout de nouveaux fichiers, vous pouvez procder
   comme dcrit dans la sous-section prcdente, ou utiliser la
   commande
      diff -uNr --exclude CVS daCode.orig daCode > ~/dacode.patch

     Envoi du patch
     --------------

   Envoyez un message sur la liste de diffusion expliquant ce
   que fait votre patch, en mettant [PATCH] dans le sujet pour
   retrouver le message plus facilement, et en n'oubliant pas
   d'attacher le fichier ~/dacode.patch cr suivant une des
   procdures ci-dessus.

