Obter um Módulo do Repositório

Agora que você definiu com sucesso a localização do seu repositório e importou os ficheiros iniciais para o repositório, é a altura de obter o módulo do repositório do CVS para criar a sua área de trabalho.

Você deverá também saber, se necessário, o nome da ramificação ou marca que deseja usar.

As ramificações de um módulo são versões paralelas deste. Um bom exemplo da vida real do uso desta funcionalidade é o lançamento de um projecto de 'software'. Depois de uma versão importante ter saído, existem erros no código que deverão ser corrigidos, mas as pessoas poderão também querer adicionar novas funcionalidades à aplicação. É bastante complicado fazer ambas as coisas ao mesmo tempo, porque as novas funcionalidades introduzem normalmente erros novos, tornando difícil lidar com os antigos. Para resolver este dilema, o CVS permite-lhe criar uma versão paralela, a qual será chamada a ramificação de lançamento estável, onde só poderá adicionar correcções de erros, deixando o ramo principal (HEAD) aberto para a adição de novas funcionalidades.

As marcas ou 'tags' são usadas para marcar uma versão de um projecto. O CVS assinala uma dada versão de cada ficheiro com essa marca para que, quando desejar obter ou actualizar para uma dada marca, você obtenha sempre as mesmas versões dos ficheiros. Como tal, em oposição às ramificações ('branches'), as marcas não são dinâmicas: você não poderá desenvolver sobre uma marca. As marcas são úteis para repor o projecto num estado anterior, reproduzir e analisar erros, marcar as versões de lançamento, as grandes alterações no código, etc.

Figura 2.3. Uma imagem da janela de 'checkout' do Cervisia

Uma imagem da janela de 'checkout' do Cervisia

Repositório:

O nome do repositório do CVS, também conhecido por $CVSROOT. A lista em baixo apresenta os repositórios que você introduziu anteriormente com a janela Configurar o Acesso aos Repositórios. Se o repositório for remoto, certifique-se que a autenticação resulta; veja isso em “Aceder ao Repositório”.

Módulo:

O nome do módulo a ser obtido. Se você está a trabalhar com um repositório existente, você poderá obter provavelmente este nome do administrador de sistemas ou, se for um repositório 'open source', você poderá obter os nomes dos módulos das páginas Web dos projectos. Se quiser criar um novo módulo do zero com um repositório local, basta criar uma pasta nova na pasta de raiz do repositório local. O nome da pasta será o mesmo que o nome do módulo vazio.

Em alternativa, se o repositório tiver um ficheiro $CVSROOT/modules, você poderá obter uma lista com os módulos disponíveis se carregar no botão Obter a lista.

Lembre-se que é possível obter apenas qualquer subpasta existente do módulo, sem obter todo o resto do módulo. Basta indicar também a localização da subpastas.

Marca de ramificação:

O nome da ramificação ou marca que deseja obter. Se deixar este campo em branco, o Cervisia irá obter a ramificação principal (a HEAD).

Pasta de trabalho:

A pasta para onde será transferido o módulo. Tenha em atenção que a pasta de topo da cópia de trabalho é sempre criada como uma pasta com o nome do módulo, sob a pasta que é aqui indicada, a menos que tenha indicado um nome alternativo no campo Extrair como:.

Extrair como:

Isto faz com que os ficheiros sejam extraídos para uma pasta alternativa, sob a pasta de trabalho, em vez de ir para uma pasta com o nome do módulo.

Exportar apenas

Se você assinalar esta opção, os ficheiros serão exportados em vez de ser feito um 'checkout'. A exportação obtém uma cópia dos ficheiros do módulo sem as pastas administrativas do CVS. Por exemplo, a exportação poderá ser usada para preparar o código-fonte para um lançamento.

Extrair recursivamente

Obtém todos os ficheiros e pastas de forma recursiva.