Trabalhar com correcções
As correcções permitem que os programadores partilhem trabalho sem o armazenar num repositório.
Isto é útil quando um programador quiser contribuir para um projecto que seja partilhado através de um repositório, mas que não tenha acesso de escrita para o repositório. Nesta situação, o programador pode criar uma correcção e enviá-la por correio electrónico para um programador que tenha acesso de escrita ou anexá-la a um erro no sistema de comunicação de erros utilizado pelo projecto, dependendo do processo definido pelo projecto. Um programador que tenha acesso de escrita pode depois aplicar a correcção ao projecto e consolidar as alterações.
Para criar uma correcção de um projecto de CVS:
- Seleccione o recurso que contém as modificações a serem incluídas na correcção. É possível seleccionar recursos que residem em vários projectos e em qualquer
nível, tal como o assistente Criar correcção que, quando executado no modo
predefinido, executa o procedimento para criar correcções aos projectos. A correcção também deverá ser aplicada às mesmas revisões de ficheiros das quais foi gerada, de forma a que possam ser executados passos no sentido de assegurar que a correcção é aplicada na mesma apresentação do recurso (a forma mais fácil de o fazer é criar a correcção por cima de uma versão).
- No menu emergente, seleccione Equipa > Criar correcção.... Vai abrir-se o assistente Criar correcção.
- Escolha onde deve ser guardada a correcção:
- Guardar na Área de Transferência - irá colocar a correcção na área de transferência de forma a poder ser colada num editor de texto, como um programa de correio electrónico.
- Guardar no Sistema de Ficheiros - irá colocar a correcção no ficheiro especificado no sistema de ficheiros local
- Guardar no Espaço de Trabalho - irá colocar a correcção no ficheiro especificado dentro de um dos projectos da área de trabalho existentes.
Para correcções pequenas, poderá ser razoável transferir a correcção utilizando a área de transferência mas, na maioria dos casos, o sistema de ficheiros local é a melhor opção a utilizar.
- É possível pré-visualizar e ajustar a selecção de correcção expandindo
a árvore Recursos, apresentada em Alterações na área da janela. Apenas os
elementos que se encontram marcados serão incluídos na correcção. Fazer clique em Seguinte para configurar a forma como a correcção é gerada.
- Escolha como configurar a correcção:
- Formato de saída Diff - Permite a escolha de vários formatos de saída diff comuns. Unified é o formato utilizado por muitas ferramentas de aplicações de correcções, incluindo o Eclipse. O formato utilizado em diffs Contexto e Unificado permite aplicar uma correcção, muito embora o número de linha mencionado para a parte (terminologia de correcções) esteja incorrecto. Neste caso, ao aplicar a correcção, o algoritmo pesquisa para a frente e parar trás para ver um conjunto de linhas correspondendo ao contexto fornecido para a parte.
- Raiz da correcção - Permite especificar a que nível de raiz
pretende que a correcção seja efectuada. As opções são Espaço de trabalho,
Projecto e Selecção.
Espaço de trabalho permite incluir recursos de vários
projectos na correcção e corresponde à opção predefinida. As
correcções de espaço de trabalho podem ser aplicadas a qualquer recurso no
espaço de trabalho - contêm informações suficientes para permitir que o
assistente Aplicar correcção calcule quais os recursos a corrigir.
As correcções de Projecto têm raiz ao nível do projecto - o
que significa que apenas podem conter recursos de um projecto e têm de ser
aplicadas ao mesmo projecto.
As correcções de Selecção têm raiz em qualquer que seja o
recurso seleccionado e têm de ser aplicadas ao mesmo recurso.
- Faça clique em Terminar.
- Transfira a correcção conforme seja apropriado para o projecto que estiver a ser corrigido.
Para aplicar uma correcção:
- Seleccione o recurso em que foi gerado o recurso. Este recurso deverá conter as mesmas revisões de ficheiros que a apresentação em que a correcção foi gerada.
- No menu emergente, seleccione Equipa>Aplicar correcção.... O assistente Aplicar correcção abre-se.
Também pode conseguir este resultado copiando os conteúdos da correcção para a área de transição e colando-os directamente na vista Explorador de pacotes escolhendo Editar > Colar.
Neste caso, pode ignorar o passo que se segue.
- Indique onde se vai localizar a correcção:
- Ficheiro - a correcção está num ficheiro no sistema de ficheiros local. Insira o caminho completo do ficheiro ou utilize o botão Procurar... para localizar o ficheiro.
- Área de Transferência - a correcção está na área de transferência. Aviso: É mais seguro utilizar uma correcção baseada em ficheiros. As terminações de linhas podem não ser correctamente processadas se a área de transferência for utilizada e a correcção tiver sido gerada numa plataforma diferente (por exemplo, Linux vs. Windows).
- URL - a correcção está localizada na URL facultada. Aviso: Certifique-se de que a URL que introduziu é válida e contém a correcção apropriada.
Caso contrário, não será capaz de a aplicar. Igualmente, recorde-se de que a aplicação de uma correcção directamente de uma URL pode demorar algum tempo.
- Espaço de trabalho - a correcção foi guardada algures no
espaço de trabalho.
Fazer clique em Seguinte para ver o efeito da aplicação da correcção.
-
Passo opcional: este passo é para ser utilizado apenas se tiver uma correcção com raiz no projecto ou no nível de selecção - as correcções com raiz no espaço de trabalho irão proceder automaticamente para a página Pré-visualizar correcção. Na página Especificação de correcção de destino, deve
seleccionar o recurso que deve actuar como raiz da correcção.
- A página de pré-visualização de correcção indica se a correcção foi
aplicada com sucesso aos ficheiros do espaço de trabalho. A parte superior da
área da janela apresenta a lista de alterações contidas na correcção.
Existem dois tipos de entradas na área da janela superior: alterações do ficheiro e segmentos de correcções sem correspondência (conhecido como 'hunk' em terminologia de correcção).
- Se um ou mais segmentos de correcções puderem ser aplicados automaticamente no ficheiro, o ficheiro é apresentado com um indicador de alteração de entrada. Pode ver a alteração fazendo duplo clique no ficheiro.
- Se um ou mais hunks não puderem ser aplicados automaticamente, as entradas de hunk aparecem como elementos descendentes no área da janela superior e um ponto de exclamação vermelho indica que existe um problema com a correcção ou hunk.
Pode ver o hunk fazendo duplo clique sobre ele. Pode, em seguida, aplicar manualmente o hunk na área da janela da direita para o ficheiro à esquerda. Quando guardar na área da janela da esquerda, vai actualizar a entrada do ficheiro principal na área da janela de topo, mas não altera o ficheiro no disco. O ficheiro no disco só é modificado quando premir Terminar.
Para aplicar correctamente toda a correcção, tem de eliminar os problemas (pontos de exclamação vermelhos): aplicando manualmente os segmentos de correcção, excluindo o segmento de correcção na operação seleccionado Remover no menu contextual ou trocando as opções nesta página de assistente (consulte "Opções" abaixo).
- Se tudo correr bem, faça clique em Terminar para aplicar a correcção. O espaço de trabalho vai conter agora as alterações de saída para cada ficheiro modificado pela correcção.
As correcções podem ser aplicadas sincronizando-as com um conteúdo local
Para sincronizar com uma correcção:
-
Na perspectiva Sincronização da Equipa, seleccione a acção Sincronizar... no botão pendente Sincronizar
.
-
Seleccione Sincronizar com correcção na lista de tipos de sincronização possíveis e faça clique em Seguinte.
- Indique onde se vai localizar a correcção:
- Ficheiro - a correcção está num ficheiro no sistema de ficheiros local. Insira o caminho completo do ficheiro ou utilize o botão Procurar... para localizar o ficheiro.
- Área de Transferência - a correcção está na área de transferência. Aviso: É mais seguro utilizar uma correcção baseado em ficheiros. As terminações de linhas podem não ser correctamente processadas se a área de transferência for utilizada e a correcção tiver sido gerada numa plataforma diferente (por exemplo, Linux vs. Windows).
- URL - a correcção está localizada na URL facultada. Aviso: Certifique-se de que a URL que introduziu é válida e contém a correcção apropriada.
Caso contrário, não será capaz de a aplicar. Igualmente, recorde-se de que a aplicação de uma correcção directamente de uma URL pode demorar algum tempo.
- Espaço de trabalho - a correcção foi guardada algures no
espaço de trabalho.
Fazer clique em Seguinte para ver o efeito da aplicação da correcção.
-
Passo opcional: este passo é para ser utilizado apenas se tiver uma correcção com raiz no projecto ou no nível de selecção - as correcções com raiz no espaço de trabalho irão proceder automaticamente para a página Pré-visualizar correcção. Na página Especificação de correcção de destino, deve
seleccionar o recurso que deve actuar como raiz da correcção.
-
Passo opcional: este passo é para ser utilizado apenas se a sua correcção se referir a projectos que não são acessíveis - se todos os projectos da correcção estiverem presentes no espaço de trabalho e abertos, esta página será ignorada. Na página Projectos não acessíveis, pode abrir qualquer projecto fechado. Para além disso, podem ser visualizados detalhes sobre projectos não existentes.
Não é possível aplicar uma correcção a projectos que estão fechados ou que não existem no espaço de trabalho.
-
Na última página, faça clique em Terminar para pré-visualizar as alterações da correcção na vista Sincronizar.
Opções para aplicar uma correcção
Para obter correspondências com êxito do ficheiro de correcção, tem as seguintes opções:
-
Volte à primeira página do assistente Aplicar correcção e seleccione o recurso actual para o qual deverá ser aplicada a correcção.
-
Se um prefixo comum dos nomes de caminho armazenados no ficheiro de correcção não corresponder aos nomes de caminhos no espaço de trabalho actual, pode Ignorar segmentos de nome do caminho iniciais.
-
Use 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 ficheiro de correcção e os ficheiros no espaço de trabalho.
-
Ajuste o Factor fuzz (terminologia de correcção). Este factor indica a quantidade de linhas de contexto da parte a ignorar.
Se o valor do factor Fuzz for zero todas as linhas devem corresponder.
Se o factor fuzz for superior a zero, por exemplo 2, as primeiras duas linhas de contexto antes de hunk e as duas últimas linhas de contexto após hunk são ignoradas.
Clique em Guess para calcular o factor fuzz que permite a correspondência entre a maioria dos hunks.
-
Use a opção Reverter correcção para ficheiros de correcção que já tenham sido aplicados no seu espaço de trabalho. Esta opção também é útil para anular ou repetir uma correcção.
-
Em correcções de espaço de trabalho, pode seleccionar outro projecto no espaço de trabalho para aplicar as alterações. Para tal, seleccione um projecto da parte superior da área da janela e seleccione Mover no menu contextual. Este procedimento lançará uma caixa de diálogo
com uma lista de todos os projectos disponíveis no espaço de trabalho. Seleccione um projecto e faça clique em OK. As alterações da correcção serão aplicadas ao projecto seleccionado.
-
Use a opção Mostrar Exclusões para mostrar os hunks que já seleccionou para não incluir na correcção.
-
Ao sincronizar com uma correcção, as opções acima indicadas estão disponíveis no menu pendente da vista Sincronizar.
Pode igualmente comutar entre os modelos disponíveis para obter informações extra sobre as alterações que vão ser aplicadas.

Programação em equipa com CVS

Comparar recursos
Sincronizar com o repositório

Equipa
CVS