comparar

Compare dos espacios de trabajo/corrientes/líneas base/instantáneas, mostrando líneas base y conjunto de cambios diferentes.

Finalidad

Examinar un par de elementos de flujo y mostrar qué líneas base y conjuntos de cambios son distintos entre los dos.

La visualización se presenta como una jerarquía de elementos, por defecto:

Dirección del flujo (entrante/saliente)
	Componente
		Línea base
			Conjunto de cambios
				Elemento de trabajo
				Entidades de sistema de archivos

Es posible subir o bajar la posición de los elementos de trabajo en la jerarquía con un comnutador -w/--reroot.

Las líneas base y los conjuntos de cambio tiene información sobre el autor y la hora de entrega. El formato del campo autor se puede modificar con el conmutador -C/--format-contributor, mientras que el formato de la hora de entrega se puede cambiar con -D/--format-date.

Sinopsis

Igual que en otras partes. Se puede ejecutar en modalidad entrada al sistema, en un espacio de trabajo cargado localmente, o en un espacio de trabajo no cargado.

Opciones y argumentos

-d  |  --dir ] workspace-path
El nombre de la vía de acceso de un espacio de trabajo local creado por scm load o scm share. Este submandato se ejecuta con la vía de acceso del espacio de trabajo como el directorio de trabajo actual. Puede omitir esta opción si el directorio de trabajo es un espacio de trabajo local.
-P  |  --password ] contraseña de ID de usuario de repositorio
La contraseña del ID de usuario especificado en el repositorio indicado. Si no incluye esta opción en la línea de mandato, deberá escribir una contraseña. En caso de especificar un URI o apodo de repositorio para el cual ha almacenado credenciales mediante el mandato scm login, se hace caso omiso de esta opción.
-r  |  --repository-uri ] URI de repositorio
Especifica el repositorio en el cual llevar a cabo esta acción. Si ha almacenado credenciales de repositorio con el mandato scm login, puede utilizar el apodo que escogió para dichas credenciales
-u  |  --username ] ID de usuario de repositorio
Especifica un ID de usuario que existe en el repositorio indicado. En caso de especificar un URI o apodo de repositorio para el cual ha almacenado credenciales mediante el mandato scm login, se hace caso omiso de esta opción.
-c  |  --component ] arg ...
Solo se utiliza cuando un argumento de línea base se especifica por nombre. Indica el componente en el que se puede encontrar la línea base.
-C  |  --format-contributor ] arg
Especifica cómo deben listarse los colaboradores. El argumento simple es una serie en la que se han sustituido los siguientes campos:
  • {userid} – Se ha sustituido con el ID de usuario de repositorio del usuario exclusivo.
  • {name} – Se ha sustituido con el nombre del usuario, como se encuentra listado en el repositorio.
  • {email} – Se ha sustituido con la dirección de correo electrónico del usuario, como se encuentra listada en el repositorio.
  • {itemid} – Se ha sustituido con el ID interno exclusivo del usuario en el repositorio. Se considera que este valor no tiene sentido ni es legible para los seres humanos.
-D  |  --format-date ] arg
Especifica cómo deben mostrarse las fechas. El argumento simple es una serie que se transferirá a través de SimpleDateFormatter de Java http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html.
-f  |  --flow-directions ] arg
Limitar la visualización para que incluya solo los cambios entrantes/salientes. Debe ser uno de los siguientes:
  • 'i' – Cambios entrantes
  • 'o' – Cambios salientes
  • 'b' – Cambios entrantes y salientes
-I  |  --include-types ] arg
Únicamente incluye elementos de los tipos listados. El argumento es una serie, que puede contener cualquiera de los caracteres siguientes:
  • 'd' – Dirección de flujo. El elemento más alto.
  • 'c' – Componente.
  • 'b' – Línea base.
  • 'w' – Elemento de trabajo.
  • 's' – Conjunto de cambios.
  • 'f' – Cambio del sistema de archivos.

De forma predeterminada, se muestran todos los tipos excepto los cambios del sistema de archivos (por ej., “dcbws”).

-p  |  --prune ] arg
Elimina los nodos vacíos de la jerarquía. El valor puede constar de una serie que contenga los caracteres:
  • 'd' – Indica que se deberían eliminar las direcciones de flujo vacías.
  • 'c' – Indica que se deberían eliminar los componentes sin cambios.

De forma predeterminada, no se borra nada.

-S  |  --Show ] arg
Controla la opción que muestran los valores/campos. El valor puede contener lo siguiente:
  • 'c' – Indica que debería mostrarse el colaborador. Los colaboradores de autor se mostrarán en las líneas base y los conjuntos de cambios.
  • 'd' – Indica las fechas que deberían mostrarse. Las fechas se muestran como horas de modificación en conjuntos de cambios y tiempos de creación en líneas base.
  • 'i' – Indica los elementos de trabajo que deberían mostrarse como hijos de los conjuntos de cambios. Si no están incluidos, los elementos de trabajo sólo se mostrarán como parte de la descripción del conjunto de cambios.

De forma predeterminada, se muestran todos los campos.

-w  |  --reroot ] arg
Indica qué nodos de elementos de trabajo se deberían mover hacia arriba en la jerarquía visualizada. El valor debe ser uno de los siguientes:
  • 'r' – Para raíz, indica que todos los tipos de elementos se deberían mostrar bajo el elemento de trabajo.
  • 'd' – Indica los elementos de trabajo que se deberían mostrar bajo la dirección de flujo, lo que significa que todos los componentes se mostrarán bajo los elementos de trabajo.
  • 'c' – Indica los elementos de trabajo que se deberían mostrar bajo los componentes, lo que significa que todos los conjuntos de cambios y líneas base se mostrarán bajo componentes.
  • 'b' – Indica los elementos de trabajo que se deberían mostrar bajo las líneas base, lo que significa que todos los conjuntos de cambios se mostrarán bajo los elementos de trabajo.

De forma predeterminadas, los elementos de trabajo se muestran bajo los conjuntos de cambios.

Ejemplos

Para generar un registro de cambios con la mínima información superflua, utilice:

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Elemento de trabajo 60074: Permite definir permisos para áreas de proyecto y de equipo en la UI web
Elemento de trabajo 62945: Establece alguna clase de compilación de Jazz Foundation
Elemento de trabajo 63040: TCT031b: Jazz Translations - más variables
Elemento de trabajo 63053: La importación de la plantilla UI web no permite cambiar a la personalización del elemento de trabajo
Elemento de trabajo 63091: Tenga en cuenta el entorno local del área de proyecto cuando cree sucesos de cambios y canales de información de representación
Elemento de trabajo 63266: Errores CHKPII en archivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
Elemento de trabajo 63371: ProcessFeedRenderer.getProcessAreaChangeDetails se debería volver a escribir para dar cabida a la traducción

Utilizando “-I w” limita la visualización a los elementos de trabajo, “-S ''” impide el ruido extra en la línea de elementos de trabajo, y “-f” i” asegura que los cambios salientes no se mezclan con los cambios entrantes.
Para generar un registro de cambios que agrupe los cambios del sistema de archivos bajo el elemento de trabajo y el conjunto de cambios, y proporcione un formato de fecha específico:

$ scm -u n -a n compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I wfs -w d -S d -D "EEE, d MMM yyyy HH:mm:ss Z" -f i
Elemento de trabajo 63266: Errores CHKPII en archivos COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
  No hay comentarios Fri, 7 Nov 2008 16:52:24 -0500
    /com.ibm.team.process.definitions.server/data/agile/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/eclipseway/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/openup/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/scrum/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/simple/attachments/template.properties
Elemento de trabajo 63371: ProcessFeedRenderer.getProcessAreaChangeDetails se debería volver a escribir para dar cabida a la traducción
  se ocupa del caso donde se conoce la categoría pero no tiene un mensaje distinto Thu, 6 Nov 2008 16:49:09 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/ProcessFeedRenderer.java
  Merges Thu, 6 Nov 2008 19:50:52 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
Elemento de trabajo 63416: Sin serie externalizada para el atributo traducible para el adaptador de dominio declarado
  No hay comentarios Fri, 7 Nov 2008 16:46:56 -0500
    /com.ibm.team.process.ide.ui/plugin.properties
    /com.ibm.team.process.ide.ui/plugin.xml

Observe el uso de -w para hacer de los elementos de trabajo un padre de conjuntos de cambios, y -D para establecer el formato de fecha. Las Alias y UUID se suprimen con las opciones “-u” y “-a” iniciales.