Trabalhando com correções

As correções permitem que os desenvolvedores compartilhem trabalho sem armazená-lo em um repositório. Isso é útil quando um desenvolvedor deseja contribuir para um projeto que é compartilhado através de um repositório mas que não possui acesso de gravação no repositório. Nesta situação, o desenvolvedor pode criar uma correção e endereçá-la para um desenvolvedor que possui acesso de gravação ou conectá-la a erro no sistema de relatório de erro utilizado pelo projeto, dependendo do processo definido pelo projeto. Um desenvolvedor que não possui acesso de gravação pode aplicar a correção ao projeto e consolidar as alterações.

Para criar uma correção de um projeto do CVS:

1. Selecione o recurso que contém as modificações a serem incluídas na correção. É possível selecionar os recursos localizados em vários projetos e em qualquer nível, uma vez que o assistente Criar Correção, quando executado em seu modo padrão, sabe como criar uma correção para vários projetos. A correção também deve ser aplicada às mesmas revisões de arquivo em que ela é gerada, assim, as etapas devem ser obtidas para garantir que a correção seja aplicada à mesma formação em linha do recurso (a maneira mais fácil para fazer isso é criar a correção na parte superior de uma versão).
2. No menu pop-up, selecione Equipe > Criar Correção.... O assistente Criar Correção será aberto.
3. Escolha onde a correção deve ser salva:
   1. Salvar na Área de Transferência - isso colocará a correção na área de transferência, portanto, ela pode ser colada em um editor de texto tal como um programa de e-mail.
   2. Salvar no Sistema de Arquivos - isso colocará a correção no arquivo especificado no sistema de arquivos local
   3. Salvar no Espaço de Trabalho - isso colocará a correção no arquivo especificado dentro de um dos projetos existentes do ambiente de trabalho.
   Para pequenas correções, pode ser razoável transferir a correção utilizando a área de transferência, mas na maioria dos casos o sistema de arquivos local é a melhor opção a ser utilizada.
4. É possível visualizar e ajustar com precisão a seleção da correção expandindo a árvore de Recursos apresentada na área de janela Alterações. Apenas os elementos marcados serão incluídos na correção. Clique em Avançar para configurar como a correção é gerada.
5. Escolha como configurar a correção:
   1. Formato de saída diferente - Permite a opção de vários formatos de saída diferentes. Unificado é o formato utilizado por muitas ferramentas do aplicativo de correção incluindo o Eclipse. O formato utilizado nos diffs de Contexto e Unificado permite a aplicação de uma correção, mesmo que o número de linha mencionado para o hunk (terminologia de correção) esteja incorreto. Neste caso, ao aplicar a correção, o algoritmo faz a varredura para frente e para trás de um conjunto de linhas que correspondem ao contexto dado para o hunk.
   2. Raiz da Correção - Permite especificar em que nível a correção será colocada na raiz. As opções são Espaço de Trabalho, Projeto e Seleção.
      
      Espaço de Trabalho permite incluir recursos de vários projetos na correção e é a opção padrão. As correções do espaço de trabalho podem ser aplicadas em qualquer recurso do espaço de trabalho - elas contêm informações suficientes para permitir que o assistente Aplicar Correção estime quais recursos precisam da correção.
      
      Correções de Projeto são colocadas na raiz no nível do projeto - o que significa que podem conter recursos apenas de um projeto e devem ser aplicadas no mesmo projeto.
      
      Correções de Seleção são colocadas na raiz onde quer que o recurso selecionado esteja e devem ser aplicadas no mesmo recurso.
6. Clique em Concluir.
7. Transfira a correção conforme apropriado para o projeto que está sendo corrigido.

Para aplicar uma correção:

1. Selecione o recurso no qual a correção foi gerada. Esse recurso deve conter as mesmas revisões de arquivo que a formação de linha na qual a correção foi gerada.
2. No menu pop-up, selecione Equipe > Aplicar Correção.... O assistente Aplicar Correção será exibido.
   
   Isso pode ser obtido também copiando o conteúdo da correção para a área de transferência e colando-o diretamente na visualização Package Explorer, escolhendo Editar > Colar. Nesse caso, você pode ignorar a próxima etapa.
3. Indique onde a correção deve ser encontrada:
   1. Arquivo - a correção está em um arquivo no sistema de arquivos local. Digite o caminho completo para o arquivo ou utilize o botão Procurar... para procurar o arquivo.
   2. Área de Transferência - a correção está na área de transferência. Aviso: É mais seguro utilizar um arquivo com base na correção. As finalizações de linha podem não ser tratadas corretamente se a área de transferência é utilizada e a correção foi gerada em uma plataforma diferente (ou seja, Linux vs. Windows).
   3. URL - a correção está localizada na URL fornecida. Aviso: Assegure-se de que a URL inserida seja válida e contenha uma correção adequada. Caso contrário, você não poderá aplicá-la. Além disso, lembre-se de que aplicar uma correção diretamente de uma URL pode demorar algum tempo.
   4. Área de trabalho - a correção foi salva em algum lugar na área de trabalho.
   Clique em Avançar para ver o efeito de aplicação da correção.
4. Etapa Opcional: essa etapa se aplicará apenas se você tiver uma correção destravada no projeto ou no nível de seleção - as correções destravadas na área de trabalho continuarão automaticamente na Página de Visualização da Correção. Na página Especificação do Destino da Correção, selecione o recurso que agirá como a raiz da correção.
5. A página de visualização da correção mostra se a correção poderia ser aplicada com êxito aos arquivos do espaço de trabalho. A área de janela inicial mostra a lista de alterações contidas na correção. Há dois tipos de entradas na área de janela superior: alterações de arquivos e segmentos de correção não correspondidos (conhecidos como 'hunk' na terminologia de correção).
   1. Se um ou mais dos segmentos de correção puderem ser aplicados automaticamente ao arquivo, o arquivo será mostrado com um indicador de alteração de entrada. A alteração pode ser examinada dando-se um clique duplo no arquivo.
   2. Se um ou mais hunks não puderem ser aplicados automaticamente, as entradas dos hunks aparecerão como filhos do arquivo na área de janela superior e uma exclamação vermelha indicará que há problemas com uma correção ou um hunk. O hunk pode ser examinado dando-se um clique duplo nele. Em seguida, ele pode ser aplicado manualmente a partir da área de janela direita ao arquivo à esquerda. Salvar a partir da área de janela esquerda atualizará a entrada de arquivo pai na área de janela superior, mas não modificará o arquivo no disco. O arquivo no disco só será modificado quando Concluir for pressionado. Para aplicar a correção completa com êxito, será necessário eliminar os problemas (exclamações vermelhas) aplicando manualmente os segmentos de correção, excluindo o segmento de correção da operação selecionando Remover no menu de contexto ou adaptando as opções nesta página do assistente (consulte 'Opções' a seguir).
6. Se tudo ocorrer bem, clique em Concluir para aplicar a correção. A área de trabalho irá conter agora alterações de saída para cada arquivo modificado pela correção.

As correções podem ser aplicadas sincronizando-as com um conteúdo local

Para sincronizar com uma correção:

1. Na perspectiva Sincronização da Equipe, selecione a ação Sincronizar... no menu drop-down do botão Sincronizar .
2. Selecione Sincronizar com a Correção na lista de tipos possíveis de sincronização e clique em Avançar.
3. Indique onde a correção deve ser encontrada:
   1. Arquivo - a correção está em um arquivo no sistema de arquivos local. Digite o caminho completo para o arquivo ou utilize o botão Procurar... para procurar o arquivo.
   2. Área de Transferência - a correção está na área de transferência. Aviso: É mais seguro utilizar um arquivo com base na correção. As finalizações de linha podem não ser tratadas corretamente se a área de transferência é utilizada e a correção foi gerada em uma plataforma diferente (ou seja, Linux vs. Windows).
   3. URL - a correção está localizada na URL fornecida. Aviso: Assegure-se de que a URL inserida seja válida e contenha uma correção adequada. Caso contrário, você não poderá aplicar a correção. Além disso, lembre-se de que aplicar uma correção diretamente de uma URL pode demorar algum tempo.
   4. Espaço de trabalho - a correção foi salva em algum lugar no espaço de trabalho.
   Clique em Avançar para ver o efeito de aplicação da correção.
4. Etapa Opcional: essa etapa se aplicará apenas se você tiver uma correção destravada no projeto ou no nível de seleção - as correções destravadas na área de trabalho continuarão automaticamente na Página de Visualização da Correção. Na página Especificação do Destino da Correção, selecione o recurso que agirá como a raiz da correção.
5. Etapa Opcional: essa etapa se aplicará apenas se sua correção se referir a projetos que estão inacessíveis - se todos os projetos da correção estiverem presentes na área de trabalho e estiverem abertos, essa página será ignorada. Na página Projetos Inacessíveis, você pode abrir quaisquer projetos fechados. Além disso, detalhes sobre projetos não existentes serão exibidos. Os projetos que estão fechados ou que não existirem na área de trabalho não poderão ser corrigidos.
6. Na página final, clique em Concluir para visualizar as alterações de correção na visualização Sincronização.

Opções para aplicação de uma correção

1. Volte para a primeira página do assistente Aplicar Correção e selecione o recurso correto ao qual aplicar a correção.
2. Se um prefixo comum dos nomes de caminhos armazenados no arquivo de correção não corresponder aos nomes de caminhos de seu espaço de trabalho atual, você poderá Ignorar os segmentos com nomes de caminhos iniciais.
3. Utilize o botão Ignorar espaço em branco para tornar o processo de correspondência independente das diferenças de espaço em branco entre o arquivo de correção e os arquivos de seu espaço de trabalho.
4. Ajuste o fator Fuzz (terminologia de correção). Este fator indica a quantidade de linhas de contexto de hunk a ser ignorada. Se o valor do fator Fuzz for zero, todas as linhas precisam corresponder. Se o fator fuzz for maior do que zero, por exemplo, 2, as primeiras duas linhas de contexto antes do hunk e as duas linhas de contexto após o hunk são ignoradas. Clique em Adivinhar para calcular o fator fuzz que permite correspondência para a maioria dos hunks.
5. Utilize a opção Reverter correção para arquivos de correção que já foram aplicados ao espaço de trabalho. Essa opção também é útil para desfazer ou refazer uma correção.
6. Para correções do Espaço de Trabalho, você pode selecionar outro projeto no espaço de trabalho ao qual aplicar as alterações da correção. Para isso, selecione um projeto na área de janela superior e clique em Mover no menu de contexto. Isso ativará um diálogo com uma lista dos projetos disponíveis no espaço de trabalho. Selecione um projeto e clique em OK; as alterações da correção serão aplicadas ao projeto selecionado.
7. Utilize a opção Mostrar Excluídos para mostrar os hunks já selecionados para não serem incluídos na correção.
8. Ao sincronizar com uma correção, as opções acima estarão disponíveis no menu suspenso da visualização Sincronização. Também é possível alternar entre os modelos disponíveis para obter informações extras sobre as alterações que estão sendo aplicadas.

Programação de equipe com CVS

Comparando recursos
Sincronizando com o repositório

Equipe CVS