Utilisation de correctifs
Les correctifs permettent aux développeurs de partager leur travail sans le stocker dans un référentiel.
Cela est utile lorsqu'un développeur souhaite contribuer à un projet qui est partagé via un référentiel auquel il n'a pas accès en écriture. Dans ce cas, le développeur peut créer un correctif et l'envoyer par courrier électronique à un développeur disposant de droits d'accès en écriture ou le rattacher à un bogue dans le système de génération de rapports de bogues utilisé par le projet, en fonction du processus défini par le projet. Le développeur qui dispose de droits d'accès en écriture peut ensuite appliquer le correctif au projet et valider les modifications.
Pour créer un correctif à partir d'un projet CVS, procédez comme suit :
- Sélectionnez la ressource qui contient les modifications à inclure dans le correctif. Vous pouvez sélectionner les ressources qui résident dans plusieurs projets et à n'importe quel emplacement dans la mesure où, l'assistant Création d'un correctif, lorsqu'il est exécuté dans son mode par défaut, sait comment créer un correctif multi-projets. Le correctif doit également être appliqué aux mêmes révisions de fichier dans lesquelles il est généré ; des mesures nécessaires doivent donc être prises pour garantir que le correctif est appliqué au même éventail de ressources (pour cela, la procédure la plus simple consiste à créer le correctif à partir d'une version).
- Dans le menu en incrustation, sélectionnez Equipe > Création d'un correctif.... L'assistant de création de correctif s'affiche.
- Choisissez l'emplacement dans lequel le correctif doit être sauvegardé :
- Sauvegarder dans le presse-papiers - Cette option permet de placer le correctif dans le presse-papiers de sorte qu'il puisse être collé dans un éditeur de texte, tel qu'un programme de courrier électronique.
- Sauvegarder dans le système de fichiers - Cette option permet de placer le correctif dans le fichier indiqué du système de fichiers local.
- Sauvegarder dans l'espace de travail - Cette option permet de placer le correctif dans un des projets existants du plan de travail.
Pour les petits correctifs, il est peut-être raisonnable de transférer le correctif à l'aide du presse-papiers mais, dans la plupart des cas, il est préférable d'utiliser le système de fichiers local.
- Vous pouvez afficher et ajuster le choix de votre correctif en développant l'arborescence des ressources présentée dans la sous-fenêtre Modifications. Seuls les éléments cochés seront inclus dans le correctif. Cliquez sur Suivant pour configurer la façon dont le correctif est généré.
- Choisissez le mode de configuration du correctif :
- Format de sortie diff - Cette option permet de choisir entre plusieurs formats de sortie diff standard. Unifié est le format utilisé par la plupart des outils d'application de correctif, y compris Eclipse.
- Racine du correctif - Cette option permet d'indiquer à quel niveau votre correctif réside. Les choix possibles sont Espace de travail, Projet et Sélection.
Espace de travail vous permet d'inclure les ressources de plusieurs projets dans votre correctif et constitue l'option par défaut. Les correctifs de l'espace de travail peuvent être appliqués à n'importe quelle ressource dans l'espace de travail. Ils contiennent suffisamment d'informations pour permettre à l'assistant Application de correctif d'identifier les ressources à corriger.
Les correctifs Projet résident au niveau du projet. Ils ne peuvent donc contenir que des ressources issues d'un projet et doivent être appliqués au même projet.
Les correctifs Sélection résident au niveau d'une ressource sélectionnée et doivent être appliqués à la même ressource.
- Cliquez sur Terminer.
- Transférez le correctif, si nécessaire, pour le projet qui est en cours de correction.
Pour appliquer un correctif :
- Sélectionnez la ressource sur laquelle le correctif a été généré. Cette ressource doit contenir les mêmes révisions de fichier que l'éventail sur lequel le correctif a été généré.
- Dans le menu en incrustation, sélectionnez Equipe > Appliquer un correctif.... L'assistant Module de correction de ressource s'affiche.
- Indiquez l'emplacement du correctif :
- Fichier - le correctif se trouve dans un fichier du système de fichiers local. Tapez le chemin d'accès complet au fichier ou cliquez sur le bouton Parcourir... pour rechercher le fichier.
- Presse-papiers - le correctif se trouve dans le presse-papiers. Avertissement : Il est plus prudent d'utiliser un correctif de fichier. Les fins de ligne risquent de ne pas être traitées correctement si le presse-papiers est utilisé et que le correctif a été généré sur une plateforme différente (par exemple, entre Linux et Windows).
- Espace de travail - le correctif a été sauvegardé quelque part dans l'espace de travail.
Cliquez sur Suivant pour voir le résultat de l'application du correctif.
-
Etape facultative : cette étape s'applique uniquement si vous votre correctif réside au niveau du projet ou de la sélection, les correctifs résidant dans l'espace de travail lanceront automatiquement la page d'aperçu du correctif. Dans la page Spécification cible de correctif, vous devez sélectionner la ressource devant représenter la racine du correctif.
- La page d'aperçu du correctif indique si le correctif a été appliqué correctement aux fichiers de l'espace de travail. La sous-fenêtre supérieure affiche la liste des modifications contenues dans votre correctif.
Si un élément feuille est sélectionné dans l'arborescence, la sous-fenêtre inférieure affiche la partie du fichier correctif (connue sous le nom de 'hunk' dans la terminologie des correctifs) selon une présentation côte à côte facilement lisible. Remarque : La sous-fenêtre inférieure n'affiche pas d'aperçu sur la façon dont les ressources de votre espace de travail se présentent une fois le hunk appliqué.
Elle affiche uniquement le contenu du fichier correctif.
-
Si un élément est coché, cela signifie qu'un correctif (ou un hunk) peut être appliqué correctement à une ressource d'espace de travail.
Vous pouvez exclure des correctifs ou des hunks individuels en les désélectionnant.
-
Un point d'exclamation rouge indique qu'un incident s'est produit au niveau d'un correctif ou d'un hunk.
C'est le cas si le correctif n'est pas syntaxiquement correct ou si la révision d'un ou plusieurs fichiers sur lesquels le correctif a été généré ne correspond pas aux révisions auxquelles le correctif est appliqué.
La cause de l'incident se trouve entre parenthèses.
Pour appliquer correctement la totalité du correctif, vous devez éliminer les incidents (points d'exclamation rouges) et cocher les éléments partout en affinant les options de cette page d'assistant (voir 'Options' ci-dessous).
- Si tout fonctionne correctement, cliquez sur Fin pour appliquer le correctif. L'espace de travail contient à présent des modifications sortantes pour chaque fichier modifié par le correctif.
Options d'application d'un correctif
Pour obtenir des correspondances correctes du fichier correctif, vous pouvez procéder de l'une des manières suivantes :
-
Revenez dans la première page de l'assistant Module de correction de ressource et sélectionnez la ressource correcte à laquelle le correctif doit être appliqué.
-
Si un préfixe courant des noms de chemin stockés dans le fichier correctif ne correspond pas aux noms de chemin de l'espace de travail en cours, vous pouvez utiliser l'option 'Ignorer le début du nom de chemin'.
-
Utilisez l'option 'Ignorer les espaces' pour que le processus de correspondance soit indépendant des différences d'espace entre le fichier correctif et les fichiers de votre espace de travail.
-
Ajustez le 'Facteur d'imprécision maximal' (terminologie des correctifs).
Ce facteur détermine combien de lignes situées entre le haut et le bas du contexte seront ignorées lors de la recherche d'une correspondance. La valeur par défaut est 2.
-
Utilisez l'option 'Annuler les correctifs' pour les fichiers correctifs qui ont déjà été appliqués à l'espace de travail. Cette option permet également d'annuler ou de rétablir un correctif.
-
Dans le cas des correctifs de l'espace de travail, utilisez l'option 'Recibler le correctif' pour sélectionner un autre projet dans votre espace de travail auquel appliquer les modifications de correctif. Pour ce faire, sélectionnez un projet dans la sous-fenêtre supérieure et cliquez sur le bouton Recibler le correctif. Cette fenêtre lance une boîte de dialogue contenant la liste de tous les projets disponibles dans votre espace de travail. Sélectionnez un projet et cliquez sur OK. Les modifications apportées au correctif s'appliqueront au projet sélectionné.

Programmation en équipe avec CVS

Comparaison de ressources

CVS