Repositório CVS

O repositório CVS para o projecto já contém versões vazias de todos os projectos (i.e., já foi feito o "import" inicial). O repositório está disponível no AFS em:

  • /afs/ist.utl.pt/groups/leic-po/po11/cvs

Assim, os valores possíveis para a variável de ambiente CVSROOT ou pela opção -d do comando "cvs") são:

  • /afs/ist.utl.pt/groups/leic-po/po11/cvs (disponível em qualquer máquina com AFS e utilizador com token válido para a célula ist.utl.pt)
  • :ext:ist1#####@sigma.ist.utl.pt:/afs/ist.utl.pt/groups/leic-po/po11/cvs (disponível via SSH; verificar que CVS_RSH=ssh; ##### é o número de aluno)
Cada projecto no repositório já tem o seguinte conteúdo ( a estrutura apresentada não pode ser alterada ):
  • Makefile (makefile "principal" -- repete a acção sobre as secundárias)
  • sonet-core (directoria principal da biblioteca com a funcionalidade sem interface "gráfica")
  • sonet-core/Makefile (makefile secundária, semelhante à disponibilizada no "core" da aplicação bancária)
  • sonet-core/src (directoria onde deve residir o código do "core", à semelhança do que acontece na aplicação bancária)
  • sonet-textui-manager (directoria correspondente interface de gestão baseada em texto)
  • sonet-textui-manager/Makefile (makefile secundária, semelhante à disponibilizada na biblioteca "textui" da aplicação bancária)
  • sonet-textui-manager/src (directoria onde deve residir o código d a interface de gestão, à semelhança do que acontece com a biblioteca equivalente na aplicação bancária)
  • sonet-textui-browser (directoria correspondente interface de navegação baseada em texto)
  • sonet-textui-browser/Makefile (makefile secundária, semelhante à disponibilizada na biblioteca "textui" da aplicação bancária)
  • sonet-textui-browser/src (directoria onde deve residir o código d a interface de navegação, à semelhança do que acontece com a biblioteca equivalente na aplicação bancária)
  • sonet-tests (directoria principal da biblioteca de testes de unidade)
  • sonet-tests/Makefile (makefile secundária da biblioteca de testes de unidade)
  • sonet-tests/src (directoria onde deve residir o código d a biblioteca de testes de unidade)

Os alunos que ainda não visitaram o self-service do CIIST  [  https://ciist.ist.utl.pt/servicos/self_service/ ], devem fazê-lo, para activação dos serviços relevantes (AFS e Shell, pelo menos). Sem isso, não conseguirão desenvolver ou entregar o projecto, reprovando à disciplina.

ATENÇÃO AOS SEGUINTES ASPECTOS

NÃO FAZER

  • cvs init (não é necessário: o repositório já existe)
  • cvs import (não é necessário: o projecto já existe)
  • cd / afs/ist.utl.pt/groups/leic-po/po11/cvs (ou qualquer outra manipulação directa do repositório: toda a interacção com o repositório deve ser limitada ao comando "cvs")

FAZER

Antes de tudo o mais, fazer cópias de segurança (vulgo "backups") de tudo o que já foi feito.
Admitindo que já teve início o desenvolvimento de uma biblioteca do projecto (por exemplo, o "core" -- para o "textui" é semelhante) e que o código está em DIRECTORIA, para adicionar ficheiros à biblioteca correspondente sob o controlo do CVS, devem ser seguidos os seguintes passos (caso não tenha tido início o desenvolvimento do projecto, então executar primeiro os passos do "quick-and-dirty guide" -- http://bit.ly/9FOWe1):

  1. cd DIRECTORIA/.. (ir para a directoria mãe de DIRECTORIA)
  2. cvs co ### (é criada uma directoria controlada pelo CVS com o nome ### , com a estrutura apresentada acima) (onde os # representam o número do grupo com três algarismos)
  3. Mover/copiar o material interessante de DIRECTORIA para o local adequado do projecto (designado pelo nome local-adequado ), i.e., para a biblioteca adequada -- ver directorias possíveis acima
  4. cd local-adequado
  5. cvs add ficheiro1 ficheiro2 ... ficheiro3 (adicionar ficheiros ao projecto no CVS)
  6. cvs update (verificar que não foi esquecido nenhum ficheiro importante: voltar a 5 até terem sido todos adicionados)
  7. cvs commit (enviar alterações para o repositório)

OBSERVAÇÕES IMPORTANTES

  • No ponto 5 acima, é importante notar que quando se quer adicionar o conteúdo de uma (sub)directoria, deve ser primeiro adicionada a própria directoria e, só depois, o seu conteúdo.
  • Não adicionar cópias das bibliotecas po-uilib, sonet-core-support ou sonet-textui-support ao projecto (serão removidas e quaisquer alterações perdidas).
  • Pessoas sem área no AFS ou sem login no Sigma não poderão aceder ao conteúdo do repositório ou às imagens das máquinas virtuais: para activar estes acessos, consultar o self-service do CIIST. Em caso de dificuldade, consultar o corpo docente.
  • A estrutura do projecto no CVS deve ser mantida como apresentado e cada biblioteca do projecto deve ser semelhante, em estrutura, às apresentadas para a aplicação bancária.
Agradece-se a comunicação de eventuais problemas.