## Utilisation (administration) de ZCVSMixin
#
# Alcve, MiKael, 2001/05/16
# <mikael@fr.alcove.com>
# <mikael.berthe@efrei.fr>
#

                 INTERFACE D'ADMINISTRATION

Description de l'interface d'administration,  CVS Status .

* Zope DB / File system (XML) / CVS
  Deux tapes sont ncessaires pour passer d'un objet Zope au CVS.

  Des symboles sont affichs pour indiquer la synchronisation entre les
  diffrents  formats  de l'objet.
  '='  : les versions correspondent
  '->' : le format  gauche du symbole est plus rcent
  '<-' : le format  droite du symbole est plus rcent

  ZCVSMixin se base sur les dates des objets/fichiers pour dterminer ces
  relations. Malheureusement, c'est parfois source de bugs (ex : les deux
  flches prsentes dans la mme colonne...)

  Autre information sur l'tat des fichiers : dans la colonne CVS ("OK",
  "LM", etc.) Information redondante avec la deuxime colonne de
  symboles.

  La prsence de parenthses autour du fichier XML indique que ce fichier
  n'est pas prsent physiquement (dans ce cas, les symboles ci-dessus
  n'ont aucune valeur).

* Actions

  Avant d'effectuer une action concernant des objets Zope, il faut
  slectionner ces objets (ventuellement   Select All ).

  + Deux lignes principales :
  Objets <-> fichiers : Cette ligne permet de jouer sur les conversions 
        Zope <-> XML, et d'effacer un fichier XML.
        Ces fonctions ne sont pas ncessaires lors d'une utilisation
        normale...
  Check-In <-> CheckOut : Ces fonctions sont les plus utiles ; elles
        permettent :
        - d'ajouter un fichier au CVS (NewObj->CVS) ;
        - de faire un  commit  (CheckIn) ;
        - de faire un  update  (Update).
        Il est possible (conseill ?) de mettre un message de log dans la
        zone  CVS Commit Message  situe  proximit. (Ce message peut
        d'ailleurs tre rendu obligatoire, cf. le panneau CVS Admin)

  + Deux actions sont un peu plus puissantes (donc dangereuses) :
     Force CheckOut  permet de faire un check out en crant les
    rpertoires Zope (et les objets ZCVSMixin associs) automatiquement.
     Remove All  sert  effacer un objet Zope ainsi que
    *tous les formats correspondants* : le fichier XML est supprim et
    un cvs remove est excut.
    C'est *la* manire propre de supprimer un objet, si on ne veut pas
    avoir de problmes avec CVS par la suite...

  + Enfin, il existe d'autres commandes diverses :
    - diff  (possibilit de passer une option, comme "-u") ;
    - status ;
    - log ;
    - "Update FS Object Form CVS" :  n'utiliser qu'en cas de ncessit,
      cette option permet d'craser le fichier XML lorsque la commande
      Update ne s'avre pas assez efficace... (C'est notamment le cas
      lorsque la version CVS du document est plus rcente que le fichier
      XML, mais a ne devrait pas arriver sur l'IntraDoc).


CVS User est une interface simplifie dans laquelle seuls les boutons
Commit et Add subsistent (ainsi que le bouton diff/log/status), et
l'tape XML est cache.


NOTES :
- Ne *pas* utiliser d'ACCENTS dans les noms de documents
- Lorsque le rpertoire courant est vide, un message de la forme
   No objects or files in this directory...  sera affich.


** Scnario **

- cration d'un objet
    -> NewObj
- modification d'un objet
    -> Diff
    -> Commit (Check-In)  Message de log
    -> Diff entre rvisions prcdentes
- annulation d'une modification
    -> Force Check-Out
      S'il s'agit d'une opration dj valide (commit), il est ensuite
      ncessaire de refaire un commit :
    -> Commit (Check-In)


AUTRES PANNEAUX

* CVS Actions

Create CVS Folders Tree : creation d'un objet ZCVS dans tous les
sous-rpertoires.

* CVS Admin

Se reporter  la documentation d'installation (INSTALL, tape 3).
Options supplmentaires :
- Allow other Global Args : permet aux utilisateurs de spcifier une
  ou plusieurs options lors des appels  cvs ("cvs $option ...").
- Allow empty commit messages :  autorise les utilisateurs  laisser
  le champ  Commit Message  vide.
- Enable CVS : si cette case n'est pas coche, les appels  cvs ne seront
  pas effectus.
- MetaTypes to exclude : types d'objets Zope  ne pas prendre en
  considration (ils seront ignors).



# vim: set et sts=2 tw=73 comments=fb\:*,fb\:-,fb\:o ft=text:
