Considérons que vous avez détecté un bogue à la ligne 65 d'un fichier et que vous ne comprenez pas le code. A qui demandez-vous ou reprochez-vous la modification ? Vous pourriez commencer par consulter l'historique des ressources correspondant au fichier, mais cela n'indique pas qui a modifié cette ligne particulière. C'est la raison pour laquelle l'option d'annotation est utile. Vous pouvez sélectionner n'importe quel fichier ASCII (voir remarque sur les fichiers binaires) et obtenir une liste indiquant quelles personnes ont modifié quelle ligne.
L'action Afficher l'annotation est accessible à partir des emplacements suivants : vue Historique, explorateur des référentiels, vue Synchronisation et vue des ressources et des packages. Lors de l'exécution de l'annotation, vous pouvez procéder comme suit :
Parcourez les modifications dans la vue d'annotation et l'éditeur de texte met en évidence les lignes associées à la modification sélectionnée.
Vous pouvez sélectionner une ligne du fichier texte et la vue d'annotation sélectionne la modification qui est associée à cette ligne.
La vue Historique affiche l'historique du fichier ouvert et met en évidence la révision de la modification sélectionnée. Cela permet de visualiser rapidement le commentaire de validation correspondant à une modification particulière.
L'option d'annotation ne fonctionne qu'avec les fichiers qui sont signalés comme étant au format ASCII dans le référentiel CVS. De même, cette option ouvre un fichier texte qui affiche les modifications, même si l'éditeur associé du plan de travail n'est pas un éditeur de texte. Par exemple, si l'annotation est exécutée sur un fichier plugin.xml, un éditeur de texte simple s'ouvre à la place de l'éditeur PDE complet.