Como Contribuir/CVS
Origem: ACBr, a enciclopédia livre.
| Conteúdo |
O que é CVS ?
Uma alternativa para ter sempre a ultima versão do projeto (a de desenvolvimento), é fazer download via CVS.
O projeto ACBr e a força tarefa do gbBoleto no ACBr usam um sistema de controle de versão chamado CVS. Os sistemas de controle de versão visam simplificar a colaboração entre equipes e ainda controlar o histórico de atualizações dos arquivos. O CVS guarda todas as alterações em cada arquivo como uma versão numerada e sempre que necessário podemos comparar ou até mesmo voltar para uma versão anterior, sem deixar de ter a versão mais atual guardada do repositório (servidor do CVS).
Este sistema é disponibilizado pelo Sourceforge para o projeto e tem duas modalidades de acesso. Um acesso anônimo somente de leitura e um acesso via SSH com permissão de escrita (também conhecida como "commiter"). As contas de commiter serão dadas pelo mérito (leia sobre meritocracia), portanto é um processo natural. Não há a necessidade de pedir por este tipo de conta, se você têm contribuido para o projeto e a equipe de desenvolvedores sente que você já compreendeu as metodologias e processos envolvidos, uma conta de commiter será oferecida a você.
Para acesso anônimo, a linha de conexão do CVS é:
cvs -d:pserver:anonymous@acbr.cvs.sourceforge.net:/cvsroot/acbr login cvs -z3 -d:pserver:anonymous@acbr.cvs.sourceforge.net:/cvsroot/acbr co -P modulo
- A senha de acesso neste caso não existe, simplesmente pressione enter quando questionado pela senha
Para os commiters, a linha de conexão do CVS é:
export CVS_RSH=ssh cvs -z3 -d:ext:nome_do_usuario@acbr.cvs.sourceforge.net:/cvsroot/acbr co -P modulo
- Troque o nome_do_usuario pelo nome do seu usuário no SourceForge
- A senha de acesso neste caso será sua senha de acesso do SourceForge
Os módulos disponíveis no CVS são:
ACBr - Código do projeto Automação Comercial Brasil (ACBr) gbBoleto - Código do esforço de atualização do projeto gbBoleto ou Delphi-Boleto
- Atenção: maiúsculas e minúsculas fazem diferença nas chamadas ao CVS
Mais informaçoes sobre o CVS no SourceForge: (http://sourceforge.net/cvs/?group_id=109206)
CVS no Windows (Tortoise)
O melhor aplicativo a ser usado é o TortoiseCVS (http://www.tortoisecvs.org/download.shtml), pois ele se integra com o Windows Explorer.
Se você escolheu a língua portuguesa, quando falamos em "commit", entenda "gravar"; quando falamos em "update", entenda "atualizar" e quando falamos em "checkout" entenda "obter módulo".
- Baixe o TortoiseCVS (http://www.tortoisecvs.org):
- Depois de Instalado, crie um diretório para o baixar o ACBr
- Usando o Windows Explorer, clique com o botao direto sobre o diretorio e escolha: CVS, Obter Módulo
- Em CVSROOT digite: :pserver:anonymous@acbr.cvs.sourceforge.net:/cvsroot/acbr
- Pasta do repositório: /cvsroot/acbr
- Usuário: anonymous
- Modulo: ACBr (use as Maiusculas e Minusculas corretamente)
- Modulo: gbBoleto (Esforço para criar uma versão com correções no Delphi-Boleto)
- Pasta do repositório: /cvsroot/acbr
- Basta clicar em OK e o Tortoise irá criar a Estrutura de diretótorios do ACBr atualizado exatamente como utilizado pelos desenvolvedores....
- Nas próximas vezes, basta clicar com o Botao direito no diretorio e usar: CVS Atualizar.
- Nesse caso somente os fontes modificados ou novos serão baixados.
Obs: Se o Tortoise perguntar pela Senha, apenas tecle ENTER. Não é necessária nenhuma senha para Download anônimo.
CVS no Linux
O primeiro passo no Linux é instalar o cvs propriamente dito.
Com KDE
No KDE, pode ser usado o cervisia que se integra com o navegador (Konqueror).
Com Gnome
No Gnome pode ser usado o próprio cervisia ou o gcvs.
