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 :

1. 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).
2. Dans le menu en incrustation, sélectionnez Equipe > Création d'un correctif.... L'assistant de création de correctif s'affiche.
3. Choisissez l'emplacement dans lequel le correctif doit être sauvegardé :
   1. 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.
   2. Sauvegarder dans le système de fichiers - Cette option permet de placer le correctif dans le fichier indiqué du système de fichiers local.
   3. 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.
4. 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é.
5. Choisissez le mode de configuration du correctif :
   1. 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. Les formats Contexte et Unifié permettent d'appliquer un correctif, même si le numéro de ligne indiqué pour le hunk (terminologie des correctifs) est incorrect. Dans ce cas, lors de l'application du correctif, l'algorithme recherche dans les deux sens un ensemble de lignes correspondant au contexte indiqué pour le hunk.
   2. 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.
6. Cliquez sur Terminer.
7. Transférez le correctif, si nécessaire, pour le projet qui est en cours de correction.

Pour appliquer un correctif :

1. 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é.
2. Dans le menu en incrustation, sélectionnez Equipe > Appliquer un correctif.... L'assistant Application de correctif s'ouvre.
   
   Vous pouvez aussi l'ouvrir en copiant le contenu du correctif dans le presse-papiers puis en le collant directement dans la vue Explorateur de packages en sélectionnant Editer > Coller. Dans ce cas, vous pouvez ignorer l'étape suivante.
3. Indiquez l'emplacement du correctif :
   1. 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.
   2. 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).
   3. URL - le correctif se trouve à l'adresse URL donnée. Avertissement : assurez-vous d'entrer une adresse URL valide contenant un correctif approprié. Si tel n'est pas le cas, vous ne pourrez pas appliquer le correctif. De plus, n'oubliez pas que l'application d'un correctif directement à partir d'une adresse URL peut prendre du temps.
   4. 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.
4. Etape facultative : cette étape n'est valable que si votre correctif est à la racine au niveau du projet ou de la sélection ; les correctifs à la racine de l'espace de travail passent automatiquement à la page d'aperçu des correctifs. Dans la page Spécification cible de correctif, vous devez sélectionner la ressource devant représenter la racine du correctif.
5. La page d'aperçu des correctifs 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. Il y a deux types d'entrées dans la sous-fenêtre supérieure : les modifications de fichiers et les segments de correctifs non associés (appelés 'hunk' dans la terminologie des correctifs).
   1. Si un ou plusieurs segments de correctif peuvent être automatiquement appliqués au fichier, celui-ci sera affiché avec un indicateur de modification entrant. Vous pouvez consulter la modification en double cliquant sur le fichier.
   2. Si un ou plusieurs hunks ne peuvent être automatiquement appliqués, les entrées de hunk apparaîtront en tant qu'enfants du fichier dans la sous-fenêtre supérieure et un point d'exclamation indiquera qu'il y a un problème avec le correctif ou le hunk. Vous pouvez inspecter le hunk en double cliquant dessus. Vous pouvez ensuite appliquer manuellement le hunk à partir de la sous-fenêtre de droite sur le fichier à gauche. La sauvegarde depuis la sous-fenêtre de gauche mettra à jour l'entrée du fichier parent dans la sous-fenêtre supérieure mais ne modifiera pas le fichier sur le disque. Le fichier sur le disque n'est modifié que lorsque vous appuyez sur Terminer. Pour appliquer correctement la totalité du correctif, vous devez éliminer les incidents (les points d'exclamation rouges) soit en appliquant manuellement les segments de correctifs, en excluant le segment de correctif de l'opération en sélectionnant Supprimer du menu contextuel ou en affinant les options sur cette page de l'assistant (voir les 'Options' ci-dessous).
6. Si tout est correctement défini, cliquez sur Terminer pour appliquer le correctif. L'espace de travail contient à présent des modifications sortantes pour chaque fichier modifié par le correctif.

Vous pouvez appliquer les correctifs en les synchronisant avec le contenu local.

Pour procéder à la synchronisation avec un correctif :

1. Dans la perspective Synchronisation de l'équipe, sélectionnez l'action Synchroniser... dans la liste déroulante du bouton Synchroniser .
2. Sélectionnez Synchronisation avec le correctif dans la liste des types de synchronisation possibles et cliquez sur Suivant.
3. Indiquez l'emplacement du correctif :
   1. 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.
   2. 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).
   3. URL - le correctif se trouve à l'adresse URL donnée. Avertissement : assurez-vous d'entrer une adresse URL valide contenant un correctif approprié. Si tel n'est pas le cas, vous ne pourrez pas appliquer le correctif. De plus, n'oubliez pas que l'application d'un correctif directement à partir d'une adresse URL peut prendre du temps.
   4. 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.
4. Etape facultative : cette étape ne s'applique que si votre correctif est à la racine au niveau du projet ou de la sélection ; les correctifs à la racine de l'espace de travail passent automatiquement à la page d'aperçu des correctifs. Dans la page Spécification cible de correctif, vous devez sélectionner la ressource devant représenter la racine du correctif.
5. Etape facultative : cette étape n'est valable que si votre correctif fait référence à des projets qui sont inaccessibles ; si tous les projets du correctif figurent dans l'espace de travail et sont ouverts, cette page est ignorée. Dans la page Projets inaccessibles, vous pouvez ouvrir tout projet fermé. De plus, des détails sur les projets qui n'existent pas sont affichés. Vous ne pouvez pas appliquer de correctif aux projets qui sont fermés ou qui n'existent pas dans l'espace de travail.
6. Dans la dernière page, cliquez sur Terminer pour prévisualiser les modifications du correctif dans la vue Synchronisation.

Options d'application d'un correctif

1. Revenez dans la première page de l'assistant Appliquer un correctif et sélectionnez la ressource correcte à laquelle le correctif doit être appliqué.
2. Si un préfixe courant des noms de chemin d'accès stockés dans le fichier correctif ne correspond pas aux noms de chemin d'accès de l'espace de travail en cours, vous pouvez utiliser l'option Ignorer le début du nom de chemin d'accès.
3. Utilisez le bouton 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.
4. Ajustez le facteur d'imprécision (terminologie des correctifs). Ce facteur indique la quantité de lignes de contexte de hunk à ignorer. Si la valeur du facteur d'imprécision est zéro, toutes les lignes doivent correspondre. Si elle est supérieure à zéro, par exemple 2, les deux premières lignes de contexte avant le hunk et les deux dernières lignes de contexte après le hunk sont ignorées. Cliquez sur Estimer pour calculer le facteur d'imprécision qui permettra la mise en correspondance de la plupart des hunks.
5. Utilisez l'option Annuler les correctifs pour les fichiers de correctifs qui sont déjà appliqués à votre espace de travail. Cette option permet également d'annuler ou de rétablir un correctif.
6. Pour les correctifs de l'espace de travail, vous pouvez sélectionner un autre projet de votre espace de travail auquel appliquer les modifications de correctifs. Pour ce faire, sélectionnez un projet dans la sous-fenêtre supérieure et sélectionnez Déplacer dans le menu contextuel. 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 de correctifs seront appliquées au projet sélectionné.
7. Utilisez l'option Afficher les exclus pour afficher les hunks que vous avez déjà sélectionnés comme à ne pas inclure dans le chemin d'accès.
8. Lors de la synchronisation avec un correctif, les options ci-dessus sont disponibles dans le menu déroulant de la vue Synchronisation. Vous pouvez aussi passer d'un modèle disponible à l'autre afin d'obtenir des informations supplémentaires sur les modifications appliquées.

Programmation en équipe avec CVS

Comparaison de ressources
Synchronisation avec le référentiel

Equipe CVS