Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	.de SP .if n .if t .5 .. .de ` [b]` $1 '$2[/b] .. [size=18] [b]Nom[/b] [/size] cvs - Concurrent Versions System [size=18] [b]Résumé[/b] [/size] [table][row][col]    [/col][col][b]cvs[/b] [ [i]options_cvs[/i] ] [i]commande_cvs[/i] [ [i]options_commande[/i] ] [ [i]arguments_commande[/i] ][/col][/row][/table] [size=18] [b]Note[/b] [/size] Cette page de manuel est un condensé des possibilités de [b]cvs[/b]. La documentation officielle est celle du manuel écrit par Per Cederqvist, qu'il est possible de consulter soit via la commande [b]info[/b] cvs, soit comme indiqué dans la section VOIR AUSSI. [size=18] [b]Note du traducteur[/b] [/size] [b]cvs[/b] utilise un vocabulaire spécifique à la gestion de versions. Afin de ne pas dérouter les lecteurs connaissant [b]cvs[/b], nous utiliserons pour certains termes le mot anglais, tandis que d'autres seront utilisés en français. Voici ici la liste des termes traduits : [table][row][col]    [/col][col]repository : référentiel[/col][/row][/table] [table][row][col]    [/col][col]tag : marqueur[/col][/row][/table] [size=18] [b]Description[/b] [/size] .IX "revision control system" "fLcvs" .IX cvs "" "fLcvs - concurrent versions system" .IX "concurrent versions system - fLcvs" .IX "release control system" "cvs command" "" "fLcvs - concurrent versions system" .IX "source control system" "cvs command" "" "fLcvs - concurrent versions system" .IX revisions "cvs command" "" "fLcvs - source control" [b]CVS[/b] est un outil de gestion de versions, permettant de conserver d'anciennes versions de fichiers (bien souvent du code source), et de garder une trace de qui, quand et pourquoi une modification a été effectuée, à la manière de RCS ou SCCS. A la différence d'autres outils plus simplistes, [b]cvs[/b] ne travaille pas sur un fichier ou un répertoire à la fois, mais sur des hiérarchies de répertoires où tous les fichiers sont suivis. [b]cvs[/b] facilite la gestion de releases et le contrôle de l'édition de fichiers par plusieurs personnes différentes. [b]cvs[/b] permet le déclenchement d'événements permettant de tracer/contrôler diverses opérations. [b]cvs[/b] est également adapté à une utilisation sur des réseaux à faible débit. .SP [b]cvs[/b] conserve une seule instance de chaque fichier. Cette copie est appelée « référentiel », et contient toutes les informations permettant l'extraction des versions précédentes, à la fois sur des critères de « marqueurs » ou de dates. [size=18] [b]Commandes indispensables[/b] [/size] [b]cvs[/b] fournit un grand nombre de commandes (cf [i]commande_cvs[/i] dans la section Synopsis), chacune possédant un grand nombre d'options pour satisfaire les multiples besoins de la gestion de fichiers dans un environnement distribué. Cependant, vous n'aurez pas besoin de maîtriser tous les secrets de [b]cvs[/b] pour travailler efficacement ; 5 commandes sont en fait suffisantes pour effectuer les tâches classiques sur un référentiel. [table][row][col]    [/col][col][b]cvs[/b] checkout [i]modules[/i]... La tâche préliminaire à tout travail avec [b]cvs[/b] : crée une copie personnelle des fichiers d'un ou plusieurs [i]modules[/i]. Vous pouvez travailler avec cette copie sans interférer avec le travail des autres personnes. Un sous-répertoire au minimum est créé lors de cette opération. Il est également possible de ne récupérer que des sous-répertoires d'un module donné.[/col][/row][/table] [table][row][col]    [/col][col][b]cvs[/b] update Utilisez cette commande dans un répertoire contenant un [i]module[/i] lorsque vous souhaitez mettre à jour votre copie personnelle des modifications qui ont pu être effectuées par d'autres personnes sur le référentiel.[/col][/row][/table] [table][row][col]    [/col][col][b]cvs[/b] add [i]fichier[/i]... Utilisez cette commande pour marquer des fichiers de votre répertoire de travail comme étant à ajouter au référentiel. Ces fichiers ne seront réellement ajoutés au référentiel que lorsque vous utiliserez la commande « cvs commit ». Note : la commande « cvs add » n'est utilisée que pour ajouter de nouveaux fichiers dans un module déjà créé. Il faut utiliser la commande « cvs import » pour créer un nouveau [i]module[/i] dans le référentiel.[/col][/row][/table] [table][row][col]    [/col][col][b]cvs[/b] remove [i]fichier[/i]... Utilisez cette commande pour demander la suppression de fichiers du référentiel (après les avoir effacés de votre répertoire de travail). Ces fichiers ne sont réellement supprimés du référentiel que lorsque vous utiliserez la commande « cvs commit ».[/col][/row][/table] [table][row][col]    [/col][col][b]cvs[/b] commit [i]fichier[/i]... Utilisez cette commande lorsque vous décidez de rendre publiques vos modifications sur un module aux autres personnes.[/col][/row][/table] [size=18] [b]Options[/b] [/size] Une ligne de commande [b]cvs[/b] contient des [b]options_cvs[/b] (facultatives) s'appliquant à l'exécutable [b]cvs[/b] ; une [b]commande_cvs ,[/b] donnant l'action à effectuer sur le référentiel ; des [i]options_de_commande[/i] et des [i]arguments_de_commande[/i] précisant l'opération exacte à exécuter par la [i]commande_cvs[/i]. .SP [i]Attention[/i] : vous devez prendre garde à l'endroit où vous placez les options dans la ligne de commande par rapport à la [b]commande_cvs.[/b] La même option peut avoir plusieurs significations ; à gauche de la [i]commande_cvs[/i] c'est une option s'appliquant à l'exécutable [b]cvs[/b], à droite, c'est une option s'appliquant à la [i]commande_cvs[/i]. .SP Seules deux situations permettent l'absence de [b]commande_cvs[/b] : « cvs -H » ou « cvs --help » qui affiche la liste des commandes disponibles, et « cvs -v » ou « cvs --version » qui affiche la version de [b]cvs[/b]. .SP [size=18] [b]Options[/b] [/size] Depuis la version 1.6, [b]cvs[/b] gère les noms d'options courts ou longs (standard GNU). Cependant, seul un petit nombre d'options longues sont disponibles ; elles sont affichées entre crochets après le nom d'option court. [b]-H [ --help ][/b] [table][row][col]    [/col][col]Affiche les informations relatives à une [i]commande_cvs[/i] (mais n'exécute pas cette commande). Si vous ne précisez pas de commande, « cvs -H » affiche la liste des commandes disponibles.[/col][/row][/table] [b]-Q[/b] [table][row][col]    [/col][col]Rend l'exécution de la commande [i]très[/i] silencieuse ; la commande n'affichera de sortie qu'en cas de réel problème.[/col][/row][/table] [b]-q[/b] [table][row][col]    [/col][col]Rend l'exécution de la commande silencieuse ; les messages d'information tels que ceux concernant le parcours récursif de répertoires sont supprimés.[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-b [i]bindir[/i] Utilise [i]bindir[/i] comme répertoire où les programmes [size=6]RCS[/size] sont situés (pour les versions de CVS antérieures à 1.9). Remplace le contenu de la variable d'environnement [size=6]RCSBIN.[/size] Cette valeur doit être un chemin absolu.[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-d [i]racine_du_référentiel_CVS[/i] Utilise [i]racine_du_référentiel_CVS[/i] comme répertoire racine du référentiel. Remplace le contenu de la variable d'environnement [size=6]CVSROOT.[/size] Cette valeur doit être un chemin absolu.[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-e [i]editeur[/i] Utilise [i]editeur[/i] comme programme de saisie des informations de mise à jour. Remplace le contenu des variables [size=6]CVSEDITORc[/size] , [size=6]VISUALc[/size] , et [size=6]EDITOR.[/size][/col][/row][/table] [table][row][col]    [/col][col][b][/b]-f Empêche la lecture du fichier de configuration de [b]cvs[/b] ([i]~/.cvsrc[/i]).[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-l N'enregistre pas la [i]commande_cvs[/i] dans l'historique (mais l'exécute quand même). Se reporter à la description de la commande [b]history[/b] pour de plus amples renseignements. NdT : option supprimée dans cvs 1.11.13[/col][/row][/table] [b]-n[/b] [table][row][col]    [/col][col]N'effectue aucun changement sur les fichiers. La [b]commande_cvs ,[/b] est exécutée, mais sans ajout, mise à jour, suppression ou fusion de fichiers.[/col][/row][/table] [b]-t[/b] [table][row][col]    [/col][col]Affiche une trace lors de l'exécution ; chaque étape de la [i]commande_cvs[/i] affiche un message. Cette option est souvent utilisée en conjonction avec [b][/b]-n pour examiner l'impact d'une [i]commande_cvs[/i] inconnue.[/col][/row][/table] [b]-r[/b] [table][row][col]    [/col][col]Les fichiers de travail sont créés en lecture seule. Déclarer la variable d'environnement [size=6]CVSREAD[/size] produit le même effet.[/col][/row][/table] [b]-v [ --version ][/b] [table][row][col]    [/col][col]Affiche le numéro de version et les informations de copyright de [b]cvs .[/b][/col][/row][/table] [b]-w[/b] [table][row][col]    [/col][col]Les fichiers de travail sont créés en lecture-écriture (mode par défaut). Annule la déclaration de la variable d'environnement [size=6]CVSREAD .[/size][/col][/row][/table] [b]-x[/b] [table][row][col]    [/col][col]Crypte les communications entre client et serveur. Au moment de l'écriture de ce texte (NdT : et non de sa traduction), ceci n'est possible qu'avec une connexion Kerberos.[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-z [i]niveau_de_compression[/i] Utilise [b]gzip[/b] pour compresser les données lors des transferts réseau. L'exécutable GNU [b]gzip[/b] doit être présent dans le path du client et du serveur.[/col][/row][/table] [size=18] [b]Utilisation[/b] [/size] Il est indispensable de fournir une [i]commande_cvs[/i] à [b]cvs[/b], sauf dans le cas « cvs -H » (demande d'aide). Toute [i]commande_cvs[/i] possède à son tour un certain nombre d'options et d'arguments. Certaines options sont communes à plusieurs [i]commande_cvs[/i]. Il est possible d'afficher une aide succinte sur l'utilisation d'une commande en utilisant l'option [b][/b]-H avec cette commande. [size=18] [b]Fichier de configuration cvs[/b] [/size] Lorsque l'exécutable [b]cvs[/b] est lancé, celui-ci lit le fichier [i].cvsrc[/i]. Il est possible d'empêcher cette lecture avec l'option [b][/b]-f. .SP Le fichier [i].cvsrc[/i] contient une liste des commandes CVS, accompagnées d'une liste d'arguments. Ces arguments sont automatiquement ajoutés à la ligne de commande lors de l'utilisation de la commande CVS. Il n'est possible de mettre qu'une seule commande par ligne. Exemple : .SP diff -c .SP signifie que la commande .` "cvs diff" sera toujours lancée avec l'option -c, en plus des options pouvant être fournies sur la ligne de commande. Ici, les différences entre fichiers seront affichées avec leur contexte pour tout appel de la commande .` "cvs diff" . .SP Il est possible de spécifier des paramètres applicables à l'exécutable [b]cvs[/b] en utilisant le mot clé [i]cvs[/i]. Par exemple, la ligne : .SP cvs -q .SP signifie que toutes les commandes .` "cvs" utiliseront l'option -q. [size=18] [b]Recapitulatif des commandes cvs[/b] [/size] Voici un bref aperçu des commandes [b]cvs[/b] : [b]add[/b] [table][row][col]    [/col][col]Ajoute un nouveau fichier ou répertoire au référentiel, qui devra être validé par un « cvs commit ». Cette commande ne peut être lancée que dans un répertoire précédemment créé par la commande « cvs checkout ». Cette commande ne modifie que le répertoire de travail.[/col][/row][/table] [b]admin[/b] [table][row][col]    [/col][col]Exécute des fonctions d'administration sur le référentiel. Cette commande modifie le référentiel. Il est nécessaire d'avoir un répertoire de travail, mais celui-ci n'est pas modifié.[/col][/row][/table] [b]checkout[/b] [table][row][col]    [/col][col]Rapatrie une version des fichiers sources dans le répertoire de travail. Cette commande modifie le répertoire de travail.[/col][/row][/table] [b]commit[/b] [table][row][col]    [/col][col]Applique les modifications (ajouts, modifications et suppressions) effectuées dans le répertoire de travail au référentiel. Cette commande ne modifie que le référentiel.[/col][/row][/table] [b]diff[/b] [table][row][col]    [/col][col]Affiche les différences entre un ou plusieurs fichiers du répertoire de travail et leur version dans le référentiel, ou entre deux versions du référentiel. Cette commande ne modifie ni le répertoire de travail ni le référentiel.[/col][/row][/table] [b]export[/b] [table][row][col]    [/col][col]Rapatrie une version des fichiers sources dans le répertoire de travail. A la différence de « cvs checkout », aucun répertoire destiné au contrôle des sources par [b]cvs[/b] n'est créé. Par conséquent, il est impossible d'exécuter un « cvs commit » dans un répertoire créé par « cvs export ». De plus, il est nécessaire de préciser un marqueur symbolique spécifiant la version à rapatrier. Cette commande est essentiellement utilisée pour livrer une version stable sur un site. Le référentiel n'est pas modifié.[/col][/row][/table] [b]history[/b] [table][row][col]    [/col][col]Affiche la liste des commandes [b]cvs[/b] exécutées sur un fichier ou dans un répertoire spécifique du référentiel. Cette commande ne change ni le référentiel ni le répertoire de travail. L'historique des commandes n'est conservé que si le fichier « $CVSROOT/CVSROOT/history » est présent (voir [b]cvs ( 5 )).[/b][/col][/row][/table] [b]import[/b] [table][row][col]    [/col][col]Incorpore des modifications hors-site au référentiel, en tant que « vendor branch ». Cette commande modifie le référentiel.[/col][/row][/table] [b]init[/b] [table][row][col]    [/col][col]Initialise un référentiel par l'ajout d'un sous-répertoire CVSROOT et de fichiers essentiels. Il est nécessaire d'initialiser le référentiel par cette commande ou tout autre moyen avant de pouvoir l'utiliser.[/col][/row][/table] [b]log[/b] [table][row][col]    [/col][col]Affiche des informations de log. Ne modifie ni le référentiel ni le répertoire de travail.[/col][/row][/table] [b]rdiff[/b] [table][row][col]    [/col][col]Génère un fichier de correctif comprenant toutes les différences sur les fichiers entre deux releases du référentiel. Cette commande ne modifie ni le référentiel, ni le répertoire de travail.[/col][/row][/table] [b]release[/b] [table][row][col]    [/col][col]Annule une commande « cvs checkout ». Cette commande peut supprimer le répertoire de travail, mais ne modifie pas le référentiel.[/col][/row][/table] [b]remove[/b] [table][row][col]    [/col][col]Supprime un fichier du référentiel. La suppression devra être validée par un « cvs commit » sur ce même fichier. Cette commande modifie le répertoire de travail, mais ne modifie pas le référentiel.[/col][/row][/table] [b]rtag[/b] [table][row][col]    [/col][col]Pose un marqueur symbolique sur une révision d'un ou plusieurs fichiers d'un référentiel. Se reporter à .` "cvs tag". Cette commande modifie le référentiel, mais ne nécessite ni ne modifie le répertoire de travail.[/col][/row][/table] [b]status[/b] [table][row][col]    [/col][col]Affiche l'état actuel des fichiers : dernière version, version dans le répertoire de travail et si celle-ci a été modifiée, et de manière facultative, les marqueurs symboliques sur le fichier. Cette commande ne modifie ni le référentiel, ni le répertoire de travail.[/col][/row][/table] [b]tag[/b] [table][row][col]    [/col][col]Pose un marqueur symbolique sur des fichiers d'un référentiel. Par défaut, marque la dernière révision synchronisée avec le répertoire de travail. Modifie le référentiel ; utilise le répertoire de travail sans le modifier.[/col][/row][/table] [b]update[/b] [table][row][col]    [/col][col]Synchronise le répertoire de travail avec le référentiel. Les merges sont effectués automatiquement si possible ; un avertissement est affiché si une intervention manuelle est nécessaire. Cette commande modifie le répertoire de travail, mais ne modifie pas le référentiel.[/col][/row][/table] [size=18] [b]Options[/b] [/size] Cette section décrit les [i]options_des_commandes[/i] disponibles pour la majorité des [b]commandes_cvs[/b]. Certaines commandes ne reconnaissent pas toutes les options, notamment si celles-ci n'ont pas de sens pour la commande. Si une option présente dans cette liste est reconnue par une commande, elle aura le même effet pour toute autre commande. Par contre, les effets peuvent être différents pour les options qui seront décrites plus tard dans le document et spécifiques à une commande. [i]Avertissement :[/i] la commande [b]history[/b] (historique) déroge à cette règle : plusieurs options présentes ici ont un effet différent pour cette commande. [table][row][col]    [/col][col][b][/b]-D [i]date[/i] Utilise la version la plus récente précédant [i]date[/i] (cette date doit être antérieure à la date du jour). Un grand nombre de formats sont reconnus, dont le format ISO (« 1972-09-24 20:05 ») ou le format Internet (« 24 Sep 1972 20:05 »). La date utilise le fuseau horaire local, à moins qu'un autre fuseau horaire ne soit précisé. Cette donnée est « collante » lorsque vous rapatriez un fichier ; en effet, les mises à jour futures utiliseront cette même date sauf demande contraire (se reporter à la description de la commande [b]update[/b]). [b][/b]-D est disponible pour les commandes « checkout », « diff », « history », « export », « rdiff », « rtag » et « update ». Quelques exemples : .in +1i .ft B .nf 1 month ago [i](un[/i] mois auparavant) 2 hours ago [i](deux[/i] heures auparavant) 400000 seconds ago [i](400000[/i] secondes auparavant) last year [i](l'année[/i] dernière) last Monday [i](le[/i] dernier lundi) yesterday [i](hier)[/i] a fortnight ago [i](l'avant-veille)[/i] 3/31/92 10:00:07 PST January 23, 1987 10:05pm 22:00 GMT .fi .ft P .in -1i[/col][/row][/table] [b]-f[/b] [table][row][col]    [/col][col]Lorsqu'une date ou un marqueur est précisé pour une commande [b]cvs[/b], celle-ci ignore les fichiers ne contenant pas ce marqueur ou n'existant pas à cette date. Précisez l'option [b]-f[/b] pour rapatrier les fichiers n'ayant aucune correspondance (la dernière version est utilisée dans ce cas). [b][/b]-f est utilisable avec les commandes « checkout », « export », « rdiff », « rtag » et « update ».[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-k [i]indicateur[/i] Modifie la prise en charge des mots-clés. [b][/b]-f est disponible pour les commandes « add », « checkout », « diff », « export », « rdiff » et « update ». Cette donnée est « collante » lorsque vous l'utilisez pour rapatrier une copie d'un fichier (c'est-à-dire lorsqu'elle est utilisée avec les commandes [b]checkout[/b] ou [b]update[/b]). .SP Les [i]indicateurs[/i] les plus utiles sont -ko et -kb (pour les fichiers binaires) et -kv pour les [b]export[/b] où il est important de conserver les informations des mots-clés pour un [b]import[/b] ultérieur.[/col][/row][/table] [b]-l[/b] [table][row][col]    [/col][col]La commande [b]cvs[/b] n'est exécutée que dans le répertoire courant, sans parcourir les sous-répertoires. Cette option est utilisable avec les commandes « checkout », « commit », « diff », « export », « remove », « rdiff », « rtag », « status », « tag » et « update ».[/col][/row][/table] [b]-n[/b] [table][row][col]    [/col][col]Cette option permet de [i]ne[/i] pas lancer de programme externe lors de l'utilisation des commandes checkout / commit / tag ou update (il est en effet possible de paramétrer par module l'exécution d'un programme externe à chacune de ces tâches). Cette option est utilisable avec les commandes « checkout », « commit », « export » et « rtag ». [i]Avertissement :[/i] cette option est différente de l'option .` "cvs -n" utilisée à gauche d'une commande [b]cvs[/b] ![/col][/row][/table] [b]-P[/b] [table][row][col]    [/col][col]Élague (supprime) les répertoires vides après un mise à jour de données, que ce soit par une commande [b]checkout ou update .[/b] Les répertoire vides (sans fichiers gérés par CVS) sont normalement laissés tels quels. L'option [b][/b]-P permet de supprimer sans confirmation ces répertoires vides. Les répertoires ne sont supprimés que dans la version personnelle et non dans le référentiel. Cette option est automatiquement utilisée lorsque les options [b][/b]-r ou [b][/b]-D sont précisées avec les commandes [b]checkout et export .[/b][/col][/row][/table] [b]-p[/b] [table][row][col]    [/col][col]Redirige les fichiers rapatriés du référentiel vers la sortie standard. Cette option est utilisable avec les commandes « checkout » et « update ».[/col][/row][/table] [table][row][col]    [/col][col][b][/b]-r [i]marqueur[/i] Utilise la révision spécifiée par l'argument [i]marqueur[/i] au lieu de la révision par défaut « head ». En plus des marqueurs pouvant être placés avec les commandes [b]tag[/b] et [b]rtag[/b], deux marqueurs spéciaux peuvent toujours être utilisés : .` "HEAD" est la révision la plus récente dans le référentiel et .` "BASE" est la dernière révision rapatriée dans le répertoire de travail. .SP Les [i]marqueurs[/i] sont « collants » lorsqu'ils sont utilisés avec les commandes « checkout » et « update » : ceux-ci seront réutilisés lors des mises à jour futures, sauf spécification contraire. Un [i]marqueur[/i] peut être soit symbolique, soit numérique. L'option [b][/b]-q est souvent associée à l'option [b][/b]-r afin de supprimer les messages d'avertissements lorsque les fichiers [size=6]RCS[/size] ne contiennent le marqueur demandé. L'option [b][/b]-r est disponible avec les commandes « checkout », « commit », « diff », « history », « export », « rdiff », « rtag » et « update ». [i]Avertissement :[/i] cette option est différente de l'option .` "cvs -r" utilisée à gauche d'une commande [b]cvs[/b] ![/col][/row][/table] [size=18] [b]Commandes cvs[/b] [/size] Voici finalement le détail de toutes les commandes [b]cvs[/b] et de leurs options. Les quelques lignes de résumé après chaque commande décrivent trois choses : [table][row][col]    [/col][col] Les options de la commande et les arguments Les options spécifiques sont décrites en détail ci-dessous ; les options courantes n'apparaissent que dans le résumé.[/col][/row][/table] [table][row][col]    [/col][col] Répertoire de travail ou référentiel ? Certaines commandes [b]cvs[/b] nécessitent un répertoire de travail pour fonctionner ; d'autres nécessitent un référentiel. De même, certaines commandes modifient le référentiel, d'autres modifient le répertoire de travail, et d'autres ne modifient rien du tout.[/col][/row][/table] [table][row][col]    [/col][col] Synonymes Beaucoup de commandes ont des synonymes, qui peuvent être plus faciles à retenir ou à taper que le nom principal.[/col][/row][/table] [table][row][col]    [/col][col][b]add[/b] [[b][/b]-k [i]kflag[/i]] [[b][/b]-m '[i]message[/i][b]'[/b]] [i]fichiers.[/i].. [i]Nécessite :[/i] Référentiel, répertoire de travail [b][/b] [i]Modifie :[/i] Répertoire de travail. [b][/b] [i]Synonyme :[/i] [b]new[/b] [b][/b] Utilisez la commande [b]add[/b] pour créer un nouveau fichier ou répertoire dans le référentiel. Ce fichier ou répertoire doit exister dans votre arborescence (qui doit avoir été créée par la commande [b]checkout ). Pour ajouter une nouvelle arborescence de travail au référentiel,[/b] utilisez plutôt la commande .` "cvs import" . .SP Si l'argument de .` "cvs add" est un sous-répertoire, celui-ci est créé au bon endroit dans le référentiel, et les fichiers d'administration sont créés dans votre répertoire de travail. Si le répertoire existe déjà dans le réferentiel, .` "cvs add" crée quand même les fichiers d'administration dans votre répertoire de travail. Ceci permet l'utilisation de .` "cvs add" pour ajouter un répertoire à vos sources même si un autre utilisateur a déjà créé ce répertoire après votre [b]checkout[/b] des sources. Vous pouvez par exemple faire : .SP .in +1i .ft B .nf exemple% mkdir nouveau_repertoire exemple% cvs add nouveau_repertoire exemple% cvs update nouveau_repertoire .fi .ft P .in -1i .SP Une autre façon de faire est d'utiliser la commande : .SP .in +1i .ft B .nf exemple% cvs update -d nouveau_repertoire .fi .ft P .in -1i .SP Pour ajouter [i]tous[/i] les nouveaux répertoires du référentiel à votre répertoire de travail, il est préférable d'utiliser la commande .` "cvs checkout" ou .` "cvs update -d". .SP Les fichiers ajoutés ne sont pas créés dans le référentiel avant le lancement de la commande .` "cvs commit" , rendant les modifications permanentes. Lancer un .` "cvs add" sur un fichier supprimé avec la commande .` "cvs remove" ramène le fichier à la vie si la commande .` "cvs commit" n'a pas déjà été lancée. .SP Vous aurez la possibilité d'ajouter un message d'information lors du .` "cvs commit" créant le fichier de manière permanente dans le référentiel. Pour ajouter un message lors de la création du fichier (pour décrire le but du fichier par exemple), préciser l'option .` "-m [i]message[/i]" à la commande [b]add[/b]. .SP L'option .` "-k kflag" définit de quelle manière un fichier doit être rapatrié. L'argument .` "kflag" est enregistré dans le fichier [size=6]RCS[/size] et peut être modifié avec la commande .` "cvs admin". Les fichiers binaires utilisent généralement l'option .` "-ko" précisant que les mots-clés ne doivent pas être interprétés.[/col][/row][/table] [table][row][col]    [/col][col][b]admin[/b] [[i]rcs-options[/i]] [i]fichiers.[/i].. [i]Nécessite :[/i] Référentiel, répertoire de travail. [b][/b] [i]Modifie :[/i] Référentiel. [b][/b] [i]Synonyme :[/i] [b]rcs[/b] [b][/b] C'est l'interface [b]cvs[/b] d'administration, similaire à [b]rcs ( 1 ).[/b] Cette commande fonctionne récursivement, une extrême prudence doit donc être observée lors de son utilisation.[/col][/row][/table] [table][row][col]    [/col][col][b]checkout[/b] [[b]options[/b]] [i]modules[/i]... [i]Nécessite :[/i] référentiel. [b][/b] [i]Modifie :[/i] répertoire de travail. [b][/b] [i]Synonymes :[/i] [b]co , get[/b] [b][/b] Rapatrie les fichiers source d'un [i]module[/i] dans le répertoire de travail. Vous devez lancer la commande .` "cvs checkout" avant d'utiliser à peu près n'importe quelle commande [b]cvs[/b], car celles-ci nécessitent un répertoire de travail valide. .SP Les [i]modules[/i] sont soit des noms symboliques (définis dans le module .` "modules" du référentiel ; voir [b]cvs ( 5 ))[/b] pour certains fichiers ou répertoires, ou directement des chemins ou répertoires du référentiel. .SP Suivant les [i]modules[/i] demandés, la commande [b]checkout[/b] peut créer des sous répertoires et les remplir de fichiers. Vous pouvez ensuite modifier ces fichiers indépendemment des autres personnes, récupérer les modifications effectuées par d'autres personnes ou valider vos modifications dans le référentiel. .SP Il faut noter que la commande [b]checkout[/b] crée souvent un sous-répertoire du nom du [i]module[/i] demandé (sauf si le [i]module[/i] demandé est un alias, auquel cas le sous-répertoire peut avoir un nom différent). La commande [b]checkout[/b] indiquera le chemin de chaque sous-répertoire créé dans votre répertoire de travail (sauf si vous spécifiez l'option -Q). .SP Exécuter la commande .` "cvs checkout" dans un répertoire déjà construit par la commande [b]checkout[/b] est permis, et effectue le même travail que la commande [b]update[/b] avec l'option [b]-d[/b]. .SP Les [i]options[/i] disponibles avec la commande .` "cvs checkout" sont les options standards [b]-P , -f , [/b] [b][i]-k kflag[/i][/b] &, [b]-l , -n , -p , [/b] [b]-r[/b] [b]tag , and[/b] [b][i]-D datec[/i][/b] &. .SP En plus de ces options, vous pouvez utiliser les options spécifiques à [b]checkout[/b] : .SP L'option [b]-A[/b] réinitialise les sticky tags, dates et options [b]-k[/b] (si vous travaillez sur un fichier avec une option [b]-r[/b], [b]-D[/b] ou [b]-k[/b], [b]cvs[/b] retient les marqueurs, dates et [i]drapeaux[/i] correspondants et continue à les utiliser pour les mises à jour futures. L'option [b]-A[/b] signale à [b]cvs[/b] d'oublier des spécifications et de rechercher la version ``head'' du fichier). .SP L'option [i][/i]-j " branche" fusionne les changements entre votre révision et la révision demandée (si le marqueur se réfère à une branche, [b]cvs[/b] fusionnera tout changement effectué dans la branche dans votre fichier). .SP Si deux options [b][/b]-j sont précisées, [b]cvs[/b] fusionne les modifications des deux révisions, pour supprimer un delta avec les fichiers de travail par exemple. .SP De plus, chaque option [b][/b]-j peut contenir une date, qui utilisée en conjonction avec les branches, peut limiter le choix de la révision à celle d'une certaine date. Une date peut être précisée en ajoutant le symbole deux-points (:) au marqueur. Un exemple peut être celui de la sortie de la commande .` "cvs import" lorsque les sources qui viennent juste d'être importées entrent en conflit avec les modifications dans le répertoire de travail. .SP .in +1i .ft B .nf exemple% cvs checkout -jTAG:yesterday -jTAG module .fi .ft P .in -1i .SP Utilisez l'option [b][/b]-N avec l'option .` "-d [i]dir[/i]" pour ne pas supprimer le nom du module dans l'arborescence où sera rapatrié le module ([b]cvs[/b] réduit normalement au plus court les noms de répertoire lorsqu'il est spécifié un répertoire d'un module à rapatrier). .SP Utilisez l'option [b]-c[/b] pour récupérer la liste triée des fichiers du module sur la sortie standard. L'utilisation de cette option ne modifie pas de fichiers ou de répertoires dans le répertoire de travail. .SP Utilisez l'option [b][i]-d repertoire[/i][/b] pour créer un répertoire nommé [i]repertoire[/i] où créer les fichiers, au lieu d'utiliser le nom du module. Sauf si vous précisez l'option [b][/b]-N, les chemins créés seront aussi courts que possible. .SP Utilisez l'option [b]-s[/b] pour afficher les informations d'état stockées pour chaque module.[/col][/row][/table] [table][row][col]    [/col][col][b]commit[/b] [[b][/b]-lnR] [[b][/b]-m '[i]message[/i]' \| [b][/b]-f [i]fichier[/i]] [[b][/b]-r [i]revision[/i]] [[i]fichiers.[/i]..] [i]Nécessite :[/i] répertoire de travail, référentiel [b][/b] [i]Modifie :[/i] référentiel [b][/b] [i]Synonyme :[/i] [b]ci[/b] [b][/b] Utilisez la commande .` "cvs commit" pour inclure des modifications dans votre répertoire de travail au référentiel. .SP Si vous ne spécifiez pas de [i]fichiers[/i] à commiter, tous les fichiers du répertoire de travail sont parcourus. [b]commit[/b] ne modifie dans le référentiel que les fichiers qui ont réellement changé. Les fichiers dans les sous-répertoires sont aussi examinés et commités par défaut (ou en utilisant l'option [b][/b]-R) s'ils ont été modifiés. Il est possible d'utiliser l'option [b][/b]-I pour limiter le commit au répertoire courant uniquement. Il est parfois utile de forcer un commit même si le fichier n'a pas été modifié ; ceci est possible en utilisant l'option [b][/b]-f, qui a aussi l'effet de supprimer la récursivité (qu'il est possible de réactiver avec l'option [b][/b]-R). .SP [b]commit[/b] vérifie que les fichiers sont en phase avec les révisions actuelles du référentiel. Si un des fichiers doit dans un premier temps être mis à jour, [b]commit[/b] envoie le message et quitte en annulant les modifications. [b]commit[/b] ne lance pas la commande [b]update[/b]. .SP Si tout est correct, un éditeur est exécuté pour permettre la saisie d'un message de log. Ce message sera écrit dans le référentiel. Il est possible de spécifier le message directement dans la ligne de commande avec l'option [b][/b]-m (cela annule l'exécution de l'éditeur), ou d'utiliser l'option [b][/b]-F pour signaler que l'argument [i]fichier[/i] contient le message de log. .SP L'option [b][/b]-r peut être utilisée pour commit avec une révision spécifique (qu'elle soit symbolique ou numérique). Par exemple, pour passer tous les fichiers en révision ``3.0'' (y compris ceux qui n'ont pas été modifiés), lancer la commande suivante : .SP .in +1i .ft B .nf exemple% cvs commit -r3.0 .fi .ft P .in -1i .SP [b]cvs[/b] ne permettra le commit que sur une révision du tronc (révision ne comportant qu'un seul point). Il est cependant possible de commiter sur une branche (nombre pair de points) avec l'option [b][/b]-r. Pour créer une révision sur une branche, il faut utiliser l'option [b][/b]-b des commandes [b]rtag ou tag .[/b] D'une autre manière, [b]checkout ou update[/b] peut être utilisé pour que vos sources utilisent la branche créée. Une fois cette opération effectuée, tout [b]commit[/b] sur ces sources sera effectué sur la branche, de manière à ne pas perturber le développement sur la branche principale. Par exemple, si vous devez créer un patch pour la version 1.2 d'un produit, alors que la version 2.0 est en cours de développement, faites comme suit : .SP .in +1i .ft B .nf exemple% cvs rtag -b -rFCS1_2 FCS1_2_Patch module_produit exemple% cvs checkout -rFCS1_2_Patch module_produit exemple% cd module_produit [[ modifications diverses ]] exemple% cvs commit .fi .ft P .in -1i .SP Supposons que vous travaillez sur une version expérimentale du produit, ayant pour base une révision (peu importe laquelle) extraite du référentiel la semaine précédente. Si d'autres personnes travaillent sur le produit avec vous, vous pouvez commiter vos changements sur une nouvelle branche afin de ne pas déranger le développement principal. Les autres personnes peuvent également récupérer vos modifications expérimentales et utiliser les algorithmes de résolution de conflit de [b]cvs[/b]. Voici le scénario tel qu'il pourrait être : .SP .in +1i .ft B .nf exemple% cvs tag -b EXPR1 exemple% cvs update -rEXPR1 [[ modifications diverses ]] exemple% cvs commit .fi .ft P .in -1i .SP Les autres personnes lancent la commande .` "cvs checkout -rEXPR1 un_module" pour travailler avec vos modifications expérimentales.[/col][/row][/table] [table][row][col]    [/col][col][b]diff[/b] [[b][/b]-kl] [[i]rcsoptions_du_diff[/i]] [[[b][/b]-r [i]rev1[/i] \| [b][/b]-D [i]date1[/i]] [[b][/b]-r [i]rev2[/i] \| [b][/b]-D [i]date2[/i]]] [[i]fichiers.[/i]..] [i]Nécessite :[/i] répertoire de travail, référentiel. [b][/b] [i]Modifie :[/i] rien. [b][/b] Vous pouvez comparer vos fichiers de travail avec d'autres révisions dans le référentiel avec la commande .` "cvs diff" . Si vous ne spécifiez pas une révision, les fichiers sont comparés avec la révision sur laquelle ils sont basés. Vous pouvez utiliser l'option [b]-r[/b] pour spécifier la révision avec laquelle vous voulez comparer vos fichiers. Si vous utilisez l'option [b]-r[/b] deux fois dans la commande, vous pouvez voir les différences entre deux révisions dans le référentiel. Il est possible de spécifier l'option [b]-D[/b] pour voir les différences avec une révision dans le passé. Les options [b][/b]-r et [b][/b]-D peuvent être mélangés avec toujours deux options au plus. Vous pouvez vous référencer à [b]rcsdiff ( 1 )[/b] pour la liste complète des options reconnues. .SP Si vous ne spécifiez pas de fichiers, [b]diff[/b] affiche les différences de tous les fichiers dans le répertoire courant (et ses sous-répertoires, sauf si l'option [b]-l [/b] est spécifiée) par rapport à leur révision correspondante dans le référentiel (c'est-à-dire tous les fichiers que vous avez modifiés), ou dont la révision est différente.[/col][/row][/table] [table][row][col]    [/col][col][b]export[/b] [-[b]f[/b]lNnQq] [b][/b]-r [i]rev[/i]\|[b][/b]-D [i]date[/i] [[b][/b]-d [i]répertoire[/i]] [[b][/b]-k [i]kdrapeau[/i]] [i]module[/i]... [i]Nécessite :[/i] référentiel. [b][/b] [i]Modifie :[/i] répertoire de travail. [b][/b] Cette commande est une variante de la commande .` "cvs checkout"; à utiliser lorsque vous désirez récupérer les sources d'un [i]module[/i] sans les fichiers administratifs de [b]cvs[/b]. Cette commande est notamment utilisée lorsque vous voulez préparer des sources pour une livraison. Cette commande nécessite de préciser une date ou un marqueur (à l'aide des options [b][/b]-D ou [b][/b]-r), de manière à pouvoir reproduire le rapatriement des sources. .SP Les seules options non standard sont : .` "-d [i]dir[/i]" (écrit les sources dans le répertoire [i]rép[/i]) et .` "-N" (n'abrège pas les chemins du module). Les options suivantes ont la même signification que pour la commande .` "cvs checkout". .SP L'option [b]-kv[/b] est utile lors d'un [b]export[/b] Les mots-clés sont étendus de manière à ce qu'un [b]import[/b] sur un autre site ne perde pas les informations de révision. D'autres fiKflags peuvent être utilisés avec .` "cvs export" et sont décrits dans [b]co ( 1 ).[/b][/col][/row][/table] [table][row][col]    [/col][col][b]history[/b] [[b][/b]-[i]rapport[/i]] [[b][/b]-[i]drapeaux[/i]] [[b][/b]-[i]options[/i] args] [[i]fichiers[/i]...] [i]Nécessite :[/i] le fichier .` "$CVSROOT/CVSROOT/history" [b][/b] [i]Modifie :[/i] rien. [b][/b] [b]cvs[/b] conserve un historique de toutes les commandes [b]checkout[/b], [b]commit[/b], [b]rtag[/b], [b]update[/b], et [b]release[/b] La commande .` "cvs history" est utilisée pour afficher ces informations dans différents formats. .SP [i]Avertissement :[/i] .` "cvs history" utilise les options .` "-f", .` "-l", .` "-n", et .` "-p" d'une manière différente de celle décrite dans la section [size=6][/size] OPTIONS DES COMMANDES c &. .SP Certaines options (indiquées ci-dessous comme [b][/b]-[i]report[/i]) controlent quel type de rapport est généré :[/col][/row][/table] [b] -c[/b] [table][row][col]    [/col][col]Affiche tous les [b]commit[/b] (c'est-à-dire chaque fois que le référentiel a été modifié).[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -m [i]module[/i] Rapport sur un [i]module[/i] spécifique. Il est possible d'utiliser plusieurs fois l'option [b][/b]-m dans une commande.[/col][/row][/table] [b] -o[/b] [table][row][col]    [/col][col]Rapport sur les check-out.[/col][/row][/table] [b] -T[/b] [table][row][col]    [/col][col]Rapport sur les marqueurs.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -x [i]type[/i] Extrait un type particulier [i]X[/i] de fichiers de l'historique [b]cvs[/b]. Les types sont indiqués par une lettre. Plusieurs lettres peuvent être indiquées. Certaines commandes ont un type unique : [b]checkout[/b] (type `O'), [b]release[/b] (type `F'), et [b]rtag[/b] (type `T'). Un de ces quatre types peuvent résulter d'un [b]update[/b] : `W', lorsque le fichier dans le répertoire de travail est supprimé durant une mise à jour (car il n'était plus dans le référentiel) ; `U' lorsque le fichier dans le répertoire de travail a été copié depuis le référentiel ; `G' lorsqu'une fusion était nécessaire et qu'elle a réussi ; `C' lorsqu'une fusion était nécessaire mais que des collisions ont été détectées (nécessitant donc une fusion manuelle). Enfin, un de ces trois types résultant d'un [b]commit[/b] : `M' lorsqu'un fichier était modifié ; `A' lorsqu'un fichier est ajouté pour la première fois ; et `R' lorsqu'un fichier est supprimé.[/col][/row][/table] [b] -e[/b] [table][row][col]    [/col][col]Tous les types de fichier ; équivalent à .` "-xMACFROGWUT".[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -z [i]zone[/i] Utiliser le fuseau horaire [i]fuseau lors de l'affichage de l'historique.[/i] Le fuseau horaire [b]LT[/b] représente le fuseau horaire local ; un nombre positif ou négatif représente les heures et minutes en avance de l'UTC. Par exemple, [b]+0530[/b] signifie 5 heures et 30 minutes en avance sur l'UTC (c'est-à-dire vers l'est).[/col][/row][/table] [table][row][col]    [/col][col] Les options [b][/b]-[i]flags[/i] modifient le rapport sans nécessiter d'arguments aux options :[/col][/row][/table] [b] -a[/b] [table][row][col]    [/col][col]Affiche les données de tous les utilisateurs (par défaut, seules les données de l'utilisateur exécutant la commande .` "cvs history" sont affichées).[/col][/row][/table] [b] -l[/b] [table][row][col]    [/col][col]N'affiche que la dernière modification.[/col][/row][/table] [b] -w[/b] [table][row][col]    [/col][col]N'affiche que les modifications des fichiers dans le même répertoire que celui dans lequel est exécuté la commande .` "cvs history" .[/col][/row][/table] [table][row][col]    [/col][col] Les options [b][/b]-[i]options[/i] args modifient le rapport et nécessitent un ou plusieurs arguments :[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -b [i]chaine[/i] N'affiche les données que des entrées contenant la chaîne [i]chaine[/i] soit dans le nom du module, le nom du fichier ou le chemin du référentiel.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -D [i]date[/i] N'affiche que les données depuis [i]date[/i].[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -p [i]repository[/i] N'affiche que les données d'un référentiel spécifique (il est possible d'utiliser plusieurs fois l'option [b][/b]-p dans une ligne de commande).[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -r [i]rev[/i] N'affiche les données postérieures à la révision ou au marqueur [i]rev[/i] sur chaque fichier RCS.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -t [i]tag[/i] N'affiche les données qu'à partir du moment où [i]marqueur[/i] a pour la dernière fois été ajouté dans le fichier history. À la différence de [b][/b]-r ci-dessus, seul le fichier history est parcouru et non chaque fichier RCS. La commande est par conséquent bien plus rapide.[/col][/row][/table] [table][row][col]    [/col][col][b][/b] -u [i]nom[/i] N'affiche que les données de l'utilisateur [i]nom[/i].[/col][/row][/table] [table][row][col]    [/col][col][b]import[/b] [[b][/b]-[i]options[/i]] [i]repository[/i] vendortag releasetag... [i]Nécessite :[/i] Référentiel, répertoire contenant les sources à importer. [b][/b] [i]Modifie :[/i] référentiel. [b][/b] Utilisez .` "cvs import" pour créer un module complet à partir d'une source extérieure. Vous pouvez utiliser cette commande à la fois pour la création initiale d'un référentiel, et pour intégrer des mises à jour d'un module. .SP L'argument [i]référentiel[/i] est le nom d'un répertoire (ou le chemin vers un répertoire) sous le répertoire racine CVS ; si le répertoire n'existe pas, l'[b]import[/b] le crée. .SP Lorsque vous utilisez [b]import[/b] pour mettre à jour une source qui a été modifiée dans le référentiel source (depuis un [b]import[/b] précédent), celui-ci vous informe des fichiers en conflit dans les deux branches de développement ; utilisez .` "cvs checkout -j" pour fusionner les différences ([b]import[/b] vous le signalera). .SP Par défaut, certains fichiers sont ignorés durant un .` "cvs import" : les noms des fichiers d'administration [size=6]CVS ,[/size] ou d'autres systèmes de gestion de version ; le noms de fichiers classiques pour les patch, les fichiers objets, les archives et les fichiers de sauvegarde des éditeurs de texte ; les noms de fichiers couramment utilisés pour ###. Pour connaître les noms de fichiers ignorés, consultez le Cederqvist (voir dans la section VOIR AUSSI de cette page de manuel). .SP Les fichiers sont enregistrés dans une branche, par défaut .` "1.1.1". Les mises à jour sont des feuilles de cette branche ; par exemple, les fichiers d'un premier import auront comme révision .` "1.1.1.1", et les fichiers modifiés depuis le premier import auront comme révision .` "1.1.1.2", etc. .SP Au moins 3 arguments sont nécessaires. [i]référentiel[/i] est nécessaire pour identifier la collection de source. [i]vendortag[/i] est un marqueur pour la branche (c'est-à-dire pour .` "1.1.1"). Vous devez également préciser au moins un [i]releasetag[/i] pour identifier les fichiers créés à chaque import. .SP Une des options standard de la commande [b]cvs[/b] est disponible : [b][/b]-m. Si vous ne précisez pas de message, un éditeur de texte sera appelé (comme pour un [b]commit[/b]) pour permettre la saisie d'un message. .SP Il existe trois options spéciales. .SP .` "-d" pour utiliser les dates de dernière modification de chaque fichier comme date de checkin. .SP .` "-b [i]branche[/i]" pour utiliser une autre branche que .` "1.1.1". .SP .` "-I [i]name[/i]" pour préciser les noms de fichiers à ignorer durant l'[b]import[/b]. Vous pouvez utiliser plusieurs fois cette option dans une même ligne de commande. Pour qu'aucun fichier ne soit ignoré (y compris ceux ignorés par défaut), utilisez l'option .` "-I !".[/col][/row][/table] [table][row][col]    [/col][col][b]log[/b] [[b][/b]-l] [i]roptions_log[/i] [fichiers...] [i]Nécessite :[/i] référentiel, répertoire de travail. [b][/b] [i]Modifie :[/i] rien. [b][/b] [i]Synonyme:[/i] [b]rlog[/b] [b][/b] Affiche les messages d'informations d'un ou plusieurs [i]fichiers[/i]. Les options les plus utilisées sont [b][/b]-h pour n'afficher que l'en-tête (y compris la liste des marqueurs, et sans la liste complète des informations) ; [b][/b]-r pour choisir les informations d'une révision spécifique (ou d'une plage de révisions) ; [b][/b]-d pour choisir une date ou une période. Voir [b]rlog ( 1 )[/b] pour de plus amples renseignements. Cette commande est récursive par défaut, sauf si l'option [b][/b]-l est précisée.[/col][/row][/table] [table][row][col]    [/col][col][b]rdiff[/b] [[b][/b]-[i]flags[/i]] [[b][/b]-V [i]vn[/i]] [[b][/b]-r [i]t[/i]\|[b][/b]-D [i]d[/i] [[b][/b]-r [i]t2[/i]\|[b][/b]-D [i]d2[/i]]] [i]modules[/i]... [i]Nécessite :[/i] référentiel. [b][/b] [i]Modifie :[/i] rien. [b][/b] [i]Synonyme :[/i] [b]patch[/b] [b][/b] Crée un [b]patch ( 1 )[/b] au format Larry Wall entre deux releases, pouvant être envoyé directement au programme [b]patch[/b] pour passer d'une ancienne version à la dernière. C'est une des rares commandes [b]cvs[/b] travaillant directement sur le référentiel et ne nécessitant pas un checkout préliminaire). Le diff est envoyé vers la sortie standard. Il est possible d'utiliser n'importe quelle combinaison d'une ou deux révisions ou dates (avec les options [b][/b]-r et [b][/b]-D). Si seule une révision ou une date est fournie, le fichier créé contient le diff entre la révision ou date donnée et la révision HEAD de chaque fichier. .SP Noter que si les releases se font dans plusieurs répertoires différents, il est nécessaire d'utiliser l'option [b][/b]-p de la commande [b]patch[/b] pour patcher les anciens sources. .SP Les options standard [i]flags[/i], [b][/b]-f et [b][/b]-l sont disponibles pour cette commande. Il existe également plusieurs options spéciales : .SP Avec l'option [b][/b]-s, le patch n'est pas généré. À la place, un résumé des fichiers modifiés/ajoutés/supprimés est envoyé vers la sortie standard. Cette option est utilisée pour déterminer quels ont été les fichiers modifiés entre deux dates ou révisions. .SP Avec l'option [b][/b]-t, un diff entre les deux dernières révisions du tronc sont envoyées sur la sortie standard. Utile pour déterminer quelle a été la dernière modification sur un fichier. .SP Avec l'option [b][/b]-u, le patch est sous forme « unidiff » (diff contextuel). .SP Il est possible d'utiliser l'option [b][/b]-c pour obtenir les diffs contextuels au format .` "diff -c" (format par défaut).[/col][/row][/table] [table][row][col]    [/col][col][b]release[/b] [[b][/b]-dQq] [i]modules[/i]... [i]Nécessite :[/i] répertoire de travail. [b][/b] [i]Modifie :[/i] répertoire de travail, historique [b][/b] Cette commande est destinée à annuler un .` "cvs checkout' de manière sure. Étant donné que [b]cvs[/b] ne verrouille pas les fichiers, il n'est pas indispensable de lancer cette commande. Il est en effet possible de ne supprimer que votre répertoire de travail ; vous courrez par contre le risque de perdre des modifications que vous auriez pu effectuer, et vous perdez toute trace dans l'historique que vous avez abandonné vos changements. .SP Pour éviter ces problèmes, la commande .` "cvs release" vérifie qu'aucun fichier n'est pas en attente de commit ; que vous exécutez cette commande dans un répertoire de travail [b]cvs[/b] ou juste un cran au-dessus ; que le référentiel pour vos fichiers est bien le même que celui défini dans la base de données des modules. .SP Si toutes ces conditions sont vraies, .` "cvs release" crée un entrée dans l'historique attestant que le checkout a été abandonné. .SP Il est possible d'utiliser l'option [b][/b]-d pour demander la suppression des fichiers sources si la commande [b]release[/b] se termine sans erreur.[/col][/row][/table] [table][row][col]    [/col][col][b]remove[/b] [[b][/b]-lR] [[i]files[/i]...] [i]Nécessite :[/i] répertoire de travail. [b][/b] [i]Modifie :[/i] répertoire de travail. [b][/b] [i]Synonymes:[/i] [b]rm , delete[/b] [b][/b] Utilisez cette commande lorsque vous souhaitez supprimer un ou des [i]fichiers[/i] du référentiel. Comme la plupart des commandes [b]cvs[/b], .` "cvs remove" travaille sur les fichiers de votre répertoire de travail, et non pas directement sur le référentiel. De plus, il est nécessaire que les fichiers spécifiés soient préalablement supprimés du répertoire de travail. .SP Les fichiers ne sont réellement supprimés que lors de l'appel de la commande [b]commit ;[/b] une fois cette commande lancée, les fichiers [size=6]RCS[/size] dans le référentiel sont [i]déplacés[/i] dans le répertoire .` "Attic" (se trouvant également dans le référentiel). .SP Cette commande est récursive par défaut. Elle cherche tous les fichiers supprimés et les marque comme étant à supprimés au prochain [b]commit .[/b] Utilisez l'option [b][/b]-l pour ne pas utiliser la récursivité. Vous pouvez sinon précisez la liste des fichiers à supprimer.[/col][/row][/table] [table][row][col]    [/col][col][b]rtag[/b] [[b][/b]-falnRQq] [[b][/b]-b] [[b][/b]-d] [[b][/b]-r [i]tag[/i] \| [b][/b]-D [i]date[/i]] [i]symbolic_tag[/i] [i]modules[/i]... [i]Nécessite :[/i] référentiel. [b][/b] [i]Modifie :[/i] référentiel. [b][/b] [i]Synonyme :[/i] [b]rfreeze[/b] [b][/b] Cette commande est utilisée pour affecter un marqueur symbolique à certaines révisions de fichiers dans le référentiel. .` "cvs rtag" est utilisé directement sur le référentiel (et ne nécessite donc pas de [b]checkout ).[/b] Utiliser plutôt .` "cvs tag" pour poser des marqueurs sur des fichiers se trouvant dans votre répertoire de travail. .SP En général, les marqueurs (bien souvent les noms de version d'un logiciel) ne sont jamais supprimés. Cependant, l'option [b][/b]-d peut être utilisée pour supprimer des noms de marqueur obsolètes (comme celui d'une version alpha par exemple). .SP .` "cvs rtag" ne déplace pas un marqueur existant. Avec l'option [b][/b]-F, .` "cvs rtag" déplace une instance de [i]marqueur_symbolique[/i] existant déjà sur un fichier vers une autre révision. Sans l'option [b][/b]-F, cette commande produit un message d'erreur. .SP L'option [b][/b]-b crée un marqueur de branche, permettant le développement de manière isolée. Ceci est utile pour créer un correctif d'une ancienne version d'un logiciel. .SP Vous pouvez utiliser les options [b][/b]-r et [b][/b]-D pour ne poser de marqueurs que sur les fichiers contenant déjà un marqueur spécifique. Cette méthode est utilisée pour renommer un marqueur : poser un marqueur sur les fichiers identifiés par l'ancien marqueur, puis supprimer l'ancien marqueur en laissant le nouveau marqueur sur les mêmes fichiers que ceux de l'ancien marqueur. .SP [b]rtag[/b] est récursif par défaut, et pose un marqueur sur tous les sous-répertoires du [i]module[/i] spécifié en argument. Il est possible de restreindre le marqueur aux répertoires de plus haut niveau avec l'option [b][/b]-l. Il est également possible de préciser la récursivité par défaut avec l'option [b][/b]-R. .SP La base de données des modules peut spécifier un programme à exécuter lorsqu'un marqueur est posé ; un cas typique est l'envoi de courriel aux utilisateurs intéressés. Si vous ne voulez pas lancer le programme, utilisez l'option [b][/b]-n. .SP Utilisez l'option [b][/b]-a pour rechercher les fichiers contenant le marqueur spécifié dans les sous-répertoires « Attic ». Ce marqueur est supprimé, ce qui est utile pour réutiliser un marqueur symbolique lorsque le développement continue (et que les fichiers sont supprimés des versions à venir).[/col][/row][/table] [table][row][col]    [/col][col][b]status[/b] [[b][/b]-lRqQ] [[b][/b]-v] [[i]fichiers[/i]...] [i]Nécessite :[/i] répertoire de travail, référentiel. [b][/b] [i]Modifie :[/i] rien. [b][/b] Affiche un court rapport sur le statut actuel du ou des [i]fichiers[/i] du référentiel, y compris les marqueurs « collants », dates et options [b][/b]-k (les options « collantes » modifient la manière dont la commande .` "cvs update" opère jusqu'à ce qu'ils soient réinitialisés ; voir la description de la commande .` "cvs update -A...".) .SP Vous pouvez utiliser cette commande pour évaluer l'impact d'un .` "cvs update" sur le répertoire de travail. Si vous ne précisez pas de [i]fichiers[/i], le rapport est effectué pour les fichiers gérés par [b]cvs[/b] dans votre répertoire de travail. Il est possible de limiter le rapport uniquement aux fichiers du répertoire courant (sans les sous-répertoires) avec l'option standard [b][/b]-l ; l'option [b][/b]-R demande explicitement la récursivité. .SP L'option [b][/b]-v affiche les marqueurs symboliques des fichiers [size=6]RCS .[/size][/col][/row][/table] [table][row][col]    [/col][col][b]tag[/b] [[b][/b]-lQqR] [[b][/b]-F] [[b][/b]-b] [[b][/b]-d] [[b][/b]-r [i]tag[/i] \| [b][/b]-D [i]date[/i]] [[b][/b]-f] [i]symbolic_tag[/i] [[i]files[/i]...] [i]Nécessite :[/i] répertoire de travail, référentiel. [b][/b] [i]Modifie :[/i] référentiel. [b][/b] [i]Synonyme :[/i] [b]freeze[/b] [b][/b] Utilisez cette commande pour assigner un marqueur symbolique à la révision la plus proche des fichiers de votre répertoire de travail. Les marqueurs sont appliqués immédiatement, comme avec la commande [b]rtag[/b]. .SP Une utilisation de ces tags est de marquer un instantané des sources utilisés lors d'un freeze. Quand des correctifs sont appliqués après cette date, seuls les fichiers modifiés doivent être marqués à nouveau. .SP Les marqueurs symboliques sont utiles pour garder une trace de quelle révision de quels fichiers sont utilisées lors d'une release. Les commandes [b]checkout ,[/b] [b]export[/b] et [b]update[/b] permettent l'extraction d'une copie exacte d'une release marquée, même si des fichiers ont été ajoutés, modifiés ou supprimés depuis la release. .SP Il est possible d'utiliser les options standards [b][/b]-r et [b][/b]-D pour ne marquer que les fichiers contenant déjà un certain marqueur. Cette méthode est utilisée pour renommer un marqueur : pour cela, ne marquer que les fichiers contenant déjà un certain marqueur puis supprimer l'ancien marqueur. .SP En utilisant en plus l'option [b][/b]-f en plus [b]-r[/b] ou [b][/b]-D, on ne marque que les fichiers sur la ligne de commande, même s'ils ne contiennent pas le marqueur spécifié ou n'existaient pas à la date fournie. .SP Par défaut (sans l'option [b][/b]-r ou [b][/b]-D), les versions à marquer sont fournies implicitement par les enregistrements [b]cvs[/b] de l'hitorique de vos fichiers de travail plutôt qu'appliquées explicitement. .SP Si vous utilisez .` "cvs tag -d [i]symbolic_tag[/i]...", le marqueur symbolique est [i]supprimé[/i] et non ajouté. [i]Attention[/i] : soyez sur de ce que vous faites lorsque vous supprimez un marqueur ; certaines informations importantes peuvent être supprimées. .SP .` "cvs tag" ne déplace pas un marqueur déjà existant. Avec l'option [b][/b]-F, .` "cvs tag" déplace une instance d'un [i]marqueur_symbolique[/i] existant déjà vers une autre révision. Sans cette option [b][/b]-F, l'utilisation de .` "cvs tag" pour appliquer un marqueur déjà existant sur un fichier produit un message d'erreur. .SP L'option [b][/b]-b, crée un marqueur de « branche », permettant le développement isolé. Ceci est utile pour créer un correctif sur une release ancienne. .SP Normalement, [b]tag[/b] s'exécute de manière récursive ; il est possible d'utiliser l'option standard [b][/b]-l pour annuler cette récursivité, ou préciser explicitement la récursivité avec l'option [b][/b]-R.[/col][/row][/table] [table][row][col]    [/col][col][b]update[/b] [[b][/b]-ACdflPpQqR] [[b][/b]-d] [[b][/b]-r [i]tag[/i]\|[b][/b]-D [i]date[/i]] [i]files[/i]... [i]Nécessite :[/i] référentiel, répertoire de travail. [b][/b] [i]Modifie :[/i] répertoire de travail. [b][/b] Après avoir lancé une commande [b]checkout[/b] pour créer une copie personnelle des sources d'un référentiel, les autres développeurs continuent à modifier ce référentiel. De temps à autre, il est nécessaire de remettre en phase les données du référentiel avec le répertoire de travail avec la commande [b]update[/b]. .SP [b]update[/b] affiche tout ce qui est effectué au fur et à mesure de la progression, avec une ligne par fichier précédé d'un des caractères .` "U A R M C ?" indiquant le statut du fichier :[/col][/row][/table] [table][row][col]    [/col][col][b]U[/b] [i]fichier[/i] Ce fichier a été [i]mis[/i] à jour avec le référentiel. Ceci est effectué pour tout fichier existant dans le référentiel mais pas dans le répertoire de travail, ainsi que pour tout fichier dont une révision plus récente existe dans le référentiel et dont la copie locale n'a pas été modifiée.[/col][/row][/table] [table][row][col]    [/col][col][b]A[/b] [i]fichier[/i] Ce fichier a été ajouté dans le répertoire de travail, et sera ajouté dans le référentiel lors du prochain .` "cvs commit" sur ce fichier.[/col][/row][/table] [table][row][col]    [/col][col][b]R[/b] [i]fichier[/i] Ce fichier a été [i]supprimé[/i] dans le répertoire de travail et sera supprimé du référentiel lors du prochain .` "cvs commit"[/col][/row][/table] [table][row][col]    [/col][col][b]M[/b] [i]fichier[/i] Ce fichier a été [i]modifié[/i] dans le répertoire de travail. .` "M" peut indiquer deux possibilités : soit le fichier n'a subi aucune modification dans le référentiel, et dans ce cas il reste inchangé ; soit le fichier a été modifié dans le référentiel et ces modifications ont été fusionnées avec succès dans la copie locale.[/col][/row][/table] [table][row][col]    [/col][col][b]C[/b] [i]fichier[/i] Un [i]conflit[/i] a été détecté lors de la fusion des modifications d'un [i]fichier[/i] avec la révision actuellement dans le référentiel. Le [i]fichier[/i] est maintenant le résultat de la fusion des deux versions ; une version non modifiée du fichier est enregistrée dans le répertoire de travail, avec pour nom `[b].#[/b][i]fichier[/i][b].[/b][i]version[/i]', où [i]version[/i] est la révision à partir de laquelle les modifications ont été effectuées. Il faut bien noter que certains systèmes suppriment automatiquement les noms de fichier commençant par & .` ".#" si personne n'y a accédé durant plusieurs jours. Si vous désirez conserver une copie de ce fichier, il est bon de renommer ce fichier.[/col][/row][/table] [table][row][col]    [/col][col][b]?[/b] [i]fichier[/i] Ce [i]fichier[/i] est dans votre répertoire de travail, mais ne correspond à rien dans le référentiel, et ne se trouve pas dans la liste des fichiers à ignorer (voir la description de l'option [b][/b]-I).[/col][/row][/table] [table][row][col]    [/col][col] .SP Utilisez l'option [b][/b]-A pour réinitialiser les marqueurs collants, dates ou options [b][/b]-k (si vous avez récupéré certains fichiers avec l'une des options [b][/b]-r, [b][/b]-D, ou [b][/b]-k, [b]cvs[/b] continue à utiliser ces marqueurs pour les mises à jour ultérieures ; utilisez l'option [b][/b]-A pour que [b]cvs[/b] oublie ces options, et récupère la version HEAD du fichier). .SP L'option [b][/b]-j[i]branche[/i] fusionne les modifications effectuées sur une branche par rapport à la révision sur laquelle la branche est basée. .SP Avec deux options [b]-j[/b], [b]cvs[/b] fusionne les modifications entre deux révisions spécifiques. Ceci peut être utilisé pour supprimer un delta d'un fichier. Par exemple, si le fichier truc.c est en révision 1.6 et que vous souhaitez supprimer les modifications effectuées entre les révisions 1.3 et 1.5, vous pouvez lancer : .in +1i .ft B .nf exemple% cvs update -j1.5 -j1.3 foo.c # attention à l'ordre... .fi .ft P .in -1i .SP De plus, chaque option [b]-j[/b] peut contenir un date, qui lorsqu'elle est utilisée avec une branche, peut limiter le choix de la révision à une certaine date. Une date est précisée en ajoutant deux points (:) au marqueur. .SP .in +1i .ft B .nf -jSymbolic_Tag:Date_Specifier .fi .ft P .in -1i .SP Utilisez l'option [b][/b]-d pour créer les sous-répertoires existant dans le référentiel mais pas dans votre répertoire de travail (les mises à jour ne se font en temps normal que sur les fichiers et répertoires déjà présents). Ceci est utile pour créer les sous-répertoire créés après le checkout initial ; il y a cependant un effet de bord. Si vous avez délibérément omis certains répertoires du référentiel lors de la création du répertoire de travail (en utilisant un nom de module ou en donnant explicitement la liste des fichiers à ignorer), la mise à jour avec l'option [b][/b]-d créera ces répertoires, ce que vous ne voulez pas forcément. .SP Utilisez l'option [b][/b]-I [i]nom[/i] pour ignoner des fichiers dont le nom correspond à [i]nom[/i] (dans votre répertoire de travail) durant l'update. Il est possible d'utiliser plusieurs fois l'option [b][/b]-I dans une même ligne de commande. Par défaut, [b]update[/b] ignore certains fichiers (pour une liste à jour de ces noms, se reporter au Cederqvist). .SP Utilisez .` "-I !" pour n'ignorer aucun fichier. .SP Utilisez l'option .` "-C" pour écraser la copie locale avec la copie propre du référentiel (le fichier modifié est sauvegardé sous le nom `[b].#[/b][i]fichier[/i][b].[/b][i]revision[/i]'). .SP Les options standard [b][/b]-f, [b][/b]-k, [b][/b]-l, [b][/b]-P, [b][/b]-p, and [b][/b]-r sont également disponibles avec la commande [b]update[/b].[/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] Pour de plus amples renseignements sur les fichiers
Fichier