Comparar duas áreas de trabalho/fluxos/linhas de base/capturas instantâneas,
mostrando linhas de base e conjuntos de mudanças diferentes.
Finalidade
Examine um par de elementos de fluxo e mostre
quais linhas de base e conjuntos de mudanças diferem entre os dois.
A exibição é
apresentada como uma hierarquia de itens, por padrão:
Direção de fluxo (entrada/saída)
Componente
Linha de base
Conjunto de mudanças
Item de trabalho
Entidades do sistema de arquivos
É possível aumentar ou diminuir a posição dos
itens de trabalho na hierarquia com o comutador -w/--reroot.
As linhas de base e os
conjuntos de mudanças possuem informações de autor e de tempo de entrega. O formato do campo
de autor pode ser alterado com o comutador -C/--format-contributor,
enquanto que o formato do tempo de entrega pode ser alterado com
-D/--format-date.
Sinopse
O mesmo que em qualquer outro lugar. Pode ser executado no modo
conectado, em uma área de trabalho carregada localmente ou em uma área de trabalho descarregada.
Opções e argumentos
- [ -d |
--dir ] workspace-path
- O nome do caminho de uma área de trabalho local criada por scm load ou scm share.
Este subcomando executa com o conjunto
workspace-path como o diretório de trabalho atual. Você pode omitir esta opção se o diretório de trabalho atual é uma área de trabalho local.
- [ -P | --password ] senha para o
ID do usuário no repositório
- A senha para o ID do usuário especificado no repositório nomeado. Se esta opção não
estiver incluída na linha de comandos, será solicitada uma senha. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando
scm login, esta opção é ignorada.
- [ -r | --repository-uri ] URI do
repositório
- Especifica o repositório no qual executar esta ação. Se você armazenou credenciais do repositório utilizando o comando scm login, pode
utilizar o apelido que forneceu para estas credenciais armazenadas
- [ -u | --username ] ID do
usuário no repositório
- Especifica um ID do usuário que existe no repositório nomeado. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando
scm login, esta opção é ignorada.
- [ -c
| --component ] arg ...
- Usado apenas quando um argumento
de linha de base é especificado pelo nome. Indica o componente no qual a linha de base
pode ser localizada.
- [ -C
| --format-contributor ] arg
- Especifica como os contribuidores
devem ser listados. O argumento único é uma cadeia que tem os seguintes
campos substituídos:
- {userid} – Substituído pelo ID do usuário do repositório do usuário exclusivo.
- {name} – Substituído pelo nome do usuário, conforme listado no repositório.
- {email} – Substituído pelo endereço de e-mail do usuário, conforme listado no
repositório.
- {itemid} – Substituído pelo ID interno exclusivo do usuário no
repositório. Este valor não é considerado significativo ou legível
a humanos.
- [ -D
| --format-date ] arg
- Especifica como as datas devem ser mostradas.
O único argumento é uma cadeia que será passada através de SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html do Java.
- [ -f
| --flow-directions ] arg
- Limita a exibição para incluir apenas
alterações recebidas/enviadas. Deve ser um dos seguintes:
- 'i' – Alterações recebidas
- 'o' – Alterações enviadas
- 'b' – Ambas as alterações, recebidas e enviadas
- [ -I | --include-types ] arg
- Inclui apenas itens dos tipos listados. O argumento é uma cadeia,
que pode conter qualquer um dos seguintes caracteres:
- 'd' – Direção de fluxo. O elemento mais importante.
- 'c' – Componente.
- 'b' – Linha de base.
- 'w' – Item de trabalho.
- 's' – Conjunto de mudanças.
- 'f' – Alteração do sistema de arquivos.
Por padrão, todos os tipos, exceto as alterações do sistema de arquivos, são mostrados (ou seja, “dcbws”).
- [ -p | --prune ] arg
- Remove nós vazios da hierarquia. O valor pode consistir de uma cadeia
contendo os caracteres:
- 'd' – Indicando que as direções de fluxo vazio devem ser removidas.
- 'c' – Indicando que os componentes inalterados devem ser removidos.
Por padrão, nada é removido.
- [ -S | --Show ] arg
- Controla quais campos/valores de opção são mostrados. O valor pode conter
o seguinte:
- 'c' – Indica que o contribuidor deve ser mostrado. Os contribuidores do autor
serão mostrados nas linhas de base e nos conjuntos de mudanças.
- 'd' – Indica que as datas devem ser mostradas. As datas são mostradas como horas
de modificação nos conjuntos de mudanças e como horas de criação nas linhas de base.
- 'i' – Indica que os itens de trabalho devem ser mostrados como filhos dos
conjuntos de mudanças. Se não forem incluídos, os itens de trabalho serão mostrados apenas como
parte da descrição do conjunto de mudanças.
Por padrão, todos os campos são mostrados.
- [ -w | --reroot ] arg
- Indica que os nós de item de trabalho devem ser movidos para cima na
hierarquia exibida. O valor deve ser um de:
- 'r' – Para raiz, indicando que todos os tipos de item devem ser mostrados
em um item de trabalho.
- 'd' – Indica que os itens de trabalho devem ser mostrados na direção do
fluxo de trabalho, significando que todos os componentes serão mostrados nos itens de trabalho.
- 'c' – Indica que os itens de trabalho devem ser mostrados nos componentes, significando que todos
os conjuntos de mudanças e linhas de base serão mostrados nos componentes.
- 'b' – Indica que os itens de trabalho devem ser mostrados nas linhas de base,
significando que todos os conjuntos de mudanças serão mostrados nos itens de trabalho.
Por padrão, os itens de trabalho são mostrados nos conjuntos de mudanças.
Exemplos
Para gerar um log de mudança com um mínimo de informações
secundárias, use:
$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Work Item 60074: Allow defining permissions for project and team areas in the Web UI
Work Item 62945: Set up some sort of Jazz Foundation build
Work Item 63040: TCT031b: Jazz Translations - more variables
Work Item 63053: Web UI template import doesn't allow change to workitem customization
Work Item 63091: Consider project area locale when creating change events and rendering feeds
Work Item 63266: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails should be re-written to accommodate translation
Usar “-I w” limita a exibição dos itens de trabalho,
“-S ''” impede ruídos extras na linha de trabalho e “-f” i” garante que as alterações
de saída não se entremisturem com as alterações de entrada.
Para gerar um log de mudanças
que agrupa as alterações do sistema de arquivos no item de trabalho e no conjunto de mudanças e
forneça um formato de data 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
Work Item 63266: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
No comment 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
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails should be re-written to accommodate translation
handle case where category is known but doesn't have a distinct message 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
Work Item 63416: Not externalized string for translatable attribute for declared domain adapter
No comment Fri, 7 Nov 2008 16:46:56 -0500
/com.ibm.team.process.ide.ui/plugin.properties
/com.ibm.team.process.ide.ui/plugin.xml
Note o uso
da opção -w para tornar os itens de trabalho o pai dos conjuntos de mudanças e o uso da opção -D para configurar o formato de data. Os aliases e os UUIDs são suprimidos com as opções iniciais
“-u” e “-a”.