diff

Permet de comparer deux états d'un fichier.

Objectif

La sous-commande scm diff compare deux états d'un fichier, l'état antérieur et l'état postérieur, et génère le cas échéant un correctif contrôle des sources Jazz décrivant ce qui les différencie. La spécification d'un état s'effectue en fournissant deux paramètres : un nom de type et le sélecteur approprié. L'état ultérieur doit être indiqué. L'état antérieur est facultatif (s'il est omis, il est dérivé de l'état ultérieur).

Synopsis

Pour exécuter la commande scm diff après avoir utilisé scm login pour créer des données d'identification stockées :
scm diff { [ -d | --dir ] chemin-espace-de-travail [ -p | --fullpatch ] } type_postérieur sélecteur_postérieur { type_antérieur sélecteur_antérieur }
Pour exécuter la commande scm diff en fournissant les données d'identification sur la ligne de commande :
scm diff { [ -u | --username ] ID utilisateur dans le référentiel [ -P | --password ] mot de passe correspondant à l'ID utilisateur dans le référentiel [ -d | --dir ] chemin-espace-de-travail [ -p | --fullpatch ] } type_postérieur sélecteur_postérieur { type_antérieur sélecteur_antérieur }

Options et arguments

[ -d | --dir ] chemin-espace-de-travail

Chemin d'accès d'un espace de travail local créé par scm load ou scm share. Cette sous-commande s'exécute à l'aide de l'option chemin-espace-de-travail définie en tant que répertoire de travail en cours. Vous pouvez omettre cette option si le répertoire de travail en cours se trouve dans un espace de travail local.

[ -P | --password ] mot de passe correspondant à l'ID utilisateur dans le référentiel

Mot de passe correspondant à l'ID utilisateur indiqué dans le référentiel nommé. Si cette option n'est pas incluse sur la ligne de commande, vous êtes invité à fournir un mot de passe. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.

[ -p | --fullpatch ]

Génère un correctif contrôle des sources Jazz complet.

[ -u | --username ] ID utilisateur dans le référentiel

Spécifie un ID utilisateur qui existe déjà dans le réferentiel nommé. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.

type_postérieur

Correspond à l'un des éléments suivants :

file (fichier)
worspace (espace de travail)
stream (flux)

sélecteur_postérieur

Correspond à l'un des éléments suivants :

pathname (nom de chemin d'accès) si type_postérieur correspond à file (fichier)
name (nom), alias ou UUID (identificateur unique universel) si type_postérieur correspond à worspace (espace de travail) ou à stream (flux)

type_antérieur

Correspond à l'un des éléments suivants :

changeset (ensemble d'artefacts modifiés)
file (fichier)
worspace (espace de travail)
stream (flux)

sélecteur_antérieur

Correspond à l'un des éléments suivants :

pathname (nom de chemin d'accès) si type_antérieur correspond à file (fichier)
name (nom), alias ou UUID (identificateur unique universel) si type_antérieur correspond à changeset (ensemble d'artefacts modifiés), workspace (espace de travail) ou stream (flux)

Exemples

Dans un espace de travail local, vous avez accepté un ensemble d'artefacts modifiés qui entraîne un conflit avec un fichier de votre espace de travail, comme indiqué par scm status :

C:\local-workspaces\HelloJazz>scm status -C
Espace de travail : (1101) "HelloJazz" <-> (1102) "HelloJazz Stream" Composant : (1103) "HelloJazz" Version de référence : (1108) 3 "beta2 updates" Conflits : com.example.hellojazz.service/src/com/example/hellojazz/service/internal/> Sortantes : Ensembles d'artefacts modifiés : (1115) !-@ <Pas de commentaire> Modifications : !--c /com.example.hellojazz.service/src/com/example/hellojazz/servi>

Exécutez la commande scm conflicts afin d'obtenir plus d'informations sur le conflit :

C:\local-workspaces\HelloJazz>scm conflicts
Conflits C-m- /com.example.hellojazz.service/src/com/example/hellojazz/service/internal/HelloJazzService.java Incident lors de l'exécution de 'conflicts': Il reste des conflits non résolus.

Exécutez la commande scm diff pour comparer la version du fichier dans votre espace de travail à la modification proposée dans l'ensemble d'artefacts modifiés entrant (qui se trouve dans le flux doté de l'alias 1102, comme indiqué dans la commande scm status précédente) :

C:\local-workspaces\HelloJazz>scm diff file com.example.hellojazz.service\src\com\example\hellojazz\service\internal\HelloJazzService.java stream 1102
--- com.example.hellojazz.service/src/com/example/hellojazz/service/internal/HelloJazzService.java 2008-06-03 09:17:36.000000723 -0400 +++ com.example.hellojazz.service/src/com/example/hellojazz/service/internal/HelloJazzService.java 2008-06-03 09:12:27.000000563 -0400 @@ -17,6 +17,6 @@ implements IHelloJazzService { public String sayHello() throws TeamRepositoryException { - return "Hello Jazz! You're looking good!"; + return "Hello Jazz! How are you?"; } }