OCamlcvs is une interface graphique pour l'outil de gestion de configuration CVS. Il affiche les fichiers et répertoires gérés sous CVS et offre les fonctionnalités CVS par des menus. OCamlcvs peut également montrer les différences entre deux révisions, et un assistant de fusion peut être utilisé pour résoudre les conflits.

OCamlcvs vient avec une bibliothèque qui peut être utilisée pour manipuler des fichiers CVS dans une autre application, comme c'est le cas dans certaines vues de Cameleon.

OCamlcvs est lancé par la commande suivante:

ocamlcvs.{x,byte} [options] directory [directory2 [directory3 ...]]

Chaque répertoire indiqué sur la ligne de commande sera une racine dans la boîte des répertoires, sur la partie gauche de la fenêtre principale. If aucun répertoire n'est indiqué, le répertoire courant sera la seule racine dans cette boîte.

Quand OCamlcvs est lancé, la fenêtre principale apparaît, avec les arborescences de répertoires dans la partie gauche, et une liste de fichiers dans la partie droite. Ce sont les fichiers gérés sous CVS se trouvant dans le répertoire sélectionné dans la partie gauche.

Le menu "CVS" donne accès à des commandes CVS à exécuter sur le répertoire ou le(s) fichier(s) sélectionné(s). Ces commandes sont également accessible par des menus contextuels en cliquant avec le bouton droit de la souris sur un répertoire ou un fichier.

Les fichiers dans la partie droite apparaissent de différentes couleurs, selon leur état (à jour, modifié localement, ...).

Il est possible de paramétrer les commandes CVS lancées par OCamlcvs, par l'intermédiaire du fichier ~/.ocamlcvsrc. Chaque ligne de ce fichier doit avoir la syntaxe suivante:

<command>:<options>

Par exemple, pour indiquer qu'OCamlcvs doit passer des options à la commande "cvs update", il faut mettre la ligne suivante:

update :-d -P -A

Les commandes qui peuvent être paramétrées sont "add", "commit", "remove", "status", "update".

Attention cependant à ne pas mettre d'option qui modifient la sortie des commandes CVS, car cette sortie est analysée par OCamlcvs.

Note: Par défaut, la commande "update" est utilisée avec l'option "-d", and la commande "status" est toujours lancée avec l'option "-l".

Une partie d'OCamlcvs est accessible sous forme de bibliothèque, en incluant le fichier ocamlcvs.cm[x]a. La documentation de référence de cette bibliothèque est accessible ici.