<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&cervisia;">
  <!ENTITY package "kdesdk">
  <!ENTITY ssh "<command
>ssh</command
>">
  <!ENTITY rsh "<command
>rsh</command
>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Brazilian-Portuguese "INCLUDE"
> <!-- Change language only here -->
  <!ENTITY CVS "<application
>CVS</application
>">
]>

<book lang="&language;">

<bookinfo>
<title
>Manual do &cervisia;</title>
<authorgroup>
<author
><firstname
>Bernd</firstname
><surname
>Gehrmann</surname
> <affiliation
><address
><email
>bernd@mail.berlios.de</email
></address
></affiliation>
</author
> 

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>1999</year>
<year
>2000</year>
<year
>2001</year>
<year
>2002</year>
<holder
>Bernd Gehrmann</holder>
</copyright>
<legalnotice>
 
<para
>Este programa deve ser distribuído sob os termos da Licença Pública Q como definido pelo Trolltech AS da Noruega e conforme o existente no arquivo LICENSE.QPL incluído no pacote deste arquivo.</para>

<para
>Este programa é distribuído na esperança que ele seja útil, mas SEM NENHUMA GARANTIA, inclusive a garantia implícita de MERCABILIDADE ou ADEQUAÇÃO PARA UM PROPÓSITO PARTICULAR.</para>
</legalnotice>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-06-30</date>
<releaseinfo
>2.00.00</releaseinfo>

<abstract>
<para
>O &cervisia; oferece uma visão gráfica do &CVS;.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdesdk</keyword>
<keyword
>Cervisia</keyword>
<keyword
>CVS</keyword>
<keyword
>controle de versão</keyword>
<keyword
>controle de revisão</keyword>
</keywordset>

</bookinfo>
   
<chapter id="getting-started">
<title
>Iniciando</title>

<sect1 id="accessing-repository">
<title
>Acessando O Repositório</title>
      
<para
>Nesta seção nós assumimos que você está usando o &CVS; somente no lado cliente. Isto significa que alguém (provavelmente o administrador do repositório &CVS;) criou uma conta para você na máquina servidora, e é seu trabalho baixar módulos do repositório e trabalhar com eles. </para>

<para
>O &CVS; suporta diversos métodos de acesso ao repositório, que podem ser categorizados como os seguintes: </para>

<variablelist>
<varlistentry>
<term
>Local</term>
<listitem>
<para
>O repositório é algo como <filename class="directory"
>/home/cvs</filename
> e é simplesmente armazenado numa pasta que é acessível do seu computador. Isto pode ser fisicamente num disco que é montado via <acronym
>NFS</acronym
>, mas este é um detalhe irrelevante. Se você freqüentemente usa um determinado repositório local, você desejará informar o &cervisia; sobre isto. </para>

<procedure>
<title
>Adicionando Um Repositório Local</title>
<step
><para
>Abra o diálogo de Repositórios selecionando <menuchoice
><guimenu
>Repositório</guimenu
> <guimenuitem
>Repositórios...</guimenuitem
></menuchoice
>.</para
></step>

<step
><para
>Pressione o botão <guibutton
>Adicionar...</guibutton
>.</para
></step>

<step
><para
>Insira os detalhes do repositório na caixa de diálogo que aparece.</para
></step>

<step
><para
>Confirme pressionando o botão <guibutton
>OK</guibutton
>.</para
></step>

</procedure>

<para
>No futuro, sempre que você usar o &cervisia; para verificar um novo módulo, o &cervisia; lhe apresentará os repositórios que você adicionar aqui.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
>rsh</term>
<listitem>
<para
>O nome do repositório é algo como <literal
>:ext:bernd@cvs.cervisia.sourceforge.net:/cvsroot/cervisia</literal
>.</para>

<para
>Este método necessita que você tenha uma conta de usuário na máquina servidora (neste caso, <systemitem class="systemname"
>cvs.sourceforge.net</systemitem
> e use um shell remoto para comunicação. Por padrão, o &CVS; usa o &rsh; para esta finalidade, no entanto, o &rsh; é 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
>Abra o diálogo de repositórios novamente, e pressione o botão <guibutton
>Adicionar...</guibutton
>. Agora insira o nome do repositório na primeira linha e o shell remoto (&eg; &ssh;) na segunda. Se você agora confirmar com o botão <guibutton
>OK</guibutton
>, o &cervisia; memorizará estas configurações. </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 &rsh;, isto pode ser conseguido por exemplo criando um arquivo <filename
>$<envar
>HOME</envar
>/.rhosts</filename
> com uma lista de máquinas confiáveis (veja a manpage do &rsh;). </para>

<para
>Com o &ssh;, isto pode ser conseguido copiando sua chave pública <filename
>$<envar
>HOME</envar
>/.ssh/identity.pub</filename
> para o servidor. Neste caso, a chave não deve estar criptografada com a frase-senha (veja a manpage do &ssh;
> e o &CVS;/<acronym
>SSH</acronym
> <acronym
>FAQ</acronym
> no SourceForge). Se você não está sobre como fazer isso, pergunte ao seu administrador de sistema. </para>

</listitem>
</varlistentry>

<varlistentry>
<term
>pserver</term>
<listitem>

<para
>O nome do repositório se parece com <filename
>:pserver:gehrmab@cvs.kde.org:/home/kde</filename
> </para>

<para
>Este método acessa o servidor via 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ê deve realizar o login. Como isto não é suportado diretamente pelo &cervisia;, insira na linha de comando </para>

<screen
><prompt
>%</prompt
><userinput
><command
>cvs</command
> <option
>-d</option
> <parameter
>:pserver:joe@cvs.kde.org:/home/kde login</parameter
></userinput
></screen>

<para
>(claro, substituindo o nome com o de seu repositório). O &CVS; lhe pedirá por sua senha e a verificará com o servidor. Se a senha estiver ok, o nome do repositório, junto com a (ligeiramente embaralhada) senha, será anexada ao arquivo <filename
>$<envar
>HOME</envar
>/.cvspass</filename
>. Sempre que o &CVS; acessar o repositório, ele silenciosamente enviará a senha para o servidor, logo você não precisa tomar cuidado uma vez que você esteja logado. Como todos que conhecem sua senha podem trabalhar com o repositório em seu nome (e também danificar coisas para você), você deve manter o <filename
>$<envar
>HOME</envar
>/.cvspass</filename
> secreto e não legível por outros. </para>

</listitem>
</varlistentry>
</variablelist>

</sect1>


<sect1 id="importing">
<title
>Importando um módulo para o repositório</title>

<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á num repositório, você pode pular esta seção. </para>

<figure id="screenshot-import" float="1">
<title
>Uma imagem do diálogo de importação do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="import.png"/></imageobject>
<textobject
><phrase
>Uma imagem do diálogo de importação do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<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. Após você ter preenchido este formulário e confirmado com <guibutton
>OK</guibutton
>, o seguinte comando &CVS; é usado: </para>

<screen
><command
>cvs</command
> -d <co id="co-repository"
></co
><replaceable
>repository</replaceable
> import -m "" <co id="co-module"
></co
><replaceable
>módulo</replaceable
> <co id="co-vendortag"
></co
><replaceable
>vendortag</replaceable
> <co id="co-releasetag"
></co
><replaceable
>releasetag</replaceable
></screen>

<calloutlist>

<callout arearefs="co-repository">
<para
>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 existe, inicialize-o com o comando <userinput
><command
>cvs</command
> <option
>-d</option
> <replaceable
>repositório</replaceable
> <command
>init</command
></userinput
>. </para>

<para
>Se o repositório for remoto, certifique-se que a autenticação funcionará (veja <xref linkend="accessing-repository"/>). </para>
</callout>

<callout arearefs="co-module">
<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>
</callout>

<callout arearefs="co-vendortag">
<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>
</callout>

<callout arearefs="co-releasetag">
<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>
</callout>

</calloutlist>

<formalpara>
<title
>Pasta de trabalho</title>
<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>
</formalpara>

<formalpara>
<title
>Arquivos ignorados</title>
<para
>Se você preencher este campo, uma opção adicional <option
>-I <replaceable
>nomesdearquivo</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;, por ex. 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>
</formalpara>

<formalpara>
<title
>Importar como binários</title>
<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>
</formalpara>

</sect1>


<sect1 id="checkingout">
<title
>Verificar um módulo do repositório</title>
<para
>Antes de você trabalhar num projeto com controle de revisões, você deve enviar uma <emphasis
>cópia de trabalho</emphasis
>. </para>

<figure id="screenshot-checkout" float="1">
<title
>Uma tela do diálogo de verificar do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="checkout.png"/></imageobject>
<textobject
><phrase
>Uma tela do diálogo de verificar do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<formalpara>
<title
>Repositório</title>
<para
>O nome do repositório &CVS;, também conhecido como <filename
><envar
>$CVSROOT</envar
></filename
>. Se o repositório é remoto, certifique-se de que a autenticação funciona, veja <xref linkend="accessing-repository"/>. </para>
</formalpara>

<formalpara>
<title
>Módulo</title>
<para
>O nome do módulo a ser verificado. Se você está trabalhando num repositório existente, você obterá provavelmente este nome do administrador. 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>
</formalpara>

<formalpara>
<title
>Pasta de trabalho</title>
<para
>A pasta sob o qual o módulo deve ser verificado. Observe que a pasta de nível superior da cópia de trabalho é sempre criada como uma pasta com o nome do módulo que ele comporta. </para>
</formalpara>

</sect1>


<sect1 id="mainscreen">
<title
>A tela principal</title>
<para
>Quando você inicia o &cervisia;, e abre uma cópia de trabalho escolhendo <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Abrir Cópia Local...</guimenuitem
></menuchoice
> você obtém uma visão hierárquica da pasta atual. De acordo com as configurações de seu arquivo <filename
>.cvsignore</filename
>, os arquivos que você comumente não quer incluir no repositório - como por ex. arquivos de objeto - não são exibidos. Para cada arquivo, você vê seu estado correspondente. Na configuração padrão, ele é "Desconhecido" porque o &cervisia; aguarda para atualizar as informações até você escolher <guimenuitem
>Atualizar</guimenuitem
> ou <guimenuitem
>Estado</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
>. 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>

<figure id="screenshot-mainview" float="1">
<title
>Um imagem da janela principal do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="mainview.png"/></imageobject>
<textobject
><phrase
>Um imagem da janela principal do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<para
>Os comandos no menu Arquivo comumente agem somente nos arquivos que você tenha marcado. Você pode também marcar pastas. Agora escolha <guimenuitem
>Atualizar</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
>. O &cervisia; envia um comando </para>

<para>
<screen
><command
>cvs update -n <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</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>

<itemizedlist>

<listitem
><para
>Modificado Localmente - Isto significa que você tem o arquivo modificado comparado com a versão do repositório. </para
></listitem>

<listitem
><para
>Adicionado Localmente - Isto significa que o arquivo não existe no repositório, mas em sua pasta 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
>Removido Localmente - 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>

<listitem
><para
>Precisa de Atualização - Isto é mostrado se uma nova versão do arquivo existe no repositório, por ex. 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>

<listitem
><para
>Precisa de Remendo - Isto é essencialmente o mesmo que o anterior. A diferença é somente a dica 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
>Precisa Mesclar - Indica que uma mesclagem da revisão deste arquivo na sua pasta com a versão no repositório é necessária. Isto tipicamente acontece se 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 ex. se alguém também modificou as mesmas linhas que você) o novo estado será então "Conflito". </para
></listitem>
       
<listitem
><para
>Atualizado - Indica que o arquivo é idêntico à versão do repositório. </para
></listitem>

<listitem
><para
>Conflito - 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
>Não no CVS - 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>

</itemizedlist>
      
<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 <guimenuitem
>Atualizar</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
>. (É claro, você pode já ter escolhido isto no início desta sessão). Para a maioria dos arquivos o estado pode 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>
      
<itemizedlist>

<listitem
><para
>Atualizado - Mostra se o arquivo foi atualizado a partir do repositório. </para
></listitem>

<listitem
><para
>Remendado - 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 é "Conflito". </para
></listitem>

</itemizedlist>
      
<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>

</sect1>
</chapter>

   
<chapter id="workingwithfiles">
<title
>Trabalhando com arquivos</title>

<para
>Todas as funcionalidades comumente 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
>Sincronizar...</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
>Você pode simplesmente editar um arquivo dando um duplo-clique nele ou pressionando <keycap
>Return</keycap
>. Isto inicia o editor configurado em <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar Cervisia...</guimenuitem
></menuchoice
> com o nome do arquivo como argumento. </para>

<sect1 id="addingfiles">
<title
>Adicionando arquivos</title>

<para
>Adicionar arquivos para um projeto requer dois passos. Primeiro, os arquivos devem ser registrados com o &CVS;. Para esse fim, marque todos os arquivos a serem adicionados na janela principal do &cervisia;. Então, escolha <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Adicionar para repositório</guimenuitem
></menuchoice
>. O &cervisia; realizará um comando</para>

<para>
<screen
><command
>cvs add <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>Se a operação tiver sucesso, a coluna de estado deverá possuir "Adicionado ao repositório" para os arquivos adicionados. </para>

<para
>Para colocar os arquivos no repositório, você pode também realizar um envio. Este procedimento tem uma importante vantagem. Você pode realizar uma sincronização dos arquivos junto com modificações de outras partes do projeto. Quando fizer isto, você pode facilmente ver (por ex. nos emails de sincronização) que todas as mudanças são parte de um todo. </para>

<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 (&eg; no string <literal
>&dollar;Revision: 1.6 &dollar;</literal
>) quando um arquivo é enviado. Em arquivos binários, estas substituições podem corromper o arquivo e fazê-lo completamente inutilizável. Para desabilitar este comportamento, você deve sincronizar arquivos binários (ou outros arquivos, como Postscript) com uma linha de comando </para>

<para>
<screen
><command
>cvs add -kb <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>No &cervisia;, isto é conseguido escolhendo <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Adicionar binário...</guimenuitem
></menuchoice
> </para>

</sect1>


<sect1 id="removingfiles">
<title
>Removendo arquivos</title>

<para
>Como na adição de arquivos, a remoção de arquivos é feita em dois passos: Primeiro, os arquivos devem ser registrados como removidos escolhendo <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Remover do repositório</guimenuitem
></menuchoice
> que corresponde ao comando </para>
<para>
<screen
><command
>cvs remove -f <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>Após isto, esta modificação para cópia local deve ser enviada, possivelmente junto com outras modificações ao projeto. </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>

</sect1>
   
   
<sect1 id="addingremovingdirs">
<title
>Adicionando e removendo pastas</title>

<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 ex. você não pode dizer quais pastas existem no projeto num 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" numa 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 Vazios Ao Atualizar</guimenuitem
></menuchoice
>. </para>

<para
>Uma pasta pode ser adicionada ao repositório com o comando </para>

<para>
<screen
><command
>cvs add <replaceable
>nomedapasta</replaceable
></command
></screen>
</para>

<para
>que é executado pelo ítem de menu <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Adicionar ao repositório</guimenuitem
></menuchoice
>. Observe que ao contrário da adição de arquivos, adicionar pastas não necessita de um envio posterior. </para>

</sect1>


<sect1 id="commitingfiles">
<title
>Enviando arquivos</title>

<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 'envia'. Com uma sincronização, 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 escolha <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Sincronizar...</guimenuitem
></menuchoice
>. </para>

<figure id="screenshot-commit" float="1">
<title
>Uma imagem do diálogo de envio do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="commit.png"/></imageobject>
</mediaobject>
</figure>

<para
>Você obterá um diálogo que lhe mostra no topo uma lista dos arquivos selecionados e na parte inferior uma mensagem de log para suas mudanças. Quando você tiver terminado o diálogo, o comando </para>

<para>
<screen
><command
>cvs commit -m <replaceable
>mensagem</replaceable
> <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>é usado. O &cervisia; lhe auxilia de diversas formas para encontrar um mensagem de log significativa. Primeiro, na lista de arquivos você pode dar um duplo-clique num 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 log que você usou previamente numa caixa combinada. Em terceiro, este diálogo é integrado com o editor de changelog do &cervisia; descrito abaixo. </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>

<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>
<screen
><prompt
>%</prompt
><userinput
>cvs update -r X</userinput
></screen>
</para>
<para
>(que é &eg; 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>
</note>

<para
>Com o &cervisia;, é muito fácil manter um arquivo de ChangeLog que é criado com o layout de formatação das linhas guia de codificação GNU. Para usá-lo, escolha <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 log configurada para a mensagem que você inseriu por último no change log. </para>

</sect1>


<sect1 id="resolvingconflicts">
<title
>Resolvendo conflitos</title>

<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
>É seu trabalho agora resolver estes conflitos antes de você enviar o arquivo. O &CVS; se recusará a sincronizar qualquer arquivo com conflitos até que eles sejam editados. É 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
>Na janela principal do &cervisia;, arquivos com conflitos são indicados com "Conflito" na coluna de estado e com uma cor vermelha. 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. Mas você pode também escolher usar o diálogo disponível via <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Resolver...</guimenuitem
></menuchoice
>. </para>

<figure id="screenshot-resolve" float="1">
<title
>Uma imagem da caixa de diálogo resolver do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="resolve.png"/></imageobject>
<textobject
><phrase
>Uma imagem da caixa de diálogo resolver do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<para
>No topo do diálogo, você vê sua versão do arquivo no lado esquerdo e a versão do repositório no lado direito. As diferenças entre eles estão marcadas com a cor vermelha. Abaixo destas duas versões, você pode ver a versão mesclada que será salva assim que você clique o botão <guibutton
>Salvar</guibutton
>. </para>

<para
>Você pode alternar entre as diferentes seções pressionando <guibutton
>&lt;&lt;</guibutton
> e <guibutton
>&gt;&gt;</guibutton
>. Na metade inferior do diálogo você pode ver qual seção está atualmente marcada. Por exemplo, <literal
>2 de 8</literal
> significa que você está atualmente na segunda seção de diff de um total de 8. Agora pode decidir seção por seção qual das duas versões você deseja que esteja no arquivo mesclado. Pressionando <guibutton
>A</guibutton
>, você acessa a versão que você editou. Pressionando <guibutton
>B</guibutton
>, você acessa a versão do repositório. </para>

</sect1>

</chapter>


<chapter id="obtaininginformation">
<title
>Obtendo informações sobre os arquivos</title>

<sect1 id="browsinglogs">
<title
>Navegando nos logs do cvs</title>

<para
>Quando você marca um arquivo na janela principal e escolhe <guimenuitem
>Navegar log</guimenuitem
> no menu <guimenu
>Ver</guimenu
>, um comando </para>

<para>
<screen
><command
>cvs log <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>é enviado e um diálogo é mostrado que reflete o histórico da versão do arquivo marcado. </para>

<figure float="1">
<title
>Uma imagem do diálogo de navegação de logs do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="logtree.png"/></imageobject>
<textobject
><phrase
>Uma imagem do diálogo de navegação de logs do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<para
>Você pode escolher ver o histórico como uma árvore ou na forma de lista. 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 log. A lista é de natureza linear e não oferece uma visão imediata das versões. Por outro lado, ela concentra mais informações relevantes em menor espaço de tela, nomeando a hora de cada mudança do arquivo e a primeira parte da mensagem de log. </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 se você fizer uso de características futuras oferecidas 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. </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. </para>

<para
>Se você pressionar o botão <guibutton
>Diff</guibutton
>, uma chamada <command
>cvs diff</command
> é enviada e você obterá um diálogo na qual todas as modificações entre as duas revisões marcadas serão mostradas. Para tornar fácil ver as mudanças, cores diferentes são usadas para marcar linhas que foram adicionadas, removidas ou simplesmente mudadas. </para>

</sect1>

   
<sect1 id="browsinghistory">
<title
>Navegando o histórico</title>

<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>

<para>
<screen
><command
>cvs history -e -a</command
></screen>
</para>

<note
><para
>Isto atualiza o arquivo completo de logging 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>

<para
>Agora você pode ver a lista de eventos, ordenada por data. Na segunda coluna, o tipo de evento é mostrado: </para>

<itemizedlist>

<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 pasta 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>

</itemizedlist>

<figure id="screenshot-history" float="1">
<title
>Um imagem do diálogo de histórico do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="history.png"/></imageobject>
<textobject
><phrase
>Um imagem do diálogo de histórico do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<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>

<itemizedlist>
<listitem
><para
>Mostrar eventos de envio - mostrar envios</para
></listitem>
<listitem
><para
>Mostrar eventos de verificação - mostrar verificações</para
></listitem>
<listitem
><para
>Mostrar eventos de tag - mostrar tags</para
></listitem>
<listitem
><para
>Mostrar outros eventos - mostrar eventos não incluídos acima</para
></listitem>
<listitem
><para
>Somente usuário - mostrar somente eventos causados por um determinado usuário</para
></listitem>
<listitem
><para
>Somente nomes de arquivo correspondente à - filtra os nomes de arquivo por uma expressão regular</para
></listitem>
<listitem
><para
>Somente nomes de pasta correspondentes à - filtra os nomes de pasta por uma expressão regular</para
></listitem>
</itemizedlist>

<para
>Caracteres especiais reconhecidos pelas expressões regulares de correspondência são: </para>

<itemizedlist>

<listitem
><para
><literal
>x*</literal
> corresponde a qualquer número de ocorrências do caracter <literal
>x</literal
>. </para
></listitem>

<listitem
><para
><literal
>x+</literal
> corresponde a uma ou mais ocorrências do caracter <literal
>x</literal
>. </para
></listitem>

<listitem
><para
><literal
>x?</literal
> corresponde a zero ou uma ocorrência do caracter <literal
>x</literal
>. </para
></listitem>

<listitem
><para
><literal
>^</literal
> corresponde ao início do string. </para
></listitem>

<listitem
><para
><literal
>$</literal
> corresponde ao final do string. </para
></listitem>

<listitem
><para
><literal
>[a-cx-z]</literal
> corresponde ao conjunto de caracteres, &eg; aqui a conjunto consiste de a,b,c,x,y,z. </para
></listitem>

</itemizedlist>

</sect1>


<sect1 id="diff">
<title
>Encontrando diferenças entre revisões</title>

<para
>Existem diversos locais no &cervisia; onde você pode pedir por uma janela mostrando as diferenças entre as revisões de um arquivo. </para>

<itemizedlist>

<listitem
><para
>Na visão principal, você pode escolher <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 com <literal
>BASE</literal
>). Isto é particularmente útil apenas antes de você enviar um arquivo, de modo que você possa encontrar uma mensagem de log apropriada. </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 é muito similar ao uso do <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Diferença para repositório...</guimenuitem
></menuchoice
> com o respectivo arquivo na janela principal. </para
></listitem>

<listitem
><para
>No diálogo do navegador de logs, você pode marcar duas revisões de um arquivo e solicitar um diálogo que mostra as diferenças entre eles (veja a seção <xref linkend="browsinglogs"/>). </para
></listitem>

</itemizedlist>

<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>

<figure id="screenshot-log" float="1">
<title
>Uma imagem do diálogo de diferenças do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="diff.png"/></imageobject>
<textobject
><phrase
>Uma imagem do diálogo de diferenças do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<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-commands"/>. </para>

</sect1>


<sect1 id="annotate">
<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 esta característica, mas ele posteriormente enriquece as informações de uma maneira interativa. Você obtém uma visão anotada escolhendo <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Anotação...</guimenuitem
></menuchoice
>. Outra possibilidade é pressionar o botão <guilabel
>Anotação</guilabel
> no diálogo de navegação de log. Em <xref linkend="screenshot-annotate"/> você pode ver uma imagem do diálogo. </para>

<figure id="screenshot-annotate" float="1">
<title
>Um imagem do diálogo de anotação do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="annotate.png"/></imageobject>
<textobject
><phrase
>Uma imagem do diálogo de atualização de tag do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<para
>No diálogo de anotação, você pode ver numa janela a última versão do arquivo selecionado. Nas colunas antes do texto, você obtém algumas informações relacionadas à última mudança em cada linha. Na primeira coluna o número de revisão é mostrado. Na segunda coluna você vê o nome do autor da revisão. Finalmente, na terceira coluna você vê a data da última mudança na 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>

</sect1>

</chapter>


<chapter id="advancedusage">
<title
>Uso avançado</title>

<sect1 id="taggingbranching">
<title
>Tags e ramificações</title>

<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 maus 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: Escolha <menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Excluir tag</guimenuitem
></menuchoice
> na janela principal. </para>

<para
>Existem diversas maneiras de atualizar um determinado estado do projeto: </para>

<itemizedlist>

<listitem
><para
>Você pode atualizar uma determinada tag. Use <menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Atualizar para tag/data</guimenuitem
></menuchoice
> para isto. O mesmo procedimento é usado para atualizar uma ramificação. O comando enviado pelo &cervisia; é </para>

<para>
<screen
><command
>cvs update -r <replaceable
>tag</replaceable
></command
></screen>
</para
></listitem>

<listitem
><para
>Você pode atualizar uma determinada data. Isto pode ser útil se um erro foi introduzido no projeto entre duas versões, você sabe aproximadamente entre quais, e tem uma idéia de quando foi. Você pode ir para alguma data escolhendo <menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Atualizar para tag/data</guimenuitem
></menuchoice
> e habilitar a caixa <guibutton
>Atualizar para data</guibutton
>. 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
>. Quando você usa esta opção o &cervisia; usa o comando </para>

<para>
<screen
><command
>cvs update -D <replaceable
>data</replaceable
></command
></screen>
</para
></listitem>

<listitem
><para
>Ambas opções acima fazem uma tag ou data seja 'pregada', isto é, você não pode enviar futuras modificações nestes arquivos (ao menos que a tag seja uma tag de ramificação). Para retornar ao tronco, também conhecido como a ramificação com o nome <literal
>HEAD</literal
>, use o ítem de menu <menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Atualizar para HEAD</guimenuitem
></menuchoice
>. Isto resulta num comando </para>
<para>
<screen
><command
>cvs update <option
>-A</option
></command
></screen>
</para
></listitem>

</itemizedlist>

<figure id="screenshot-updatetag" float="1">
<title
>Uma imagem do diálogo de atualização de tag do &cervisia;</title>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="updatetag.png"/></imageobject>
<textobject
><phrase
>Uma imagem do diálogo de atualização de tag do &cervisia;</phrase
></textobject>
</mediaobject>
</figure>

<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>
<screen
><command
>cvs update <option
>-j</option
> <replaceable
>tagramificação</replaceable
></command
></screen>
</para>

<para
>A outra possibilidade é que você deseja mesclar somente as modificações feitas entre duas tags numa 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á num comando </para>

<para>
<screen
><command
>cvs update <option
>-j</option
> <replaceable
>tagramificação1</replaceable
> <option
>-j</option
> <replaceable
>tagramificação2</replaceable
></command
></screen>
</para>

</sect1>


<sect1 id="watches">
<title
>Usando monitores</title>

<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 escolher receber uma notificação para qualquer tipo de evento que o &CVS; suporta. Por exemplo, se você somente quer receber notificações quando um arquivo é enviado, habilite as caixas <guibutton
>Somente</guibutton
> e <guibutton
>Sincronizações</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>
<screen
><command
>cvs watch add -a commit <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>ou com uma opção similar, dependendo dos eventos que você escolher monitorar. </para>

<para
>Se você não está mais interessado em alguns arquivos, você pode remover seus 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>
<screen
><command
>cvs watch remove <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>possivelmente com uma opção <option
>-a</option
> para a escolha dos eventos. </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á num comando </para>

<para>
<screen
><command
>cvs watchers <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</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 num 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>
<screen
><command
>cvs edit <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</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>
<screen
><command
>cvs editors <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</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>
<screen
><command
>echo y | cvs unedit <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</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ê pode editar seu arquivo normalmente. Quando você tiver terminado seu trabalho, envie seus arquivos e os arquivos enviados serão somente leitura novamente. </para>

</sect1>


<sect1 id="locking">
<title
>Travando</title>

<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>
<screen
><command
>cvs admin -l <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

<para
>O efeito reverso é obtido usando <menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Destravar</guimenuitem
></menuchoice
>. Isto executa o comando</para>

<para>
<screen
><command
>cvs admin -u <replaceable
>nomesdosarquivos</replaceable
></command
></screen>
</para>

</sect1>

</chapter>


<chapter id="customization">
<title
>Personalizando o &cervisia;</title>

<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 num diálogo comum que está disponível via <menuchoice
><guimenu
>Opções</guimenu
><guimenuitem
>Configurações...</guimenuitem
></menuchoice
>. </para>


<sect1 id="customize-general">
<title
>Geral</title>

<formalpara id="customize-username">
<title
>Nome de usuário para o editor de ChangeLog</title>
<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 de e-mail em cada uma de suas entradas no ChangeLog. Aqui você pode configurar isto. </para>
</formalpara>

<formalpara id="customize-cvspath">
<title
>Caminho para cvs</title>
<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 encontrado em seu <envar
>$PATH</envar
> é usado pelo &cervisia;. </para>
</formalpara>

<formalpara id="customize-editor">
<title
>Editor</title>
<para
>Aqui você pode configurar qual editor é chamado quando um arquivo na janela principal recebe um clique duplo. Para executar o editor, a entrada colocada aqui é concatenada com o nome do arquivo e enviada para o shell. Logo é aceitável usar programas como <command
>gnuclient</command
> aqui. Você também pode inserir um string <envar
>$EDITOR</envar
> se sua variável de ambiente <envar
>$EDITOR</envar
> apontar para um editor que abra uma janela do X11 automaticamente. </para>
</formalpara>

</sect1>

<sect1 id="customize-commands">
<title
>Comandos variados</title>

<formalpara id="customize-context">
<title
>Número das linhas de contexto no diálogo de diferenças</title>
<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 diferente. Aqui você pode configurar o argumento para <option
>-U</option
>. </para>
</formalpara>

<formalpara id="customize-diffopt">
<title
>Opções adicionais para o cvs diff</title>
<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>
</formalpara>

<formalpara id="customize-tabwidth">
<title
>Largura da tabulação no diálogo de diferenças</title>
<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>
</formalpara>

<formalpara id="customize-difffrontend">
<title
>Frontend externo do diff</title>
<para
>Quando você usa qualquer das características que mostram o diálogo de diferenças, como <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Diferenças para Repositório...</guimenuitem
></menuchoice
>, o &cervisia; invoca seu frontend interno do diff. Se você preferir um diferente, como <application
>Kompare</application
>, <application
>TkDiff</application
>, ou <application
>xxdiff</application
>, você pode configurar isto aqui. </para>
</formalpara>

<formalpara id="customize-startstatus">
<title
>Iniciar <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Estado</guimenuitem
></menuchoice
> automaticamente</title
> 

<para
>Quando você habilita esta opção, o comando <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Estado</guimenuitem
></menuchoice
> é iniciado sempre que você abre uma cópia local. Como este comando pode precisar de algum tempo e também necessita de uma conexão para o servidor para repositórios remotos (tornando-o indisponível para uso off-line), você pode configurar esta opção separadamente para repositórios locais e remotos. </para>
</formalpara>

<formalpara id="customize-timeout">
<title
>Limite de tempo após o qual um diálogo de progresso aparece</title>
<para
>Praticamente todos os comando &CVS; iniciados numa cópia local que se estendem a um repositório remoto necessitam de uma conexão para o servidor &CVS;. Isto é afetado pelas demoras da conexão da rede ou uma sobrecarga no servidor. Por esta razão, para comandos como <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Diferenças 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>
</formalpara>

<formalpara id="customize-compression">
<title
>Nível padrão de compressão</title>
<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>
</formalpara>

</sect1>


<sect1 id="customize-look">
<title
>Aparência</title>

<formalpara id="customize-splitter">
<title
>Dividir janela principal horizontalmente</title>
<para
>A janela principal do &cervisia; é normalmente dividida verticalmente numa janela com a árvore de arquivos e uma com a saída. Alternativamente, você pode arranjá-las horizontalmente. </para>
</formalpara>

<formalpara id="customize-protocolfont">
<title
>Fonte para janela de protocolo</title>
<para
>Esta é a fonte usada na janela de protocolo. Esta é a janela que mostra a saída do cliente <command
>cvs</command
>. </para>
</formalpara>

<formalpara id="customize-annotatefont">
<title
>Fonte para visão anotada</title>
<para
>Esta é a fonte usada na visão anotada. </para>
</formalpara>

<formalpara id="customize-difffont">
<title
>Fonte para visão das diferenças</title>
<para
>Esta é a fonte usada em diálogos de diferença. </para>
</formalpara>

</sect1>
</chapter>


<chapter id="appendix">
<title
>Apêndice</title>

<sect1 id="ignoredfiles">
<title
>Arquivos ignorados</title>

<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>

<itemizedlist>

<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>
<listitem
><para
>O arquivo <filename
><envar
>$HOME</envar
>/.cvsignore</filename
>. </para
></listitem>

<listitem
><para
>A variável de ambiente <envar
>$CVSIGNORE</envar
>. </para
></listitem>
<listitem
><para
>O arquivo <filename
>.cvsignore</filename
> na respectiva pasta. </para
></listitem>

</itemizedlist>

<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>

</sect1>
   

<sect1 id="information">
<title
>Informações adicionais e suporte</title>

<itemizedlist>

<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 está 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 numa <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>

</itemizedlist>

</sect1>
   

<sect1 id="commandreference">
<title
>Referência de Comandos</title>
      
<!-- File Menu -->
<sect2 id="menufile">

<title
>O Menu Arquivo</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Abrir Cópia Local...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre uma cópia local na janela principal. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Cópias locais recentes</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre uma das cópias locais que foi usada recentemente. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Inserir entrada ChangeLog...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre o editor de ChangeLog, preparado de modo que você possa adicionar uma nova entrada com a data atual. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>&Ctrl;</keycap
><keycap
>U</keycap
></keycombo
></shortcut
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Atualizar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>F5</keycap
></shortcut
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Estado</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa um 'cvs update' nos arquivos selecionados e muda o estado e número de revisão na lista de acordo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Editar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre o arquivo selecionado em seu editor. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Resolver...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo para o arquivo selecionado que lhe permite resolver conflitos de mesclagem nele. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>#</keycap
></shortcut
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Enviar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Permite-lhe enviar os arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Adicionar binário...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Permite-lhe adicionar os arquivos selecionados ao repositório como binários (<command
>cvs add<option
>-kb</option
></command
>). </para
></listitem>
</varlistentry>

<varlistentry>
<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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Reverter</guimenuitem
> </menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>&Ctrl;</keycap
><keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Sai do &cervisia;. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<!-- View Menu -->
<sect2 id="menuview">

<title
>O Menu Ver</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>Escape</keycap
></shortcut
> <guimenu
>Ver</guimenu
><guimenuitem
>Parar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Aborta qualquer sub-processo em execução. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>&Ctrl;</keycap
><keycap
>L</keycap
></keycombo
></shortcut
> <guimenu
>Ver</guimenu
><guimenuitem
>Navegar Log...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Mostra a árvore de revisão do arquivo selecionado. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>&Ctrl;</keycap
><keycap
>A</keycap
></keycombo
></shortcut
> <guimenu
>Ver</guimenu
><guimenuitem
>Anotações...</guimenuitem
> </menuchoice
></term>
<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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>&Ctrl;</keycap
><keycap
>D</keycap
></keycombo
></shortcut
> <guimenu
>Ver</guimenu
><guimenuitem
>Diferença para repositório...</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). </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Última Mudança...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Mostra as diferenças entre a revisão do arquivo selecionado que você atualizou por último (BASE) e a revisão anterior. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Histórico...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Mostra o histórico &CVS; como reportado pelo servidor. </para
></listitem>
</varlistentry>

<varlistentry>
<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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Colapsar árvore de arquivos</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Fecha todos os níveis na árvore de arquivos. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<!-- Advanced Menu -->
<sect2 id="menuadvanced">

<title
>O Menu Avançado</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Tag/Ramificação...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cria tags ou ramificações para os arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Excluir tag...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Remove uma tag fornecida dos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Atualizar para Tag/Data...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Traz os arquivos selecionados para uma tag ou data fornecida, pregando-os. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Atualizar para HEAD...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Traz os arquivos selecionados para a revisão HEAD respectiva. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Mesclar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Mescla seja uma ramificação fornecida ou as modificações entre duas tags dos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Adicionar monitor...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Adiciona um monitor para um conjunto de eventos dos arquivos selecionados. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Remover monitor...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Remove um monitor para um conjunto de eventos dos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Mostrar monitores</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Lista os monitores dos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Editar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa um <command
>cvs edit</command
> nos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Cancelar edição</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa um <command
>cvs unedit</command
> nos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Mostrar editores</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Executa um <command
>cvs editors</command
> nos arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Travar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Trava os arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Destravar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Destrava os arquivos selecionados. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Avançado</guimenu
><guimenuitem
>Criar remendo contra repositório...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cria um remendo das modificações em sua cópia local. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<!-- Repository Menu -->
<sect2 id="menurepository">

<title
>O Menu Repositório</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Repositório</guimenu
><guimenuitem
>Verificar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo que lhe permite verificar um módulo a partir de um repositório. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Repositório</guimenu
><guimenuitem
>Importar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo que lhe permite importar um pacote para o repositório. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Repositório</guimenu
><guimenuitem
>Repositórios...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Configura uma lista de repositórios que você freqüentemente usa e como acessá-los. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<!-- Settings Menu -->
<sect2 id="menuoptions">
<title
>O Menu Configurações</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo para configurar atalhos de teclado. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar o Cervisia...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo para personalização do &cervisia;. </para
></listitem>
</varlistentry>

<varlistentry>
<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>
</varlistentry>

<varlistentry>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Atualizar recursivamente</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Determina se atualizações são recursivas (Opção <option
>-r</option
> do <command
>cvs update</command
>). </para
></listitem>
</varlistentry>

<varlistentry>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Executar cvs edit automaticamente quando necessário</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Determina se o <command
>cvs edit</command
> é executado automaticamente sempre que você edita um arquivo. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<!-- Help -->
<sect2 id="menuhelp">
<title
>O Menu Ajuda</title>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>F1</keycap
></shortcut
> <guimenu
>Ajuda</guimenu
><guimenuitem
>Livro de Mão do Cervisia</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Invoca o sistema de ajuda do KDE iniciando as páginas de ajuda do &cervisia; (este documento). </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Reportar Erro...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre um diálogo de relatório de Erro. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
> <guimenuitem
>Sobre o &cervisia;</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Isto exibirá informações sobre a versão e o autor. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Sobre o KDE</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Isto exibe a versão do KDE e outras informações básicas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>Manual do CVS</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre as páginas de informação do &CVS; no sistema de ajuda do KDE. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>


<chapter id="credits-and-licenses">
<title
>Créditos E Licenças</title>
&underFDL; </chapter>
</book>
