<sect id="s-cvs-c">Clientes de CVS
 <p>
Esta seção traz alguns programas cliente em modo texto/gráfico e 
visualizadores de repositórios via web. Eles facilitam o trabalho 
de controle de revisão por parte de iniciantes e flexibilidade para 
pessoas mais experientes, além de ter uma interface de navegação 
disponível para todos os interessados em fazer pesquisas no 
repositório.


<sect1 id="s-cvs-c-cvs">cvs
 <p>
Este é o cliente <prgn>Unix</prgn> padrão, bastante poderoso e que opera em 
modo texto. As explicações neste capítulo do guia assumem este cliente de 
<prgn>cvs</prgn>, então as explicações sobre sua utilização se encontra em 
<ref id="s-cvs-p"> e os parâmetros de linha de comando em <ref id="s-cvs-opcoescmd">
 <p>
É <strong>altamente</strong> recomendável a leitura caso deseje utilizar um 
cliente de <prgn>cvs</prgn> gráfico, pois os conceitos são os mesmos. 


<sect1 id="s-cvs-c-gcvs">gcvs - Linux
 <p>
Este é um cliente CVS em GTK+Python para <prgn>Linux</prgn> que interage externamente 
com o cliente <prgn>cvs</prgn> externo, todas as opções do cvs estão disponíveis 
através de checkboxes nas telas de comando, incluindo suporte a compactação, 
visualizador gráfico da árvore de releases, histórico, diffs, etc. 
 <p>
Sua instalação é bastante fácil, instale o programa com 
<tt>apt-get install gcvs</tt> e execute o programa através do menu do sistema ou 
do terminal. Utilize os seguintes procedimentos para configurar e 
utilizar o programa: 
<enumlist compact>
 <item>
Defina o repositório <var>CVSROOT</var> através do menu 
<em>Admin</em>/<em>Preferences</em>. Selecione o método de 
acesso, entre com o login, servidor e repositório.
 <example>
Exemplo: :pserver:anonymous@servidor:/var/lib/cvs
 </example>
O formato deve ser <em>EXATAMENTE</em> como o usado na 
variável CVSROOT no shell, incluindo os ":". Caso tenha 
erros de login, verifique o valor de <var>CVSROOT</var>
cuidadosamente antes de contactar o administrador de sistemas!

 <item>
Agora faça o login no sistema em: <em>Admin</em>, <em>Login</em>. Note 
que o status de todas as operações do <prgn>cvs</prgn> são mostradas
na janela de status que fica na parte inferior da tela.

 <item>
Crie um diretório que será usado para armazenar os fontes
baixados do CVS, por exemplo: <tt>mkdir ~/projetos</tt>

 <item>
Acesse o menu <em>Create</em>, <em>Checkout Module</em> para 
baixar o projeto do CVS para sua máquina local. Ele irá te pedir o 
nome de diretório para onde o código fonte do servidor CVS será baixado. 
Digite <file>~/projetos</file> ou outro diretório que foi criado no passo 
anterior.

<![ %OBS [ 
 <p>
<strong>OBS: </strong> Não utilize o nome <file>"cvs"</file> para 
o diretório local, pois o <prgn>gcvs</prgn> oculta automaticamente
pois os arquivos administrativos de controle ficam neste local. ]]>


 <item>
Altere o diretório padrão do <prgn>gcvs</prgn> para o diretório 
onde baixou o projeto (<file>~/projetos</file>)clicando no botão 
"set" no topo da coluna esquerda do <prgn>gcvs</prgn>.

 <item>
Para enviar um arquivo modificado de volta ao servidor, selecione os arquivos, 
clique em <em>Modify</em>, <em>Commit Selection</em>, entre com a mensagem 
descrevendo as alterações e clique em "OK".
 <p>
Note que os arquivos modificados serão identificados por um ícone vermelho 
e seu status será "Mod. File" (arquivo modificado).

 <item>
Se desejar adicionar um novo projeto no CVS, entre em <em>Create</em>, 
<em>Import Module</em>, entre no diretório que deseja adicionar como 
um projeto no servidor de CVS. Após isto será feita uma checagem
e mostrada uma tela de possíveis problemas que podem ocorrer 
durante a importação do novo projeto. 
 <p>
Na próxima tela, digite o nome do módulo e caminho no servidor 
remoto no primeiro campo, no segundo campo a mensagem de log 
para adicionar o projeto ao servidor. Em "Vendor tag" 
especifique o nome do projeto e sua versão logo abaixo. Clique 
em "OK" e aguarde a transferência dos arquivos para o servidor. 
 <p>
Para maiores detalhes sobre a criação de novos projetos no 
servidor de CVS, veja <ref id="s-cvs-p-import">.
<![ %OBS [
 <p>
<strong>OBS: </strong> Você deverá ter permissão de gravação para 
criar um novo projeto no servidor CVS. ]]>

 <item>
A partir de agora você poderá explorar as funções do programa e fazer 
uso das funções habituais do CVS. Todas as funções de operação e 
opções extras do CVS estão disponíveis na interface gráfica, basta se 
acostumar com sua utilização.

</enumlist>
Após isto, explore bastante as opções do programa. Todas as funcionalidades 
do CVS estão organizadas entre os menus do programa. Caso não entenda bem 
as funções do programa, leia atentamente <ref id="s-cvs-p"> e também não 
deixe de consultar detalhes na info page do cvs. 

<sect1 id="s-cvs-c-wincvs">WinCVS - Windows
 <p>
Este é um cliente CVS em Python para <prgn>Windows</prgn> equivalente ao 
<prgn>gcvs</prgn> para <prgn>Linux</prgn>. Suas funcionalidades e 
recomendações são idênticas aos do <prgn>gcvs</prgn>. Este cliente pode 
ser baixado de: <url id="&url-wincvs-down;"> 
e o Python para Windows de <url id="&url-python-win-down;">.
 <p>
Para sua utilização, as explicações em <ref id="s-cvs-c-gcvs"> são totalmente
válidas. 


<sect1 id="s-cvs-c-maccvs">MacCVS - Macintosh (PPC)
 <p>
Idêntico ao <prgn>gcvs</prgn>, pode ser baixado de
<url id="&url-maccvs-down;">.


<sect1 id="s-cvs-c-viewcvs">viewcvs
 <p>
Este é um visualizador de repositórios CVS via web, ele precisa apenas de um 
servidor web instalado com suporte a CGI. Para instalar, execute o comando 
<tt>apt-get install <package>viewcvs</package></tt> e siga os passos para 
configurar programa. Para adequar melhor o <prgn>viewcvs</prgn> ao seu sistema, 
edite o arquivo <file>/etc/viewcvs/viewcvs.conf</file>. 
 <p>
O <prgn>viewcvs</prgn> possui uma interface que se parece com a navegação de 
um diretório de ftp, recursos como a extração de diffs coloridos entre versões 
de um arquivo selecionado, visualização de commits (com data, log do commit, 
usuário, etc.), classificação da listagem exibida. 

<![ %OBS [
 <p>
<strong>OBS: </strong>Leve em consideração as implicações de segurança impostas 
por aplicativos cgi sendo executados em seu sistema. <![ %CAPJUNTOS [ 
Veja <ref id="s-apache"> para entender melhor o assunto. ]]> ]]>



