<para>O <ulink url="http://www.kde.org/apps/cervisia/">&cervisia;</ulink> é uma interface amigável com o usuário para o sistema de controle de versão. O objetivo é suportar o &CVS; e outros programas de sistemas de controle de versão em uma interface unificada, com recursos de resolução de conflitos, visualizadores de diferenças e histórico, estado para as cópias de trabalho dos arquivos, e suporte para maioria das funções de controle. Você pode obter o &cervisia; compilando o módulo do tdesdk ou instalando o pacote tdesdk fornecido por sua distribuição. Atualmente, somento o &CVS; é suportado, mas outros sistemas de controle de versão serão integrados no futuro. </para>
<para>Um sistema de controle de versão é uma ferramenta para gravar, gerenciar e distribuir diferentes versões de arquivos. O &CVS; é um sistema de controle de versão. Ele permite compartilhar suas modificações facilmente, bem como que cada contribuidor possa trabalhar em sua cópia local ao mesmo tempo, sem medo de sobrescrever modificações feitas por outros. Ele permite a recuperação de versões antigas (útil para análise de erros), a criação de ramificações (para desenvolvimento experimental ou para lançamentos de código) e mais. </para>
<para>O <firstterm>repositório</firstterm> principal normalmente mantém um projeto colaborativo (comercial ou não), mas você pode aproveitar as vantagens dos excelentes recursos de controle de revisão oferecidos pelo &CVS; também para um projeto desenvolvido exclusivamente por você. É fácil configurar um repositório local, e você terá a habilidade de rastrear as mudanças que causaram erros, reverter mudanças, prevenir perda acidental de informação, &etc; </para>
<para>O repositório mantém os arquivos do projeto, e cada contribuidor mantém sua própria cópia local, chamada <firstterm>cópia de trabalho</firstterm> ou <firstterm>área local</firstterm>. Um contribuidor pode adicionar suas modificações no repositório principal (um processo chamado "envio") e/ou atualizar sua própria cópia para refletir as mudanças recentes feitas por outros contribuidores. </para>
<para>Nesta seção, nós mostraremos como usar as funcionalidades básicas do sistema de controle de versão usando o &cervisia;, basicamente para copiar módulos do repositório e trabalhar com eles. Para fazer isto, você deve ter acesso ao repositório como um cliente, ou seja, alguém (provavelmente o administrador do repositório &CVS;) deve lhe fornecer uma conta na máquina servidora. Alternativamente, você pode facilmente criar um repositório local para seu próprio projeto. </para>
<tip><para>Se você planeja desenvolver um projeto complexo, é uma boa idéia usar os recursos do &CVS;, mesmo que você seja o único desenvolvedor. Você pode fazer todas as mudanças em sua cópia de trabalho e usar o &cervisia; (ou qualquer outra ferramenta &CVS;) para atualizar e enviar. Deste modo, você obterá a habilidade de rastrear mudanças que causem erros, reverter mudanças, evitar perda acidental de informação, &etc;. Usando o &cervisia; é simples criar um repositório local. </para>
<step><para>Abra o diálogo <guilabel>Criar Novo Repositório (cvs init)</guilabel> escolhendo <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Criar...</guimenuitem></menuchoice>. </para></step>
<step><para>Pressione o botão <guilabel>...</guilabel> para selecionar a pasta onde você deseja criar o repositório, ou insira sua localização na caixa de texto. Por exemplo, se você deseja colocar o repositório na pasta <filename>/home/usuario</filename>, e nomeá-lo como <filename>raizcvs</filename>, você deve digitar <filename>/home/usuario/raizcvs</filename> na caixa de texto, ou selecionar a pasta <filename>/home/usuario</filename> usando o selecionador de arquivo e adicionar <filename>raizcvs</filename>. </para></step>
<step><para>Confirme pressionando o botão <guibutton>OK</guibutton>. O &cervisia; criará e inicializará a nova pasta do repositório. </para></step>
<step><para>Agora você pode importar seu trabalho atual para o repositório, ou simplesmente criar uma pasta no repositório para iniciar um novo módulo a partir do zero. </para></step>
<para>O &cervisia; oferece uma interface integrada para gerenciar todas as localizações de seus repositórios, o diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>. Para exibí-lo, selecione o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para>
<para>Existem diversos métodos de acesso a um repositório CVS. Ele pode ser acessado através de um autenticação por senha (:pserver:), shell seguro (usando :ext:), repositório local (:local:), &etc;. O formato para a localização do repositório é (ítens opcionais aparecem entre colchetes): </para>
<para>Nem todos os ítens (usuário, senha, nome da máquina, porta) são sempre necessários para acessar o repositório. As informações necessárias dependem do método de acesso usado, que pode ser categorizado como se segue: </para>
<para>O método de acesso local é o método padrão usado pelo &CVS;. Logo, é opcional adicionar o método :local: à localização do repositório. Você pode inserir simplesmente o caminho para a pasta que armazena o repositório &CVS;, e é acessível de seu computador, como <filename class="directory">/caminho/para/repositório</filename> ou para fornecer um exemplo da vida real, <filename class="directory">/home/cvs</filename>.</para>
<para>Ela pode estar fisicamente em um disco que é montado via <acronym>NFS</acronym>, mas este é um detalhe irrelevante. Se você criar um repositório local, a localização será simplesmente o caminho para ele. </para>
<para>A localização do repositório se parece com algo como <filename>:ext:usuario@maquina.url.org:/caminho/para/repositorio</filename> </para>
<para>Este método necessita que você tenha uma conta de usuário na máquina servidora (neste exemplo, <systemitem class="systemname">maquina.url.org</systemitem>) e use um shell remoto para comunicação. Por padrão, o &CVS; usa o ↱ para esta finalidade, no entanto, o ↱ é considerado muito inseguro, e é freqüentemente substituído pelo &ssh;. </para>
<para>Se você usar o &ssh;, você deve configurar a variável de ambiente $<envar>CVS_RSH</envar> para &ssh; quando usar o cliente <command>cvs</command>. O &cervisia; suporta isto facilmente. </para>
<para>Observe que o &cervisia; não pode responder a possíveis solicitações de senha da máquina servidora. Você deve certificar-se que um login remoto trabalhe sem requisitar que você insira a senha. Com o ↱, isto pode ser conseguido por exemplo criando um arquivo <filename>.rhosts</filename> em sua pasta pessoal com uma lista de máquinas confiáveis (veja o manual do ↱). </para>
<para>Com o &ssh;, isto pode ser conseguido copiando sua chave pública localizada no arquivo <filename>identity.pub</filename>, localizado na pasta <filename>$<envar>HOME</envar>/.ssh</filename> para o servidor. Neste caso, a chave não deve estar criptografada com a frase-senha (veja o manual do &ssh; e o <acronym>FAQ</acronym> do &CVS;/<acronym>SSH</acronym> no SourceForge). Se você não tem certeza de como fazer isso, pergunte ao seu administrador de sistema. </para>
<para>Este método acessa o servidor através de um protocolo especial com um autenticação relativamente fraca (<literal>pserver</literal> pede por uma autenticação de senha). Antes de você poder usar um servidor, você precisa de um nome de usuário e senha fornecidos pelo administrador do servidor &CVS;, e deve realizar o login. Observe que seu nome de usuário e senha para o &CVS; não precisam necessariamente corresponder aos do sistema. Antes de acessar o servidor &CVS;, você precisará logar-se. </para>
<para>Projetos de código aberto oferecem tipicamente acesso por CVS Anônimo aos seus códigos. Isto significa que você pode facilmente obter os códigos mais atualizados, modificar e criar remendos (diferenças) com base no repositório sem necessitar de uma conta CVS. Como uma regra geral, o CVS Anônimo usa autenticação por senha (:pserver:), e é um repositório somente de leitura, não permitindo que você envie suas mudanças diretamente. </para>
<step><para>Abra o diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel> selecionando o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para></step>
<step><para>Pressione o botão <guilabel>Adicionar...</guilabel> para abrir o diálogo <guilabel>Adicionar Repositório</guilabel>. </para></step>
<step><para>Insira a localização do repositório na caixa de texto <guilabel>Repositório:</guilabel>. O &cervisia; automaticamente desabilitará áreas do diálogo que não são relevantes ao método de acesso inserido. </para></step>
<step><para>Se você estiver usando o método de acesso ext ao repositório, insira o shell remoto que deseja usar (⪚ &ssh;) na caixa de texto <guilabel>Usar shell remoto (somente para repositórios :ext:):</guilabel>. </para></step>
<step><para>Pressione <guibutton>OK</guibutton>. Você verá o repositório que acabou de inserir na lista de repositórios. </para></step>
<step><para>Se o método de acesso do repositório que você inseriu é autenticado por senha (pserver), você precisará logar-se antes de conectar ao servidor. Clique o repositório na lista para selecioná-lo, e pressione o botão <guilabel>Login...</guilabel>. Insira sua senha no diálogo que é exibido. </para>
<para>Se você inserir com sucesso sua senha, a entrada de coluna <guilabel>Estado</guilabel> do repositório pserver mudará de <guilabel>Não logado</guilabel> para <guilabel>Logado</guilabel>. </para></step>
<step><para>Pressione <guibutton>OK</guibutton> para aplicar suas modificações, ou adicione outra localização à lista. O &cervisia; armazenará tantas localizações quanto desejar. </para></step>
<para>Nesta seção, nós discutiremos como você pode colocar um novo projeto em um repositório &CVS;. Se você apenas deseja trabalhar com um projeto existente que já está em um repositório, você pode pular esta seção. </para>
<listitem><para>Importar os arquivos e pastas para um novo <firstterm>módulo</firstterm>, usando o diálogo de importação do &cervisia;. Módulos são pastas de nível superior na árvore de pastas do repositório &CVS;, e são usados para separar e organizar os diferentes projetos de software dentre do repositório. </para></listitem>
<listitem><para>Criar um módulo vazio e adicionar os novos arquivos e pastas manualmente. Você terá mais controle, mas isto provavelmente demorará um pouco mais. </para></listitem>
<para>Tenha em mente que o &CVS; foi inicialmente desenhado para manipular aquivos texto. Muitos recursos, como mesclagem de revisão, criação de diferenças em uma forma legível, &etc;... somente são executados em arquivos texto. Isto não significa que você não possa usar o CVS para manter arquivos binários, isto somente significa que você deve <emphasis>dizer explicitamente ao CVS se isto é um arquivo texto ou binário</emphasis>. Se você declarar um tipo de arquivo errado, você experimentará problemas com a funcionalidade do &CVS; nestes arquivos, e eles podem ser corrompidos. </para>
<para>Importar um projeto (como um novo módulo) tem algumas vantagens: você importará todos os arquivos e pastas recursivamente, e o módulo automaticamente será criado para você. Isto torna a importação de grandes projetos existentes para o repositório mais fácil. No entanto, existem algumas desvantagens: você não pode usar o diálogo de importação do &cervisia; para adicionar arquivos aos módulos existentes, e você pode tanto importar os arquivos como arquivos texto ou binário. Você pode trabalhar esta limitação criando uma pasta com arquivos de somente um dos tipos, ou informando padrões dos arquivos que devem ser ignorados durante o processo de importação. </para>
<para>Por exemplo, suponhamos que seu projeto contenha somente arquivos texto e algumas imagens PNG (arquivos binários). Você pode dizer ao &CVS; para ignorar todos os arquivos com o padrão <filename class="extension">*.png</filename> enquanto importa qualquer outro arquivo como texto, ou você pode mover as imagens para uma pasta separada, e então importar os arquivos remanescentes (como arquivos texto). De qualquer modo, você terá que <link linkend="checkingout">baixar</link> o novo módulo importado para uma nova cópia de trabalho, copiar os arquivos e pastas que faltam para ele, <link linkend="addingfiles">adicionar</link> e <link linkend="committingfiles">enviar</link> estes arquivos e pastas para o repositório para completar o processo de importação. </para>
<para>Como alternativa, você pode adicionar os arquivos e pastas manualmente, criando um módulo vazio para eles. Para adicionar um módulo vazio ao repositório, simplesmente crie uma nova pasta na pasta raiz do repositório &CVS;. O nome desta nova pasta será o nome do módulo. <link linkend="checkingout">Baixe</link> o novo módulo vazio. Então copie os arquivos e pastas para a cópia de trabalho, <link linkend="addingfiles">adicione</link> e <link linkend="committingfiles">envie</link> estes arquivos e pastas para o repositório &CVS;. </para>
<para>Em <xref linkend="screenshot-import"/> você pode ver o diálogo que o auxilia a <emphasis>importar</emphasis> um projeto como um módulo. Para acessar o diálogo de importação do &cervisia;, selecione o ítem de menu <menuchoice><guimenu>Repositório</guimenu> <guimenuitem>Importar...</guimenuitem></menuchoice>. </para>
<listitem><para>Insira ou seleciona na lista de caixa combinada o nome do repositório &CVS;, também conhecido como $<envar>CVSROOT</envar>. Você deve ter acesso de escrita nele, e o repositório deve ser iniciado corretamente. Se o repositório ainda não existir, você pode criar um selecionando o ítem de menu <menuchoice> <guimenu>Repositório</guimenu> <guimenuitem>Criar...</guimenuitem> </menuchoice>. </para>
<para>A caixa cobinada mostra uma lista de repositórios que você inseriu previamente na caixa de diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>.Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja em <xref linkend="accessing-repository"/> para mais informações. </para></listitem>
<listitem><para>O nome do módulo sob o qual o projeto será armazenado. Após a importação, o projeto pode ser verificado sob este nome. Veja <xref linkend="checkingout"/> para mais informações. Isto é também o nome da pasta correspondente no repositório. </para></listitem>
<term><guilabel>Pasta de Trabalho:</guilabel></term>
<listitem><para>Este é a pasta de nível superior do projeto que você deseja importar. A importação inicia a partir desta pasta e vai descendo recursivamente. </para></listitem>
<term><guilabel>Tag do vendedor:</guilabel> <xref linkend="co-vendortag"/></term>
<listitem><para>A tag do vendedor é historicamente usada para pesquisar por código de outros grupos. Apenas use seu nome de usuário se não tiver melhor idéias. Não faz muita diferença o que você insere aqui. </para></listitem>
<term><guilabel>Tag da versão:</guilabel> <xref linkend="co-releasetag"/></term>
<listitem><para>Esta tag é também historicamente usada para importar diferentes versões de softwares de outros grupos. Se você não está fazendo isto, usa a palavra <literal>start</literal> ou um string <literal>FOO_1_0</literal> onde <literal>FOO</literal> é o nome do seu projeto e <literal>1.0</literal> é o número de versão do módulo importado. </para></listitem>
<listitem><para>Se você preencher este campo, uma opção adicional <option>-I <replaceable>nomes de arquivo</replaceable></option> é fornecida para o comando <command>cvs import</command>. Esta entrada é interpretada como uma lista separada por espaços em branco de padrões de nomes de arquivo que serão ignorados. Em geral, uma maneira limpa e menos suscetível a erros de controlar quais arquivos irão para o repositório é criar uma pasta somente com os arquivos que você deseja importar e iniciar a partir dela. No entanto, esta entrada pode ser útil se o projeto contém arquivos que serão ignorados por padrão pelo &CVS;, ⪚ arquivos com o nome <filename>core</filename>. Neste caso, simplesmente insira o caracter <literal>!</literal> neste campo. Isto sobrepõe-se as regras de esquema do &CVS; de arquivos ignorados, veja <xref linkend="ignoredfiles"/>. </para></listitem>
<listitem><para>Use este campo para gravar os comentários que você deseja fazer sobre o origem, usuário, desenvolvimento, &etc;, dos arquivos que você está importando. </para></listitem>
<term><guilabel>Importar como binários</guilabel></term>
<listitem><para>Se você habilitar esta caixa, todos os arquivos serão importados no modo binário, por ex. um argumento <option>-kb</option> é fornecido ao <command>cvs import</command>. </para></listitem>
<term><guilabel>Usar a modificação do arquivo como hora de importação</guilabel></term>
<listitem><para>Se você habilitar esta caixa, a hora de importação será a hora de modificação do arquivo ao invés da hora de importação. </para></listitem>
<para>Agora que você definiu com sucesso sua localização do repositório, e importou os arquivos iniciais para o repositório, é hora de obter o módulo do repositório &CVS;, criando sua cópia de trabalho. </para>
<para>Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para>
<para>Tags são usadas para marcar uma versão do projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você baixa ou atualiza para uma tag específica, você obterá as mesmas versões de arquivo. No entanto, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar versões, grandes mudanças no código, &etc;. Usando tags, você pode facilmente retornar o projeto a um estado anterior, para reproduzir e rastrear erros, gerar o código de lançamento novamente, &etc;. </para>
<listitem><para>O nome do repositório &CVS;, também conhecido como <filename><envar>$CVSROOT</envar></filename>. A caixa combinada mostra uma lista dos repositórios que você inseriu previamente usando a caixa de diálogo <guilabel>Configurar Acesso aos Repositórios</guilabel>. Se o repositório é remoto, certifique-se de que a autenticação funciona. Veja <xref linkend="accessing-repository"/> para mais informações. </para></listitem>
<listitem><para>O nome do módulo a ser baixado. Se você estiver trabalhando com um repositório existente, você provavelmente poderá obter este nome a partir do administrador do sistema, ou se ele é um repositório de código aberto, você pode obter os nomes dos módulos a partir das páginas web do projeto. Se você deseja criar um novo módulo a partir do zero usando um repositório local, simplesmente crie uma nova pasta na pasta raiz do repositório local. O nome da pasta será o mesmo do módulo vazio. </para>
<para>Alternativamente, se o repositório possui um arquivo <filename><envar>$CVSROOT</envar>/modules</filename>, você pode obter uma lista dos módulos disponíveis clicando no botão <guibutton>Obter lista</guibutton>. </para>
<para>Observe que é possível baixar qualquer subpasta existente do módulo, sem obter o resto do módulo. Simplesmente insira o caminho para a subpasta. Por exemplo, se você deseja obter somente a subpasta <filename class="directory">doc/cervisia</filename> do módulo tdesdk, insira <filename class="directory">tdesdk/doc/cervisia</filename> neste campo. </para></listitem>
<listitem><para>O nome da ramificação ou tag que você deseja baixar. Se você deixar este campo vazio, o &cervisia; obterá a ramificação principal (HEAD). </para></listitem>
<term><guilabel>Pasta de trabalho:</guilabel></term>
<listitem><para>A pasta na qual o módulo deve ser baixado. Observe que a pasta de nível superior da cópia de trabalho é nomeada após o módulo que você está obtendo, a menos que você forneça um nome alternativo no campo <guilabel>Baixar como:</guilabel>. </para></listitem>
<listitem><para>Isto faz com que os arquivos da cópia de trabalho sejam baixados em uma pasta alternativa dentro da pasta de trabalho ao invés de usar a pasta com o nome do módulo. </para></listitem>
<listitem><para>Se habilitar esta caixa, os arquivos serão exportados ao invés de atualizados. Exportar obtém uma cópia do código para o módulo sem as pastas administrativas do CVS. Por exemplo, exportar pode ser usado para preparar o código fonte para lançamento. </para></listitem>
<title>A Tela Principal, Visão do Estado do Arquivo e Atualização</title>
<para>Quando você inicia o &cervisia; e abre uma cópia de trabalho selecionando <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Abrir Área Local...</guimenuitem> </menuchoice> você pode ver duas áreas principais na janela principal do &cervisia;: a superior é uma visão hierárquica (em árvore) da cópia de trabalho atual, e a inferior é usada para exibir os comandos &CVS; que o &cervisia; envia para realizar suas tarefas, bem como a saída gerada por estes comandos. </para>
<para>Por padrão o &cervisia; não exibe os arquivos contidos nas subpastas, de modo que você terá que clicar nas pastas se desejar vê-los. Para exibir todos os arquivos da cópia de trabalho, selecione <menuchoice> <guimenu>Ver</guimenu> <guimenuitem>Expandir a Árvore de Arquivos</guimenuitem> </menuchoice>. Para fechar todas as pastas de sua cópia de trabalho, selecione <menuchoice> <guimenu>Ver</guimenu> <guimenuitem>Recolher a Árvore de Arquivos</guimenuitem> </menuchoice>. </para>
<para>De acordo com as configurações de seu arquivo <filename>.cvsignore</filename>, os arquivos que você normalmente não quer incluir no repositório - como por exemplo arquivos de objeto - não são exibidos na visão em árvore. Para cada arquivo, você vê seu estado correspondente. Na configuração padrão, após abrir uma área local, ele é "Desconhecido" porque o &cervisia; aguarda para atualizar as informações até você selecionar os arquivos e pastas que deseja ver o estado ou atualizar e selecionar <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Atualizar</guimenuitem> </menuchoice> ou <menuchoice> <guimenu>Arquivo</guimenu> <guimenuitem>Estado</guimenuitem> </menuchoice>. Com este comportamento, você tem um mínimo de funcionalidade disponível caso você não tenha uma conexão permanente com o servidor &CVS;. </para>
<para>Os comandos no menu Arquivo normalmente agem somente nos arquivos que você tenha marcado. Você pode também marcar pastas. Agora escolha <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Estado</guimenuitem></menuchoice> ou pressione <keycap>F5</keycap>. O &cervisia; envia um comando </para>
<para>para obter informações de estado dos arquivos marcados. Observe que o &cervisia; age recursivamente nas subpastas somente se você tiver configurado esta opção no menu <guimenu>Configurações</guimenu>. De acordo com o respectivo estado do arquivo, você agora pode ver uma entrada na coluna <guilabel>Estado</guilabel>: </para>
<listitem><para>Isto significa que o arquivo não existe no repositório, mas em sua cópia de trabalho e você deve agendá-lo para adição. A inserção atual no repositório somente acontecerá após um envio. </para></listitem>
<listitem><para>Isto significa que você tem agendado o arquivo para remoção, mas ele ainda existe no repositório. A remoção atual acontecerá somente após um envio. </para></listitem>
<term><guilabel>Precisa de Atualização</guilabel></term>
<listitem><para>Isto é mostrado se uma nova versão do arquivo existe no repositório, por exemplo porque alguém enviou uma modificação. Normalmente, você desejará atualizar este arquivo para que não tenha uma versão desatualizada em sua pasta. </para></listitem>
<term><guilabel>Precisa de Remendo</guilabel></term>
<listitem><para>Isto é essencialmente o mesmo que o anterior; a diferença é que no caso de uma atualização, o servidor &CVS; transferirá somente um remendo ao invés de todo o arquivo para você. </para></listitem>
<listitem><para>Indica que uma mesclagem da revisão deste arquivo na sua cópia de trabalho com a versão no repositório é necessária. Isto tipicamente acontece caso você tenha feito modificações no arquivo enquanto alguém já tenha enviado suas próprias modificações. Se você escolher atualizar, as modificações no repositório serão mescladas em seu arquivo. No caso de conflito (por exemplo se alguém também modificou as mesmas linhas que você) o novo estado será então "Conflito". </para></listitem>
<listitem><para>Isto é mostrado se o arquivo ainda possui conflitos marcados nele. Talvez você tenha previamente atualizado o arquivo e não resolvido os conflitos. </para></listitem>
<listitem><para>Indica que o arquivo não está registrado no repositório &CVS;. Se você deseja torná-lo disponível para outros, você deve adicioná-lo ao repositório. Caso contrário, você deve considerar a adição dele ao seu arquivo <filename>.cvsignore</filename>. </para></listitem>
<para>Agora que você possui uma visão geral do estado atual do CVS, você pode querer realizar uma atualização. Marque alguns arquivos (ou a raiz da árvore de pastas o que é equivalente a marcar todos os arquivos nesta pasta). Agora escolha <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Atualizar</guimenuitem> </menuchoice> (É claro, você pode já ter selecionado isto no início desta sessão). Para a maioria dos arquivos o estado deve mudar agora. Tipicamente, arquivos que "Precisam de Remendo" ou "Precisam Atualizar" serão atualizados. Logo os seguintes novos ítens são possíveis na coluna de estado: </para>
<listitem><para>Indica que o servidor &CVS; enviou um remendo para este arquivo e o remendo foi aplicado com sucesso. Se o remendo não foi aplicado com sucesso devido a um conflito entre suas modificações e as de alguém que já havia enviado para o repositório, o estado agora é<guilabel>Conflito</guilabel>. </para></listitem>
<para>Você deve ter observado que de acordo com o estado do arquivo, sua linha possui uma cor diferente. As cores são escolhidas de modo a refletir a prioridade do estado. Por exemplo, um arquivo com um conflito é marcado em vermelho para mostrar-lhe que deve resolver o conflito antes de continuar o trabalho com o arquivo. Se sua pasta contém um grande número de arquivos, você pode apesar disso perder da visão geral. Para obter informações mais concisas sobre quais arquivos possuem um estado incomum, simplesmente clique no cabeçalho da coluna <guilabel>Estado</guilabel>. A lista de arquivos é então ordenada por prioridade, de modo que você tenha todas informações importantes na parte superior da lista. Para retornar à visão ordenada alfabeticamente, clique no cabeçalho da coluna <guilabel>Nome do arquivo</guilabel>. </para>
<para>Todas as funcionalidades normalmente usadas no &CVS; estão diretamente disponíveis na janela principal do &cervisia;. Comandos usualmente agem em diversos arquivos ao mesmo tempo, atingindo todos que estão selecionados atualmente. Se a seleção inclui pastas, esta interpretação depende das configurações feitas no menu <guimenu>Configurações</guimenu>. Por exemplo, se <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Enviar e Remover Recursivamente</guimenuitem></menuchoice> estiver habilitado e você escolher <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Enviar...</guimenuitem></menuchoice> quando uma pasta estiver selecionada, então todos os arquivos na árvore sob esta pasta são atualizados. Caso contrário, somente os arquivos regulares na pasta serão afetados. </para>
<para>A maioria das ações estão também disponíveis com um clique direito sobre os arquivos na visão em árvore, através do menu de contexto. <xref linkend="screenshot-popup"/> mostra o menu de contexo na janela principal do &cervisia;. </para>
<para>Você pode simplesmente editar um arquivo com um duplo-clique sobre ele ou selecionando-o e pressionando &Enter;. Isto inicia o aplicativo padrão que manipula aquele tipo de arquivo (o aplicativo padrão para cada tipo de arquivo é uma configuração geral do KDE). Se o aplicativo padrão não é o que você deseja usar, você pode dar um clique-direito sobre o arquivo e selecionar o submenu <menuchoice> <guisubmenu>Editar Com</guisubmenu> </menuchoice>, e selecionar um dos outros aplicativos que manipulam aquele tipo de arquivo. </para>
<para>Para adicionar arquivos ao projeto são necessários dois passos: Primeiro, os arquivos devem ser registrados no &CVS;, ou em outras palavras, <emphasis>adicionados ao repositório</emphasis>. Isto é necessário, mas não o suficiente. Para colocar os arquivos no repositório, você deve também realizar um <emphasis>envio</emphasis>. Este procedimento tem uma importante vantagem. Você pode realizar um envio dos arquivos junto com modificações de outras partes do projeto. Quando fizer isto, você pode facilmente ver (⪚ nas mensagens de envio) que todas as mudanças são parte de um todo. </para>
<para>Para este fim, marque todos os arquivos a serem adicionados na janela principal do &cervisia;. Então, selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem></menuchoice>, ou clique-direito nos arquivos marcados e selecione <guimenuitem>Adicionar ao Repositório...</guimenuitem>. O diálogo <guilabel>Adicionar ao CVS</guilabel> aparecerá, listando os arquivos que você marcou, e pedindo uma confirmação. Pressione <guibutton>OK</guibutton>. </para>
<para>Se a operação tiver sucesso, a coluna de estado deverá possuir "Adicionado ao repositório" para os arquivos adicionados. </para>
<warning><para>O &CVS; não foi desenvolvido para fornecer um significativo controle de revisão para arquivos binários. Por exemplo, mesclar arquivos binários normalmente não faz sentido. Além do mais, por padrão o &CVS; realiza expansão de palavras chave (⪚ no string <literal>$Revision: 1.6 $</literal>) quando um arquivo é enviado. Em arquivos binários, estas substituições podem corromper o arquivo e fazê-lo completamente inutilizável. </para></warning>
<para>Para desabilitar este comportamento, você deve enviar arquivos binários (ou outros arquivos, como Postscript ou imagens PNG) selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar Binário...</guimenuitem></menuchoice>. O diálogo <guilabel>Adicionar ao CVS</guilabel> aparecerá, listando os arquivos binários que você marcou, e pedindo uma confirmação. Pressione <guibutton>OK</guibutton>. </para>
<para>Como na adição de arquivos, a remoção de arquivos é feita em dois passos: Primeiro, os arquivos devem ser registrados como removidos selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Remover Do Repositório...</guimenuitem></menuchoice> ou clique-direito nos arquivos marcados e selecionando <guimenuitem>Remover Do Repositório...</guimenuitem> a partir do menu de contexto. O diálogo <guilabel>Remover do CVS</guilabel> aparecerá, listando os arquivos que você marcou, e pedindo por uma confirmação. Pressione <guibutton>OK</guibutton>. O &cervisia; envia o comando </para>
<note><para>O comando acima somente funciona se o arquivo estiver atualizado. Caso contrário, você obterá uma mensagem de erro. Este comportamento faz sentido: Se você tem um arquivo modificado em relação à versão do repositório, ou se outro alguém fez qualquer modificação, você desejará primeiro verificar se você realmente quer descartá-lo. </para></note>
<para>Pastas são manuseadas fundamentalmente de maneira diferente de arquivos ordinários pelo &CVS;. Elas não estão sob o controle de revisão, por exemplo você não pode dizer quais pastas existem no projeto em um certo momento. Além do mais, pastas nunca podem ser explicitamente removidas (exceto removendo-as diretamente no repositório). </para>
<para>Como um substituto o &CVS; segue a convenção que uma pasta é "não existente" em uma versão do projeto se ela está vazia. Esta convenção pode ser forçada usando a opção <option>-P</option> para o <command>cvs update</command> e <command>cvs checkout</command>. Esta opção pode ser configurada no menu <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Excluir Pastas Vazias Ao Atualizar</guimenuitem></menuchoice>. </para>
<para>A pasta pode ser adicionanda ao repositório selecionando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem></menuchoice> ou clique direito na pasta marcada e selecionando <guimenuitem>Adicionar ao Repositório...</guimenuitem> no menu de contexto. Observe que ao contrário da adição de arquivos, adicionar pastas não necessita de um envio posterior. O &cervisia; envia o comand </para>
<para>Quando você realiza uma certa quantidade de mudanças em sua cópia de trabalho, e você deseja que outros desenvolvedores tenham acesso a elas, você as <emphasis>envia</emphasis>. Com um envio, você coloca suas versões de arquivos modificados como novas revisões no repositório. Uma atualização subseqüente por outro desenvolvedor trará suas modificações para a cópia de trabalho dele. </para>
<para>Para enviar um conjunto de arquivos, selecione-os na janela principal do &cervisia; e selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Enviar...</guimenuitem></menuchoice> ou clique direito sobre os arquivos marcados e selecione <guimenuitem>Enviar...</guimenuitem> no menu de contexto. </para>
<para>Você obtém um diálogo que mostra uma lista dos arquivos selecionados na seção superiot e uma mensagem de registro para suas mudanças abaixo. O &cervisia; lhe auxilia de diversas formas para encontrar um mensagem de registro significativa. Primeiro, na lista de arquivos você pode dar um duplo-clique em um arquivo ou pressionar <keycap>Return</keycap> para ver as mudanças que você realizou no arquivo. Em segundo, ele lhe oferece uma lista de mensagens de registro que você usou previamente em uma caixa combinada. Em terceiro, este diálogo é integrado com o editor de changelog do &cervisia; descrito abaixo. Quando você tiver terminado o diálogo, o comando </para>
<note><para>Um erro comum que você pode encontrar durante um envio é <errorname>falha na verificação de atualização</errorname>. Isto indica que alguém fez mudanças no repositório desde sua última atualização. Ou mais tecnicamente, que sua revisão <literal>BASE</literal> não é a mais nova do repositório. Neste caso o &CVS; recusa-se a mesclar suas modificações para o repositório. A solução é atualizar, resolver qualquer conflito e sincronizar novamente. É claro, se você está trabalhando no projeto de um software, isto é normalmente uma boa maneira de verificar se o programa ainda funciona após você tê-lo atualizado - além do mais, podem existir interações incorretas entre suas modificações e a de outros desenvolvedores causando uma quebra de código. </para></note>
<para>Outro erro comum resulta na mensagem de erro <errorname>Tag 'X' pregada para arquivo 'X' não está no repositório</errorname>. Isto acontece se você tenta enviar um arquivo que foi trazido previamente para uma determinada revisão ou tag com o comando </para>
<para>(que é ⪚ usada pelo ítem de menu <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para Tag/Data...</guimenuitem></menuchoice>). Neste caso, a tag do arquivo foi pregada, e por isso atualizações posteriores não lhe trarão a revisão mais nova do repositório. Se você deseja enviar futuras revisões para o repositório, você deve atualizar a tag do repositório antes de sincronizações posteriores. </para>
<para>Com o &cervisia;, é muito fácil manter um arquivo de ChangeLog que é compatível com a formatação das linhas guia de codificação GNU. Para usá-lo, selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Inserir Entrada ChangeLog...</guimenuitem></menuchoice>. Se um arquivo com o nome <filename>ChangeLog</filename> existir na pasta de nível superior de sua cópia local, este arquivo será carregado e você terá a possibilidade de editá-lo. Para este fim, na parte superior do arquivo, uma entrada com a data atual e seu nome de usuário (que pode ser configurado como descrito em <xref linkend="customize-general"/>) é inserida. Quando você terminar este diálogo clicando <guibutton>OK</guibutton>, na próxima vez que abrir o diálogo de envio você terá uma mensagem de registro configurada para a mensagem que você inseriu por último no registro de mudanças. </para>
<para>Conflitos podem ocorrer sempre que você tenha feito mudanças em um arquivo que também foi modificado por outro desenvolvedor. O conflito é detectado pelo &CVS; quando você atualiza o arquivo modificado. O &CVS; então tenta mesclar as modificações enviadas por outro desenvolvedor em sua cópia local. A mesclagem falha se tanto a sua modificação como a do outro desenvolvedor estão em partes sobrepostas do arquivo, e o servidor &CVS; envia uma mensagem de erro. </para>
<para>Na janela principal do &cervisia;, arquivos com conflitos são indicados com "Conflito" na coluna de estado e com uma cor vermelha. É seu trabalho agora resolver estes conflitos antes de enviar o arquivo. O &CVS; recusará enviar qualquer arquivo com conflitos até eles serem editados. A partir da janela principal, você pode resolver conflitos da maneira tradicional, é claro: apenas dê um duplo-clique no arquivo em questão e edite-o com seu editor favorito.</para>
<para>Você deve substituir todo este bloco com uma nova versão meslclada.É claro, você tem uma grande liberdade para resolver um conjunto de conflitos: você pode para cada conflito decidir por uma das duas versões alternativas. Você pode também decidir que ambas as versões estão quebradas e reescrever toda a rotina ou o arquivo completo. </para>
<para>Felizmente, o &cervisia; oferece uma bela interface para manipular estes conflitos. Isto não significa que você nunca precisará editar manualmente os arquivos, mas pelo menos pode eliminar a necessidade de fazer isto para a resolução de conflitos triviais. Para usar o diálogo <guilabel>Resolver CVS</guilabel> do &cervisia; selecione <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Resolver...</guimenuitem></menuchoice> ou clique direito no arquivo marcado e selecione <guimenuitem>Resolver...</guimenuitem> no menu de contexto. </para>
<para>No topo do diálogo, você vê <guilabel>Sua versão (A)</guilabel> do arquivo no lado esquerdo e a versão do repositório, <guilabel>Outra versão (B)</guilabel>, no lado direito. As diferenças entre elas estão marcadas com a cor vermelha. Abaixo destas duas versões, você pode ver a <guilabel>Versão mesclada</guilabel>. A versão mesclada reflete que seção estará em sua cópia de trabalho se você pressionar o botão <guibutton>Salvar</guibutton>. </para>
<para>Você pode alternar entre as diferentes seções conflitantes pressionando <guibutton><<</guibutton> e <guibutton>>></guibutton>. Na metade inferior do diálogo você pode ver qual seção está atualmente marcada. Por exemplo, <literal>2 de 3</literal> significa que você está atualmente na segunda seção de diferença de um total de 3. </para>
<para>Agora você pode decidir seção por seção qual das duas versões você deseja que esteja no arquivo mesclado. Pressionando <guibutton>A</guibutton>, você aceita a versão que você editou. Pressionando <guibutton>B</guibutton>, você aceita a versão do repositório. Pressionando <guibutton>A+B</guibutton>, ambas as versões serão adicionadas, e sua versão virá primeiro. O <guibutton>B+A</guibutton> obtém o mesmo resultado, mas a ordem será diferente: primeiro a versão do repositório, depois a sua. </para>
<para>Se você não estiver satisfeito com nenhuma destas versões, pressione <guibutton>Editar</guibutton> para abrir um editor de texto simples de onde você pode editar a seção. Quando você tiver terminado a edição, pressione <guibutton>OK</guibutton> para retornar ao diálogo <guilabel>Resolver CVS</guilabel> e terminar de resolver os conflitos. Você verá a seção que acabou de editar na <guilabel>Versão mesclada</guilabel>, com suas modificações. </para>
<para>Para salvar suas modificações, sobrescrevendo a versão da cópia de trabalho, pressione <guibutton>Salvar</guibutton>. Observe que isto salvará as escolhas nã somente da seção que você está atualmente vendo, mas de todas as seções no arquivo. Se você deseja salvar em outro arquivo, pressione <guibutton>Salvar Como...</guibutton>. Pressione <guibutton>Fechar</guibutton> para sair do diálogo. Se você fechar o diálogo sem salvar, as mudanças serão perdidas. </para>
<listitem><para>Na visão principal, você pode selecionar <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório...</guimenuitem></menuchoice>. Isto é baseado no comando <command>cvs diff</command> e lhe mostra as diferenças entre a versão em sua cópia local e a versão de sua última atualização (também conhecida como <literal>BASE</literal>). Isto é particularmente útil apenas antes de você enviar um arquivo, de modo que você possa encontrar uma mensagem de registro apropriada. </para></listitem>
<listitem><para>Você pode ver as diferenças entra as versões em sua área local e a versão no ramo de desenvolvimento principal (também chamado <literal>HEAD</literal>) selecionando <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Diferença para o Repositório (HEAD)...</guimenuitem></menuchoice>. </para></listitem>
<listitem><para>Você pode ver as diferenças entre as duas últimas revisões do arquivo selecionado escolhendo <menuchoice><guimenu>Ver</guimenu> <guimenuitem>Última Mudança...</guimenuitem></menuchoice>. </para></listitem>
<listitem><para>Você pode acessar os ítens de menu <guimenuitem>Diferença para o Repositório (BASE)...</guimenuitem>. <guimenuitem>Diferença para o Repositório (HEAD)...</guimenuitem> e <guimenuitem>Última Mudança...</guimenuitem> a partir do menu de contexto da visão principal, com um clique direito sobre o arquivo que deseja ver. </para></listitem>
<listitem><para>No diálogo que é mostrado quando você envia um conjunto de arquivos, você pode solicitar uma janela de diferenças selecionando um nome de arquivo na lista de seleção, seja através de um duplo-clique ou pressionando <keycap>Return</keycap>. Isto é idêntico ao uso do <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (BASE)...</guimenuitem></menuchoice> com o respectivo arquivo na janela principal. </para></listitem>
<listitem><para>No diálogo do Navegador de registros, você pode marcar duas revisões de um arquivo e solicitar um diálogo que mostra as diferenças entre eles (veja em <xref linkend="browsinglogs"/>). </para></listitem>
<para>Como você deve esperar, o &cervisia; não apenas exibe a saída do comando <command>diff</command> em seu terminal, mas lhe mostra uma visão gráfica como vista em <xref linkend="screenshot-log"/>. </para>
<para>O testo no diálogo é uma variante melhorada do texto obtido pelo comando diff com a opção <option>-u</option>. Você pode ver as diferentes versões em duas janelas, com linhas arranjadas de modo que você possa fazer uma comparação lado a lado. Quer dizer, onde o texto foi adicionado ou excluído, a janela respectiva mostra linhas vazias com a marca <literal>+++++</literal> no lado esquerdo. Na outra parte, você pode ver o número de execução de cada linha na coluna da esquerda. </para>
<para>Na segunda coluna da janela direita, você pode ver que tipo de mudança foi feita. Tipos possíveis são <literal>Adicionado</literal>, <literal>Excluído</literal> e <literal>Mudado</literal>. As linhas são marcadas respectivamente em azul, verde e vermelho. No meio do diálogo uma imagem comprimida dos marcadores coloridos é mostrada. Deste modo, você pode obter uma visão rápida de todas as mudanças do arquivo. Você pode também usar a posição das regiões coloridas na imagem comprimida como uma orientação de quando usar as barras de rolagem. </para>
<para>Normalmente, as barras de rolagem das janelas esquerda e direita são sincronizadas, isto é se você rolar no lado esquerdo, o lado direito é rolado da mesma maneira. Você pode mudar este comportamente habilitando a caixa <guibutton>Sincronizar barras de rolagem</guibutton>. </para>
<para>Para informações sobre como personalizar o diálogo de diferenças, veja <xref linkend="customize-diff"/>. </para>
<para>Algumas vezes você pode oferecer suas modificações para revisão, antes de enviá-las, ou você não possui acesso de escrita ao repositório (logo você não pode enviar). O &CVS; oferece um formato padrão para compartilhar as modificações em sua cópia de trabalho, de modo que outras pessoas possam revisar suas mudanças, testá-las em suas cópias de trabalho e aplicá-las ao repositório &CVS;. Um arquivo contendo estas diferenças é chamado um <firstterm>remendo</firstterm>, e é gerado pelo comando <command>cvs diff</command>, da mesma maneira que as diferenças são geradas em <xref linkend="diff"/>. Compartilhar remendos ao invés de conjuntos de arquivos consome menos banda de rede, e remendos são mais fáceis de manipular, de modo que você pode enviar um único arquivo de remendo contendo todas as diferenças de diversos arquivos fonte. </para>
<para>O &cervisia;, oferece acesso a este recursos selecionado <menuchoice><guimenu>Avançado</guimenu> <guimenuitem>Criar Remendo Contra Repositório...</guimenuitem></menuchoice>. </para>
<important><para>A ação <guimenuitem>Criar Remendo Contra Repositório...</guimenuitem> cria um remendo com todas as modificações em todos os arquivos em sua cópia de trabalho (área local) contra o repositório <literal>BASE</literal>. Logo, a seleção de arquivos na visão principal não afeta o remendo que será gerado. </para></important>
<para>Outra possibilidade é selecionar um arquivo na visão principal e selecionar <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu <guimenu>Ver</guimenu> ou clique direito no arquivo marcado e selecionar <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu instantâneo, para abrir o <link linkend="browsinglogs">Diálogo do navegador de registro</link>. Agora, selecione a versão contra a qual deseja criar um remendo, como a revisão "A" e pressione o botão <guilabel>Criar Remendo...</guilabel>. Isto irá gerar um remendo com as diferenças entre o <emphasis>arquivo marcado</emphasis> em sua cópia e a versão selecionada com a revisão "A". </para>
<para>Antes de gerar o remendo, o &cervisia; exibe um diálogo permitindo-lhe configurar o formato de saída. </para>
<term><guilabel>Formato de Saída</guilabel></term>
<listitem><para>Existem três formatos de saída disponíveis: </para>
<para><guilabel>Normal</guilabel>: um formato que pode ser usado para fazer com que o editor ed automaticamente crie outra cópia do arquivo antigo correspondendo ao novo arquivo. No formato de saída normal, os caracteres < e > marcam as mudanças, e não existe informação de contexto. </para>
<para><guilabel>Unificado</guilabel>: o formato mais usado para troca de remendos. O formato unificado usa linhas de contexto em adição aos números de linha para gravar as diferenças. Isto torna o processo de aplicação de remendos mais robusto. Este formato exibe as diferenças em uma forma legível e compacta, com um cabeçalho para cada arquivo envolvido, e seções separadas (pedaços) para cada diferença. As linhas de contexto disponíveis para cada diferença torna a leitura das modificações mais fácil. No formato de saída unificado, os caracteres + e - marcam as mudanças. </para>
<para><guilabel>Contexto</guilabel>, que representa a mesma informação do formato unificado, mas de uma maneira menos compacta. No formato de saída contexto, o caracter ! marca as mudanças. </para></listitem>
<term><guilabel>Número de linhas de contexto:</guilabel></term>
<listitem><para>Configure aqui o número de linhas de contexto para os formatos unificado ou contexto. Esta opção não está disponível para o formato de saída normal, uma vez que neste formato nenhuma informação de contexto é gravada. Mais informações de contexto torna a leitura da saída gerada mais fácil, e a aplicação do remendo mais precisa, mas aumenta o tamanho do remendo. É recomendável usar pelo menos duas linhas de contexto para a operação de remendo apropriada. </para></listitem>
<para>Após configurar o formato de saída, o &cervisia; gera o remendo e exibe o diálogo <guilabel>Salvar Como</guilabel>. Insira neste diálogo o nome do arquivo e localização do arquivo de remendo. </para>
<title>Procurando uma Visão Anotada de um Arquivo</title>
<para>Com o comando <command>cvs annotate</command>, o &CVS; oferece a possibilidade de ver - para cada linha no arquivo - quem modificou uma linha mais recentemente. Esta visão é útil para encontrar quem introduziu uma mudança no comportamento de um programa ou quem deve ser questionado sobre alguma mudança ou erro no código. </para>
<para>O &cervisia; lhe dá o acesso a este recurso, mas ele posteriormente enriquece as informações de uma maneira interativa. Você obtém uma visão anotada selecionando <menuchoice><guimenu>Ver</guimenu><guimenuitem>Anotação...</guimenuitem></menuchoice>. Outra possibilidade é pressionar o botão <guilabel>Anotação</guilabel> no <link linkend="browsinglogs">Diálogo de navegação de registro</link>. Em <xref linkend="screenshot-annotate"/> você pode ver uma captura de tela do diálogo. </para>
<para>No diálogo de anotação, você pode ver em uma janela a última versão do arquivo selecionado (ou a versão da revisão "A", no caso de você ter lançado o diálogo de anotação a partir do <link linkend="browsinglogs">Diálogo do navegador de registro</link>). Nas colunas antes do texto, você obtém algumas informações relacionadas à última mudança em cada linha. Na primeira coluna o número da linha é mostrado. Na segunda coluna você vê o nome do autor e o número da revisão. Finalmente, na terceira coluna você vê o conteúdo atual da linha. </para>
<para>Conseqüentemente, quando uma determinada linha parecer estranha para você ou você encontrar um erro nela, você pode imediatamente ver quem é o responsável por aquela linha. Mas não é só isso, você pode também encontrar <emphasis>porque</emphasis> aquela linha foi mudada. Para isso, mova o cursor sobre o número de revisão respectivo. Então uma dica aparecerá que mostra a mensagem de log e a data da mudança. </para>
<para>Quando você marca um arquivo na visão principal e seleciona <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu <guimenu>Ver</guimenu> ou clique direito no arquivo marcado e seleciona <guimenuitem>Navegar Registro...</guimenuitem> a partir do menu de contexto, o diálogo <guilabel>Registro do CVS</guilabel> é mostrado (se você marcar mais de um, nada acontexe, uma vez que o &cervisia; somente pode gerar e analisar o registro de um arquivo por vez). Este diálogo oferece funcionalidades que vão além da visualização do histórico do arquivo. Usando-o como uma navegador de versão você pode: </para>
<listitem><para>Ver as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para></listitem>
<listitem><para>Criar remendos contendo as diferenças entre quaisquer par de versões do arquivo marcado, incluindo pares com a versão da cópia de trabalho atual do arquivo marcado. </para></listitem>
<para>Você pode selecionar ver o histórico fornecido pelo comando <command>cvs log</command> (<guilabel>Saída do CVS</guilabel>), como uma <guilabel>Árvore</guilabel> ou na forma de <guilabel>Lista</guilabel>. O que você vai preferir, claro, é apenas um problema de gosto e depende de que informação você está interessado. A árvore é uma representação intuitiva do que foi feito em diferentes versões pelos autores. Como dica, você pode ver de acordo com suas mensagens de registro. A lista é de natureza linear e não oferece uma visão imediata das ramificações. Por outro lado, ela concentra mais informações relevantes em menor espaço de tela, citando a hora de cada mudança do arquivo e a primeira parte da mensagem de registro. As informações de saída do CVS são completas, mas longas e difíceis de ler. Para minimizar estes problemas, você pode buscar o texto na saída do CVS, pressionando o botão <guibutton>Procurar...</guibutton>. </para>
<para>Para obter mais informações sobre determinada revisão, você pode clicar nela tanto na visão em lista como na em árvore. Os campos no meio do diálogo são então preenchidos com as informações completas fornecidas pelo <command>cvs log</command>. Você pode marcar duas revisões, chamadas "A" e "B", que forem relevantes para fazer uso de outros recursos oferecidos pelos botões. A revisão "A" pode ser escolhida com o botão esquerdo do mouse, a revisão "B" com o do meio. Na visão em lista, você pode também navegar com suas teclas de cursor. Para marcar revisões "A" e "B", use as teclas de atalho <keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo>, <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo>, respectivamente. Usando a visão de <guilabel>Saída do CVS</guilabel>, você pode clicar em <guilabel>Selecionar para revisão A</guilabel> e <guilabel>Selecionar para revisão B</guilabel> para marcar as revisões. </para>
<para>Se você pressionar o botão <guibutton>Anotação</guibutton>, você obterá um diálogo mostrando o texto do arquivo quando na revisão marcada como "A". Cada linha é precedida com a informação sobre quem editou a linha pela última vez, e em que revisão isto aconteceu. Você pode obter mais informações sobre as versões das visões anotadas em <xref linkend="annotate"/>. </para>
<para>Se você pressionar o botão <guibutton>Diferença</guibutton>, uma chamada <command>cvs diff</command> é enviada e você obterá um diálogo no qual todas as modificações entre as duas revisões marcadas serão mostradas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a versão do arquivo marcada como revisão "A" e a versão da cópia de trabalho do arquivo. Isto permite ver as diferenças entre sua versão do arquivo e qualquer versão disponível no &CVS;. Para tornar fácil ver as mudanças, cores diferentes são usadas para marcar linhas que foram adicionadas, removidas ou simplesmente mudadas. Você pode obter mais informações sobre a visão das diferenças em <xref linkend="diff"/>. </para>
<para>Se você pressionar o botão <guibutton>Criar Remendo...</guibutton>, você obterá um diálogo no qual você pode configurar as opções de formato para gerar um arquivo conterá todas as modificações entre as duas revisões marcadas que estão sendo exibidas. Se você marcar a revisão "A", mas não a revisão "B", o &cervisia; irá gerar as modificações entre a revisão marcada como "A" e a versão da cópia de trabalho do arquivo. Isto permite gera um remendo, ou arquivo de diferenças, entre sua versão do arquivo e qualquer versão disponível no &CVS;. Após configurar o formato do remendo no diálogo, e pressionar <guibutton>OK</guibutton>, um comando <command>cvs diff</command> é enviado para gerar as diferenças do arquivo. Um diálogo <guilabel>Salvar Como</guilabel> aparecerá. Insira o nome do arquivo e localização do arquivo de remendo queo &cervisia; gerou, para salvá-lo. Você pode obter mais informações sobre como criar remendos, e sobre as opções de formato do remendo em <xref linkend="creatingpatches"/>. </para>
<para>Se você pressionar o botão <guibutton>Ver</guibutton>, o &cervisia; irá recuperar a revisão marcada como "A" e a exibirá usando o aplicativo padrão para este tipo de arquivo. </para>
<para>Pressione o botão <guibutton>Fechar</guibutton> para deixar o diálogo e retornar à visão principal. </para>
<para>Para gerar o registro que é a base para o diálogo <guilabel>Registro do CVS</guilabel>, o &cervisia; envia o seguinte comando: </para>
<para>Se o repositório usado possui o logging habilitado o &cervisia; pode lhe apresentar um histórico de certos eventos como verificações, envios, rtags, atualizações e versões. Escolha <guimenuitem>Histórico</guimenuitem> no menu <guimenu>Ver</guimenu>, e o &cervisia; enviará o comando </para>
<note><para>Isto atualiza o arquivo completo de registro do servidor, incluindo uma lista de eventos para todos os usuários e todos os módulos. Isto pode ser uma grande quantidade de dados! </para></note>
<listitem><para>Verificação - O usuário que é exibido na coluna 'Autor' fez uma verificação de um módulo </para></listitem>
<listitem><para>Tag - Um usuário fez uso do comando <command>cvs rtag</command>. Observe que o uso do <command>cvs tag</command> (como feito pelo comando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Tag/Repositório...</guimenuitem></menuchoice> do &cervisia;) não é gravado no banco de dados de histórico. Isto ocorre por razões históricas (veja a <acronym>FAQ</acronym> do &CVS;). </para></listitem>
<listitem><para>Versão - Um usuário lançou a versão de um módulo. Atualmente, este comando é raramente usado e não tem muito valor. </para></listitem>
<listitem><para>Atualizado, Excluído - Um usuário fez uma atualização de um arquivo que foi excluído do repositório. Como conseqüência, o arquivo foi excluído em sua cópia local. </para></listitem>
<listitem><para>Atualizado, Copiado - Um usuário fez uma atualização de um arquivo. Uma nova versão foi copiada para a cópia de trabalho. </para></listitem>
<listitem><para>Atualizado, Mesclado - Um usuário fez uma atualização de um arquivo. As modificações na versão do arquivo no repositório foram mescladas em sua cópia de trabalho. </para></listitem>
<listitem><para>Atualizado, Conflito - Um usuário fez uma atualização de um arquivo, e um conflito com suas modificações foi detectado. </para></listitem>
<listitem><para>Enviado, Modificado - Um usuário enviou um arquivo modificado. </para></listitem>
<listitem><para>Enviado, Adicionado - Um usuário adicionou um arquivo e enviou-o. </para></listitem>
<listitem><para>Enviado, Removido - Um usuário removeu um arquivo e enviou-o. </para></listitem>
<para>Você pode ordenar a lista por outro critério simplesmente clicando no respectivo cabeçalho da coluna. Para ordenar as entradas do histórico da maneira que você deseja, existem várias opções de filtros ativadas pelas caixas de checagem: </para>
<para>Ramificações de um módulo são versões paralelas deste módulo. Um bom exemplo prático do uso deste recurso é o lançamento de um projeto de software. Após uma versão principal, existem erros no código que devem ser concertados, mas as pessoas desejam adicionar novos recursos ao aplicativo também. É muito difícil fazer as duas coisas ao mesmo tempo porque novos recursos normalmente introduzem novos erros, tornando difícil rastrear os antigos. Para resolver este dilema, o &CVS; permite que você crie uma versão paralela, que nós chamaremos de "ramificação da versão estável", onde você pode somente adicionar correções de erro, deixando a ramificação principal (HEAD) aberta para adição de novos recursos. </para>
<para>Tags são usadas para marcar a versão de um projeto. O &CVS; estampa uma versão de cada arquivo com a tag, de modo que quando você importar ou atualizar para uma tag específica, você obterá sempre as mesmas versões de arquivo. Por outro lado, ao contrário das ramificações, tags não são dinâmicas: você não pode desenvolver uma tag. Tags são úteis para marcar lançamentos, grandes mudanças no código, &etc;. </para>
<para>Quando você está desenvolvendo ou seguindo o desenvolvimento de um projeto de software, você não trabalha necessariamente com a ramificação principal sempre. Após um lançamento, você pode desejar permanecer com a ramificação do lançamento por um tempo, para verificar sua relativa estabilidade, corrigir erros, traduzir as fontes, &etc;. Para fazer tudo isto, você deve atualizar para a ramificação de lançamento. Todos os seus arquivos serão atualizados para o última versão dos arquivos na ramificação. Após a atualização, todos os seus novos envios serão remetidos para a nova ramificação. </para>
<para>Além disso, se você deseja rastrear um erro que foi reportado em uma versão com tag anterior, o &CVS; oferece a possibilidade de recuperar o software como ele foi lançado, atualizado para a tag. Ao lado disso, se você deseja buscar uma versão passada do seu projeto, você pode atualizar sua cópia de trabalho para uma data específica. Isto pode ser útil se um erro foi introduzido no projeto entre dois lançamentos, e você tem uma idéia de quando ele ocorreu. Quando você atualiza para uma data ou tag, as versões de seus arquivos serão as mesmas das versões naquela data específica ou das versões estampadas pela tag. </para>
<warning><para>Antes de atualizar para uma ramificação diferente ou tag, certifique-se de que você enviou todas as suas mudanças para a ramificação que você está trabalhando. Se você não estiver pronto para enviar suas mudanças, mas não quer descartá-las, não atualize para a nova ramificação, ou perderá todo o seu trabalho. Como uma alternativa, você pode fazer uma nova <link linkend="checkingout">verificação</link>, para trabalhar em paralelo com ambas as versões. </para></warning>
<term><guilabel>Atualizar para ramificação</guilabel></term>
<listitem><para>Selecione esta opção para atualizar para uma ramificação. Insira o nome da ramificação na caixa de texto combinada (ou pressione o botão <guilabel>Obter Lista</guilabel> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para></listitem>
<term><guilabel>Atualizar para tag</guilabel></term>
<listitem><para>Selecione esta opção para atualizar para uma tag. Insira o nome da tag na caixa de texto combinada (ou pressione o botão <guilabel>Obter Lista</guilabel> para recuperar a lista de ramificações a partir do servidor &CVS;, e selecione a que você deseja na lista combinada). </para></listitem>
<term><guilabel>Atualizar para data</guilabel></term>
<listitem><para>Selecione esta opção para atualizar para uma data. No campo abaixo, você pode inserir uma grande variedade de formatos de data. Um formato possível é <literal>aaaa-mm-dd</literal> onde <literal>aaaa</literal> é o ano, <literal>mm</literal> é o mês (numérico) e <literal>dd</literal> é o dia. Alternativas são algumas frases em inglês como <literal>yesterday</literal> ou <literal>2 weeks ago</literal>. </para></listitem>
<note><para>Atualizar para uma tag ou data faz com que a cópia de trabalho seja 'pregada', &ie;, você não pode enviar futuras modificações nestes arquivos (ao menos que a tag seja uma tag de ramificação). Para retornar à ramificação principal, use o ítem de menu <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Atualizar para HEAD</guimenuitem></menuchoice>. </para></note>
<para>O comando enviado para atualizar para uma ramificação ou tag é: <screen><command>cvs update -r <replaceable>tag</replaceable></command></screen>
<para>Nós discutiremos aqui somente aspectos de tags e ramificações. Se você é somente um <emphasis>usuário</emphasis>, e não o administrador do repositório, você provavelmente não será confrontado com o problema. Se no entanto você é seu próprio administrador, você deve primeiro ler sobre problemas não técnicos que acompanham as ramificações, para ter uma idéia de quanto tempo se gasta e quantos erros ocorrem por causa da manutenção de diferentes ramificações de um projeto. O apêndice inclui algumas referências sobre este tópico. </para>
<para>Tag simples é algo que usualmente é feito quando uma revisão é executada, de modo que você possa a qualquer momento facilmente voltar para o estado de um projeto no tempo. Tags comumente fornecem um nome consistindo do nome do projeto e o número de revisão. Por exemplo, o &cervisia; 1.0 está disponível sob a tag <literal>CERVISIA_1_0</literal>. O &cervisia; força regras estritas do &CVS; sobre o que constitui um nome válido de tag. Ele deve iniciar com uma letra e pode conter letras, dígitos, hífens e sublinhados. </para>
<para>Normalmente, você desejará uma tag para todo o projeto (apesar do &CVS; permitir uma tag para um sub-conjunto somente). Para este fim, marque a pasta de nível superior na janela e escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Tag/Ramificação</guimenuitem></menuchoice>. Agora insira o nome da tag, pressione <keycap>Return</keycap> e está feito! </para>
<para>Criar uma ramificação não é significativamente mais difícil. No diálogo de tag, habilite a caixa <guibutton>Criar ramificação com esta tag</guibutton>. Você pode também excluir uma tag existente: Selecione <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Excluir Tag</guimenuitem></menuchoice> na janela principal. </para>
<para>Outro aspecto da ramificação é a mesclagem de modificações de uma ramificação para a ramificação atual. Se você está fazendo isso, escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mesclar...</guimenuitem></menuchoice>. O diálogo que aparece agora lhe oferece duas opções: </para>
<para>Você pode mesclar todas as modificações feitas na ramificação para a ramificação atual. Neste caso, habilite a caixa de checagem <guibutton>Mesclar a partir da ramificação</guibutton> e preencha a ramificação a partir da qual mesclar. O &cervisia; então executará o comando </para>
<para>A outra possibilidade é que você deseja mesclar somente as modificações feitas entre duas tags em uma ramificação. Isto usualmente acontece quando você mescla a partir da mesma ramificação para o tronco diversas vezes. Neste caso, habilite a caixa <guibutton>Mesclar modificações</guibutton> e insira (na ordem correta) as duas tags relevantes. Isto resultará em um comando </para>
<para>Um monitor é o nome convencional para a característica do &CVS; de notificar usuários do repositório sempre que um arquivo for mudado ou um desenvolvedor iniciar a edição de um arquivo. O uso de monitores requer que o arquivo <filename><envar>$CVSROOT</envar>/CVSROOT/notify</filename> tenha sido configurado corretamente. Isto não será discutido aqui, se você necessitar de mais informações sobre a configuração de pontos de monitoramento, leia um dos livros listados no apêndice. </para>
<para>O principal suporte de monitores do &cervisia; possui seis ítens de menu. </para>
<para>Para adicionar um monitor para um ou diversos arquivos, use <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Adicionar Monitor...</guimenuitem></menuchoice>. No diálogo obtido, você pode selecionar para quais tipos de eventos que o &CVS; suporta você deseja receber uma notificação. Por exemplo, se você somente quer receber notificações quando um arquivo é enviado, habilite as caixas <guibutton>Somente</guibutton> e <guibutton>Envios</guibutton>. Se você deseja obter notificações sobre qualquer evento relacionado aos arquivos marcados, habilite a caixa <guibutton>Todos</guibutton>. A linha de comando usada quando você aceita este diálogo é </para>
<para>Se você não está mais interessado em alguns arquivos, você pode remover os monitores deles. Para isto, use <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Remover Monitor...</guimenuitem></menuchoice>. No diálogo obtido aqui, as mesmas opções no formulário preenchido para adição são oferecidas. Quando você confirmar este diálogo, o &cervisia; enviará o comando </para>
<para>Finalmente, você pode obter uma lista das pessoas que estão monitorando um conjunto de arquivos. Escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Monitores</guimenuitem></menuchoice>. Usar este ítem de menu resultará em um comando </para>
<para>No cenário normal de utilização do &CVS;, cada desenvolvedor trabalha separadamente em sua cópia local sincronizada. Quando ele deseja modificar algum arquivo, ele pode apenas abrí-lo em seu editor e iniciar seu trabalho. Ninguém saberá sobre este trabalho até o arquivo ser enviado. </para>
<para>Para alguns grupos de desenvolvedores, este não é o modelo preferido de cooperação. Eles preferem ser notificados sobre alguém trabalhando em um arquivo <emphasis>tão logo</emphasis> ele inicie. Isto pode ser obtido por alguns comando &CVS; posteriores. Antes de você iniciar a edição de um arquivo, selecione-o na janela principal do &cervisia; e escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>. Isto executará o comando </para>
<para>Isto enviará uma notificação para todos que tem configurado um monitor de <literal>edição</literal> no arquivo. Isto também registrará também você como um <emphasis>editor</emphasis> do arquivo. Você pode obter uma lista de todos os editores de um determinado arquivo usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Mostrar Editores</guimenuitem></menuchoice>. Isto é equivalente a digitar na linha de comando </para>
<para>Uma sessão de edição é automaticamente terminada quando você envia o arquivo afetado. Neste momento, uma notificação de <literal>cancelar edição</literal> é enviado para todas as pessoas que tem registrado o respectivo monitor no arquivo. É claro, algumas vezes você pode não desejar sincronizar o arquivo, mas aborta a sessão de edição e reverte para a versão anterior do arquivo. Isto é feito usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Cancelar edição</guimenuitem></menuchoice>. Observe que o &cervisia; não lhe pedirá por uma confirmação! Isto significa que se você usar este ítem de menu, todo seu trabalho feito desde o uso do <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice> será perdido. Precisamente, o &cervisia; usa a linha de comando </para>
<para>Nós temos somente o caso discutido onde edição e cancelamento de edição são usados voluntariamente pelos desenvolvedores. Adicionalmente o &CVS; suporta um modelo que <emphasis>força</emphasis> o uso destes comandos. O comando responsável por alternar para este modelo é <command>cvs watch on</command> que nós não iremos explanar posteriormente porque ele é mais usado pelo administrador do repositório. No entanto, o ponto importante do ponto de vista dos desenvolvedores é que quando o projeto força edições, as cópias de trabalho são verificadas <emphasis>somente leitura</emphasis>. Isto significa que você não pode editar um arquivo por padrão (a menos que você use coisas como <command>chmod</command>). Somente quando você usa <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>, o arquivo se torna gravável. Ele é tornado somente leitura novamente quando você envia o arquivo ou usa <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Cancelar edição</guimenuitem></menuchoice>. </para>
<para>A interface do editor do &cervisia; lhe auxilia com projetos que forçam monitores também de diferentes maneiras. Se você apenas iniciou um editor com um arquivo apenas para leitura com um duplo-clique nele ou usando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Editar</guimenuitem></menuchoice>, você pode não ser capaz de salvar suas modificações posteriormente. Isto tem sua própria razão. Sempre que você deseja mudar um arquivo, você deve executar <command>cvs edit</command> antes, de modo que todas as pessoas monitorando o arquivo recebem uma notificação que você está trabalhando nele. </para>
<para>Neste caso, é conveniente habilitar a opção <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Executar cvs edit Automaticamente Quando Necessário</guimenuitem></menuchoice>. Agora, sempre que você editar um arquivo com um duplo clique nele, o &cervisia; executará <command>cvs edit</command> antes do editor ser executado. Então você poderá editar seu arquivo normalmente. Quando tiver terminado seu trabalho, envie seus arquivos, e os arquivos enviados serão somente leitura novamente. </para>
<para>O modelo de desenvolvimento seguido quando o &CVS; é usado é chamado <emphasis>verificações não reservadas</emphasis>. Cada desenvolvedor tem sua própria cópia local onde ele pode editar arquivos como desejar. Quando as características de monitoramento - como <command>cvs edit</command> - são usada, múltiplos desenvolvedores podem trabalhar em arquivos sincronizadamente. Mudanças feitas por um desenvolvedor diferente são mescladas para sua cópia local quando uma atualização é executada. </para>
<para>Outros sistemas de controle de revisão - como <acronym>RCS</acronym> e <application>SourceSafe</application> usam um modelo diferente. Quando um desenvolvedor deseja editar um arquivo, ele deve <emphasis>travá-</emphasis>lo. Somente um desenvolvedor pode travar um arquivo por vez. Quando ele terminou a edição, a trava é desfeita. Por um lado, com este modelo, conflitos podem nunca acontecer. Por outro lado, dois desenvolvedores não podem trabalhar no mesmo arquivo ao mesmo tempo, mesmo se suas mudanças não conflitarem. Isto pode ser um estrangulamento. Nós não vamos discutir os benefícios organizacionais de ambas as abordagens. Nós apenas iremos mencionar que apesar do &CVS; ter algum suporte para travamento, esta não é a melhor maneira de trabalhar com o &CVS;. Você não deve usar estas características a menos que tenha certeza que seu gerenciador de projeto as permita. </para>
<para>Com o &cervisia;, você trava arquivos como se segue. Selecione os arquivos desejados na janela principal. Então escolha <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Travar</guimenuitem></menuchoice>. Isto executa o comando </para>
<para>O efeito reverso é obtido usando <menuchoice><guimenu>Avançado</guimenu><guimenuitem>Destravar</guimenuitem></menuchoice>. Isto executa o comando</para>
<para>O &cervisia; pode ser personalizado de diversas maneiras para suas necessidades e preferências. Algumas opções que você pode desejar mudar regularmente estão disponíveis diretamente no menu <guimenu>Configurações</guimenu>. Outras estão unificadas em um diálogo comum que está disponível via <menuchoice><guimenu>Opções</guimenu><guimenuitem>Configurações...</guimenuitem></menuchoice>. </para>
<term><guilabel>Nome de usuário para o editor de ChangeLog:</guilabel></term>
<listitem><para>Sempre que você usa o ítem de menu <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Inserir Entrada ChangeLog...</guimenuitem></menuchoice>, uma nova entrada no ChangeLog é gerada com a data atual e seu nome de usuário. Normalmente, é considerado um bom estilo inserir seu nome completo e seu endereço eletrônico em cada uma de suas entradas no ChangeLog. O &cervisia; adiciona automaticamente o nome completo e enderço eletrônico inseridos aqui. </para></listitem>
<term><guilabel>Caminho para o executável do cvs, ou 'cvs':</guilabel></term>
<listitem><para>Aqui você pode configurar o nome (ou caminho) para o cliente de linha de comando <command>cvs</command>. Por padrão, o executável do &CVS; encontrado em seu<envar>$PATH</envar> é usado pelo &cervisia;. </para></listitem>
<term><guilabel>Número das linhas de contexto no diálogo de diferenças:</guilabel></term>
<listitem><para>Para o diálogo de diferenças o &cervisia; usa a opção <option>-U</option> para o <command>diff</command>. Isto faz com que o <command>diff</command> mostre somente um número limitado de linhas ao redor de cada região de diferença (linhas de contexto). Aqui você pode configurar o argumento para o <option>-U</option>. </para></listitem>
<term><guilabel>Opções adicionais para o cvs diff:</guilabel></term>
<listitem><para>Aqui você pode adicionar argumentos suplementares ao <command>diff</command>. Um exemplo popular é <option>-b</option> que faz com que o <command>diff</command> ignore mudanças na quantidade de espaços em branco. </para></listitem>
<term><guilabel>Largura da tabulação no diálogo de diferenças:</guilabel></term>
<listitem><para>No diálogo de diferenças, caracteres de tabulação presentes em seu arquivo ou na saída do comando <command>diff</command> são expandidos para um número fixo de caracteres de espaço. Por padrão, cada tabulação é substituída por oito espaços, mas aqui você pode configurar um número diferente. </para></listitem>
<term><guilabel>Interface externa do diff:</guilabel></term>
<listitem><para>Quando você usa qualquer dos recursos mostrados no diálogo de diferenças, como <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferenças para Repositório...</guimenuitem></menuchoice>, o &cervisia; invoca seu aplicativo interno de interface com o diff. Se você preferir um diferente, como o <application>Kompare</application>, <application>TkDiff</application>, ou <application>xxdiff</application>, insira o nome e caminho do arquivo aqui. </para></listitem>
<term><guilabel>Ao abrir uma área local de um repositório remoto, iniciar um comando Arquivo->Estado automaticamente</guilabel></term>
<listitem><para>Quando você habilita esta opção, o comando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Estado</guimenuitem></menuchoice> é iniciado sempre que você abre uma área local de um repositório remoto. Este comando pode demorar algum tempo e também necessita de uma conexão com o servidor para repositórios remotos (tornando-o indisponível para uso off-line). </para></listitem>
<term><guilabel>Ao abrir uma área local de um repositório local, iniciar um comando Arquivo->Estado automaticamente</guilabel></term>
<listitem><para>Quando você habilita esta opção, o comando <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>Estado</guimenuitem></menuchoice> é iniciado sempre que você abre uma área local de um repositório local. </para></listitem>
<term><guilabel>Tempo limite após o qual um diálogo de progresso aparece (em ms):</guilabel></term>
<listitem><para>Praticamente todos os comando &CVS; iniciados em uma cópia local que se estendem a um repositório remoto necessitam de uma conexão para o servidor &CVS;. Isto é afetado pelos retardos da conexão da rede ou uma sobrecarga no servidor. Por esta razão, para comandos como <menuchoice><guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório...</guimenuitem></menuchoice> o &cervisia; abre um diálogo que indica que o comando ainda está rodando e que lhe permite abortá-lo. Além disso, este diálogo é usado para mostrar mensagens de erro do &CVS;. Com este diálogo deve aparecer após algum tempo, ele é mostrado somente após um determinado limite de tempo que é de 4 segundos por padrão. Aqui você pode mudar este valor. </para></listitem>
<term><guilabel>Nível de compressão padrão:</guilabel></term>
<listitem><para>O cliente <command>cvs</command> comprime arquivos e remendos quando eles são transferidos pela rede. Com a opção de linha de comando <option>-z</option>, o nível de compressão pode ser configurado. Você pode configurar o &cervisia; para usar esta opção na configuração do nível. O valor configurado aqui é usado somente como padrão; adicionalmente existe uma configuração por repositório disponível em <menuchoice><guimenu>Repositório</guimenu><guimenuitem>Repositórios...</guimenuitem></menuchoice>. </para></listitem>
<term><guilabel>Utilizar um processo de agente ssh em execução ou iniciar um novo</guilabel></term>
<listitem><para>Habilite isto se você usa <link linkend="rsh">repositórios ext (rsh)</link>, o shell remoto &ssh; para comunicar-se com o repositório e o <application>ssh-agent</application> para gerenciar suas chaves. </para></listitem>
<term><guilabel>Fonte para janela de protocolo...</guilabel></term>
<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada na janela de protocolo (esta é a janela que mostra a saída do cliente <command>cvs</command>). </para></listitem>
<term><guilabel>Fonte para visão anotada...</guilabel></term>
<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada na <link linkend="annotate">visão anotada</link>. </para></listitem>
<term><guilabel>Fonte para visão das diferenças...</guilabel></term>
<listitem><para>Pressione este botão para abrir o diálogo <guilabel>Configurar Fonte</guilabel>, para configurar a fonte usada no <link linkend="diff">diálogo de diferenças</link>. </para></listitem>
<listitem><para>Pressione os botões coloridos para abrir o diálogo <guilabel>Selecionar Cor</guilabel>, para configurar a cor usada para <guilabel>Conflito</guilabel>, <guilabel>Mudado Localmente</guilabel>, ou <guilabel>Mudado Remotamente</guilabel> na visão principal ou <guilabel>Diferença de mudança</guilabel>, <guilabel>Diferença de inserção</guilabel> ou <guilabel>Diferença de exclusão</guilabel> na interface embutida do &cervisia; para o diff. </para></listitem>
<term><guilabel>Dividir janela principal horizontalmente</guilabel></term>
<listitem><para>A janela principal do &cervisia; é normalmente dividida verticalmente em uma janela com a árvore de arquivos e uma com a saída do &CVS;. Alternativamente, você pode arranjá-las horizontalmente. </para></listitem>
<para>Na sua árvore de arquivos, o &cervisia; não exibe todos os arquivos que estão atualmente lá. Isto é análogo ao próprio <command>cvs</command> e auxilia a evitar a sobrecarga causada por material desnecessário como arquivos de objeto. O &cervisia; tenta emular o comportamento do <command>cvs</command> tanto quanto possível, isto é, obtém uma lista de arquivos a ignorar das seguintes fontes: </para>
<listitem><para>Um lista estática de entradas que incluem coisas como <literal role="extension">*.o</literal> e <filename>core</filename>. Para detalhes, veja a documentação do &CVS;. </para></listitem>
<para>O próprio <command>cvs</command> adicionalmente procura por entradas em <filename><envar>$CVSROOT</envar>/CVSROOT/cvsignore</filename>, mas este é um arquivo do servidor, e o &cervisia; pode não ser capaz de iniciá-lo estando offline. Se você estiver trabalhando com um grupo que prefere usar uma lista de arquivos para ignorar no servidor, é provavelmente uma boa idéia dar uma olhada em quais padrões estão listados nele e colocá-los no arquivo <filename>.cvsignore</filename> em sua pasta pessoal. </para>
<listitem><para>O &CVS; vem com um conjunto completo de documentação na forma de páginas de informação, conhecidas como "O Cederquivista". Se ele estiver corretamente instalado, você poderá navegá-lo digitando <userinput>info:/cvs</userinput> na barra de localização do <application>kdehelp</application>, <application>khelpcenter</application> respectivamente. Alternativamente, você pode apenas escolher <menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Informações do CVS</guimenuitem></menuchoice> no &cervisia;. Uma versão HTML online do Cederquivista está disponível <ulink url="http://cvshome.org/docs/manual/cvs.html">na web</ulink>. </para>
<para>Como este livro é mantido junto com o &CVS;, ele é normalmente a referência mais atualizada. No entanto eu recomendo considerar outras documentações para aprender a usar o &CVS;, particularmente as seguintes. </para></listitem>
<listitem><para>Karl Fogel escreveu um excelente livro <ulink url="http://cvsbook.red-bean.com/index.html">Desenvolvimento Open Source com o CVS</ulink>. Metade deste livro é sobre o processo de desenvolvimento de software Open Source. A outra metade é uma documentação técnica do &CVS;. Felizmente, a parte técnica do livro é livre e redistribuível sob a GPL, logo você pode baixar uma versão HTML dela. Uma lista de erratas está disponível na página web mencionada acima. </para></listitem>
<listitem><para>Versões &CVS; são discutidas em uma <ulink url="http://mail.gnu.org/mailman/listinfo/info-cvs">lista de correio</ulink> dedicada. </para></listitem>
<listitem><para>Existe um grupo USENET <literal>comp.software.config-mgmt</literal> dedicado ao gerenciamento da configuração em geral. O &CVS; é somente um tópico marginal neste grupo, mas ao menos pode ser interessante para discutir os méritos de vários sistemas de controle de revisão comparados ao &CVS;. </para></listitem>
<listitem><para>Por fim, mas não menos importante, existe uma (de baixo tráfico) <ulink url="http://lists.sourceforge.net/mailman/listinfo/cervisia-user">lista de correio do &cervisia;</ulink>. </para></listitem>
<listitem><para>Abre o editor de ChangeLog, preparado de modo que você possa adicionar uma nova entrada com a data atual. Veja <xref linkend="committingfiles"/>. </para></listitem>
<listitem><para>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para></listitem>
<listitem><para>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. Veja <xref linkend="mainscreen"/>. </para></listitem>
<listitem><para>Abre um diálogo para o arquivo selecionado que lhe permite resolver conflitos de mesclagem existentes. Veja <xref linkend="resolvingconflicts"/>. </para></listitem>
<term><menuchoice><shortcut><keycap>+</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Adicionar ao Repositório...</guimenuitem> </menuchoice></term>
<listitem><para>Permite-lhe adicionar os arquivos selecionados ao repositório. Veja <xref linkend="addingfiles"/>. </para></listitem>
<listitem><para>Permite-lhe adicionar os arquivos selecionados ao repositório como binários (<command>cvs add<option>-kb</option></command>). Veja <xref linkend="addingfiles"/>. </para></listitem>
<term><menuchoice><shortcut><keycap>-</keycap></shortcut> <guimenu>Arquivo</guimenu><guimenuitem>Remover do Repositório...</guimenuitem> </menuchoice></term>
<listitem><para>Permite-lhe remover os arquivos selecionados do repositório. Veja <xref linkend="removingfiles"/>. </para></listitem>
<listitem><para>Descarta qualquer mudança local que você tenha feito nos arquivos selecionados e reverte para a versão do repositório (Opção <option>-C</option> para o <command>cvs update</command>). </para></listitem>
<listitem><para>Mostra uma visão anotada do arquivo selecionado, ou seja, uma visão onde você pode ver para cada linha qual autor a modificou por último. Veja <xref linkend="annotate"/>. </para></listitem>
<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>D</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (BASE)...</guimenuitem> </menuchoice></term>
<listitem><para>Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (BASE). Veja <xref linkend="diff"/>. </para></listitem>
<term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap><keycap>H</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Diferença para Repositório (HEAD)...</guimenuitem> </menuchoice></term>
<listitem><para>Mostra as diferenças entre o arquivo selecionado na cópia local e a revisão da última atualização (HEAD). Veja <xref linkend="diff"/>. </para></listitem>
<listitem><para>Mostra as diferenças entre a revisão do arquivo selecionado que você atualizou por último (BASE) e a revisão anterior. Veja <xref linkend="diff"/>. </para></listitem>
<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Ocultar Arquivos Não Modificados</guimenuitem> </menuchoice></term>
<listitem><para>Determina se arquivos desconhecidos e atualizados são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem>
<listitem><para>Determina se os arquivos que não estão no CVS são ocultos na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem>
<listitem><para>Determina se pastas sem entradas visíveis são ocultas na visão em árvore principal. Veja <xref linkend="mainscreen"/>. </para></listitem>
<term><menuchoice><guimenu>Ver</guimenu><guimenuitem>Expandir Árvore de Arquivos</guimenuitem> </menuchoice></term>
<listitem><para>Abre todos os níveis na árvore de arquivos de modo que você possa ver todos os arquivos e pastas. Veja <xref linkend="mainscreen"/>. </para></listitem>
<listitem><para>Mescla uma ramificação fornecida ou as modificações entre duas tags nos arquivos selecionados. Veja <xref linkend="taggingbranching"/>. </para></listitem>
<listitem><para>Configura uma lista de repositórios que você freqüentemente usa e como acessá-los. Veja <xref linkend="accessing-repository"/>. </para></listitem>
<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Criar Pastas ao Atualizar</guimenuitem> </menuchoice></term>
<listitem><para>Determina se atualizações criam pastas na cópia local quando elas ainda não existirem (Opção <option>-d</option> do <command>cvs update</command>). </para></listitem>
<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Excluir Pastas Vazias ao Atualizar</guimenuitem> </menuchoice></term>
<listitem><para>Determina se atualizações removem pastas vazias na cópia local (Opção <option>-P</option> do <command>cvs update</command>). </para></listitem>
<term><menuchoice><guimenu>Configurações</guimenu><guimenuitem>Enviar e Remover Recursivamente</guimenuitem> </menuchoice></term>
<listitem><para>Determina se os envios e exclusões são recursivos (Opção <option>-r</option> do <command>cvs add</command>, <command>cvs remove</command> respectivamente.). </para></listitem>
