head	1.10;
access;
symbols
	TIGRIS_1_1_0RC2:1.7
	TIGRIS_1_1_0RC1:1.7
	TIGRIS_1_1:1.7.0.4
	TIGRIS_1_0_8:1.7
	TIGRIS_1_0_8RC3:1.7
	TIGRIS_1_0_8RC2:1.7
	TIGRIS_1_0_8RC1:1.7
	TIGRIS_1_0_7:1.7
	TIGRIS_1_0_7RC3:1.7
	TIGRIS_1_0_7RC2:1.7
	TIGRIS_1_0_7RC1:1.7
	TIGRIS_1_0_6:1.7
	TIGRIS_1_0_6RC5:1.7
	TIGRIS_1_0_6RC4:1.7
	TIGRIS_1_0_6RC3:1.7
	TIGRIS_1_0_6RC2:1.7
	TIGRIS_1_0_6RC1:1.7
	TIGRIS_1_0_5:1.7
	TIGRIS_1_0_5RC6:1.7
	TIGRIS_1_0_5RC5:1.7
	TIGRIS_1_0_5RC4:1.7
	TIGRIS_1_0_5RC3:1.7
	TIGRIS_1_0_5RC2:1.7
	TIGRIS_1_0_5RC1:1.7
	TIGRIS_1_0_4:1.7
	TIGRIS_1_0_3:1.7
	TIGRIS_1_0_2:1.7
	TIGRIS_1_0_1:1.7
	TIGRIS_1_0:1.7.0.6
	TIGRIS_1_0_0:1.7
	TIGRIS_1_0_0_RC1:1.7.0.2;
locks; strict;
comment	@# @;


1.10
date	2001.07.11.22.37.03;	author csjank;	state Exp;
branches;
next	1.9;

1.9
date	2001.06.21.07.07.40;	author jefflove;	state Exp;
branches;
next	1.8;

1.8
date	2001.06.11.03.14.33;	author jefflove;	state Exp;
branches;
next	1.7;

1.7
date	2001.03.16.22.17.18;	author csjank;	state Exp;
branches;
next	1.6;

1.6
date	2001.03.15.07.34.59;	author lori;	state Exp;
branches;
next	1.5;

1.5
date	2001.03.09.22.46.03;	author csjank;	state Exp;
branches;
next	1.4;

1.4
date	2001.02.11.18.29.47;	author jrobbins;	state Exp;
branches;
next	1.3;

1.3
date	2001.02.09.00.59.20;	author susank;	state Exp;
branches;
next	1.2;

1.2
date	2001.02.05.16.47.09;	author lori;	state Exp;
branches;
next	1.1;

1.1
date	2001.02.02.22.31.21;	author lori;	state Exp;
branches;
next	;


desc
@@


1.10
log
@Removed outdated screen shots and updated information to match new version of WinCVS.
@
text
@  <div class="docs" id="ddusingwincvs">
   
  <h2>Using WinCvs to Work with Project Source Files</h2>

   <p>If you are using MS Windows, you can use the graphical client called WinCvs to access a project's version controlled source code files. WinCvs looks and behaves similar to Windows Explorer. You can <a href="http://cvsgui.org/download.html">download WinCvs</a> on line and install it on your machine.</p>

   <h3>Help for WinCvs: Index</h3>

   <ul>
    <li>
     <strong>You are here:</strong> Setting up WinCvs 

     <ul>
      <li><a href="#gettingstarted">Getting Started</a></li>

      <li><a href="#settingcvsroot">Setting up cvsroot</a></li>
     </ul>
    </li>

    <li><a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></li>

    <li><a href="ddUsingWinCvs-02.html">Managing files in WinCvs</a></li>
   </ul>

   
  <h3><a id="gettingstarted" name="gettingstarted">Getting Started</a></h3>
  <p>After downloading and installing WinCvs, make a new directory on your hard 
    disk where you will store your working copy of the project's source files. 
    A good name for this directory is the one-word name of the project files you 
    need. If you are working on more than one project, you may wish to make a 
    general "<em>projects cvs</em> " folder, and then create subfolders for each 
    project by name.</p>
  <p>Select the "<em>project</em>" directory in the WinCvs program's left-hand 
    pane. (If you do not see your newly created projects directory right away, 
    you may need to refresh your view.) If your project directory is on a different 
    drive not displayed in the left-hand WinCvs pane, you will need to use the 
    <strong>Browse Location&gt;Change</strong> command under the <strong>View</strong> 
    menu. Be sure to double click on the drive or directory you want before clicking 
    <strong>OK</strong>.</p>
  <p><a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172">More about 
    setting a work area</a></p>

   
  <h3><a id="settingcvsroot" name="settingcvsroot">Setting up CVSroot</a></h3>

   <p>First you must define the location of the WinCvs main repository, the CVSROOT. If you are only working on one project at a time, you only need to set up the cvsroot setup once, i.e. the first time you use WinCvs to access the project's source repository through this site.</p>

   
  <ol>
    <li> From the <strong>Admin</strong> menu and select <strong>Preferences</strong> 
    </li>
    <li>Enter the CVS root in the in the CVS Root field on the <strong>General</strong> 
      tab. The CVS root should appear as: <i>[:pserver:username@@projectname.domain.net:/cvs]</i></li>
    <li>Click on <strong>Authentication</strong> then change the drop down menu 
      to <em>"passwd file on the cvs server"</em>.</li>
    <li> Click on the <strong>Global</strong> tab. </li>
    <li>Uncheck the "<strong>Checkout read-only</strong>" checkbox.</li>
    <li> Click on the <strong>Proxy</strong> tab. </li>
    <li>Check the "<strong>Connect using a proxy server</strong>" checkbox.</li>
    <li>Enter the host name or IP of proxy. For example: [<i>www.projectname.domain</i>]</li>
    <li>Enter port number for the proxy. For example: [<i>1080</i>]</li>
  </ol>

   <p><a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173">More about configuring WinCvs</a></p>

   <p>Now you are ready to begin <a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></p>

   <div class="courtesylinks">
    <p><a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>
  </div>
 


@


1.9
log
@html usage revision
@
text
@d2 2
a3 1
   <h2>Using WinCvs to work with project source files</h2>
d25 17
a41 1
   <h3><a id="gettingstarted" name="gettingstarted">Getting started</a></h3>
d43 2
a44 13
   <p>When you launch WinCvs, you see a screen that looks like this:</p>

   <p><img alt="" src="images/wincvs_launch.gif" height="576" width="641" /></p>

   <p>Before going further, make a new directory on your hard disk where you will store your working copy of the project's source files. A good name for this directory is the one-word name of the project files you need. If you are working on more than one project, you may wish to make a general "<em>projects cvs</em> " folder, and then create subfolders for each project by name.</p>

   <p>Select the "<em>project</em>" directory in the WinCvs program's left-hand pane. (If you do not see your newly created projects directory right away, don't worry! You may need to collapse and expand the tree to force it to refresh.) If your project directory is on a different drive not displayed in the left-hand WinCvs pane, you will need to use the <strong>Change browse location...</strong> command under the <strong>View</strong> menu. Be sure to double click on the drive or directory you want before clicking <strong>OK</strong>.</p>

   <p><img alt="" src="images/wincvs_browse.gif" height="396" width="441" /></p>

   <p><a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172">More about setting a work area</a></p>

   <h3><a id="settingcvsroot" name="settingcvsroot">Setting up cvsroot</a></h3>
d48 3
a50 15
   <ol>
    <li>
     From the <strong>Admin</strong> menu and select <strong>Preferences</strong> 

     <p><img alt="" src="images/wincvs_prefs.gif" height="396" width="441" /></p>
    </li>

    <li>Replace "username" with your username on the <strong>General</strong> tab.</li>

    <li>Click on <strong>Authentication</strong> then change the drop down menu to <em>"passwd file on the cvs server"</em>.</li>

    <li>
     Click on the <strong>Global</strong> tab. 

     <p><img alt="" src="images/wincvs_global_pref.gif" height="284" width="452" /></p>
d52 5
a56 1

d58 1
a58 7

    <li>
     Click on the <strong>Proxy</strong> tab. 

     <p><img alt="" src="images/wincvs_global_proxy.gif" height="284" width="452" /></p>
    </li>

d60 3
a62 5

    <li>Enter the host name or IP of proxy. For example: www.projectname.domain</li>

    <li>Enter port number for the proxy. For example: 1080</li>
   </ol>
@


1.8
log
@extensive markup rework - first pass toward house xhtmlification
@
text
@d1 10
a10 23
<!DOCTYPE html PUBLIC "-//CollabNet//DTD XHTML 1.0 Transitional//EN"
"http://collabnet.com/dtds/collabnet_transitional_10.dtd">
<html>
 <head>
  <title>Using WinCVS</title>
<style type="text/css">
 div.c2 {margin-left: 2em}
 dt.c1 {font-weight: bold}
</style>
 </head>

 <body>
<div class="docs" id="docid">
<h2>Using WinCvs to work with project source files</h2>
   

  <p>If you are using MS Windows, you can use the graphical client called WinCvs to access a project's version controlled source code files. WinCvs looks and behaves similar to Windows Explorer. You can <a href="http://cvsgui.org/download.html">download WinCvs</a> on line and install it on your machine.</p>

  <p><b>Help for WinCvs: Index</b></p>

  <div class="c2">
   <dl>
    <dt>You are here: Setting up WinCvs</dt>
a11 1
    <dd>
d13 1
a13 1
      <li><b><a href="#gettingstarted">Getting Started</a></b></li>
d15 1
a15 1
      <li><b><a href="#settingcvsroot">Setting up cvsroot</a></b></li>
d17 1
a17 1
    </dd>
d19 1
a19 1
    <dt><a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></dt>
d21 4
a24 3
    <dt><a href="ddUsingWinCvs-02.html">Managing files in WinCvs</a></dt>
   </dl>
  </div>
d26 1
a26 3
  
  
  <h3><a id="gettingstarted" name="gettingstarted">Getting started</a></h3> 
d28 1
a28 1
  <p>When you launch WinCvs, you see a screen that looks like this:</p>
d30 1
a30 1
  <p><img alt="" src="images/wincvs_launch.gif" height="576" width="641" /></p>
d32 1
a32 1
  <p>Before going further, make a new directory on your hard disk where you will store your working copy of the project's source files. A good name for this directory is the one-word name of the project files you need. If you are working on more than one project, you may wish to make a general "<em>projects cvs</em> " folder, and then create subfolders for each project by name.</p>
d34 1
a34 1
  <p>Select the "<em>project</em>" directory in the WinCvs program's left-hand pane. (If you do not see your newly created projects directory right away, don't worry! You may need to collapse and expand the tree to force it to refresh.) If your project directory is on a different drive not displayed in the left-hand WinCvs pane, you will need to use the <strong>Change browse location...</strong> command under the <strong>View</strong> menu. Be sure to double click on the drive or directory you want before clicking <strong>OK</strong>.</p>
d36 1
a36 3
  <p><img alt="" src="images/wincvs_browse.gif" height="396" width="441" /></p>
  <p>
<a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172">
d38 1
a38 3
More about setting a work area</a> </p>
  
  <h3><a id="settingcvsroot" name="settingcvsroot">Setting up cvsroot</a></h3> 
d40 1
a40 1
  <p>First you must define the location of the WinCvs main repository, the CVSROOT. If you are only working on one project at a time, you only need to set up the cvsroot setup once, i.e. the first time you use WinCvs to access the project's source repository through this site.</p>
d42 3
a44 3
  <ol>
   <li>
    From the <strong>Admin</strong> menu and select <strong>Preferences</strong> 
d46 2
a47 2
    <p><img alt="" src="images/wincvs_prefs.gif" height="396" width="441" /></p>
   </li>
d49 1
a49 1
   <li>Replace "username" with your username on the <strong>General</strong> tab.</li>
d51 1
a51 1
   <li>Click on <strong>Authentication</strong> then change the drop down menu to <em>"passwd file on the cvs server"</em>.</li>
d53 2
a54 2
   <li>
    Click on the <strong>Global</strong> tab. 
d56 2
a57 2
    <p><img alt="" src="images/wincvs_global_pref.gif" height="284" width="452" /></p>
   </li>
d59 1
a59 1
   <li>Uncheck the "<strong>Checkout read-only</strong>" checkbox.</li>
d61 2
a62 2
   <li>
    Click on the <strong>Proxy</strong> tab. 
d64 2
a65 2
    <p><img alt="" src="images/wincvs_global_proxy.gif" height="284" width="452" /></p>
   </li>
d67 1
a67 1
   <li>Check the "<strong>Connect using a proxy server</strong>" checkbox.</li>
d69 1
a69 1
   <li>Enter the host name or IP of proxy. For example: www.projectname.domain</li>
d71 2
a72 2
   <li>Enter port number for the proxy. For example: 1080</li>
  </ol>
d74 1
a74 1
  <p><a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173">More about configuring WinCvs</a></p>
d76 1
a76 1
  <p>Now you are ready to begin <a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></p>
d78 5
a82 6
  
  
<div class="courtesylinks"><a href="/servlets/HelpTOC">Back to main Help index</a></div> 
 </div>
</body>
</html>
@


1.7
log
@html changes to fix font problems.
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 2
d4 7
a10 1
<head>
d12 4
a15 1
<title>Using WinCVS</title>
d17 1
a17 2
</head>
<body>
d19 82
a100 86
    <p>
    <span class="Header" nowrap>Using WinCvs to work with project source files</span> </p>
<span class="PlainText">
    <p>If you are using MS Windows, you can use the graphical client called
    WinCvs to access a project's version controlled source code files. WinCvs 
    looks and behaves similar to Windows Explorer. You can <a 
    href="http://cvsgui.org/download.html" target=_new>download WinCvs</a> on 
    line and install it on your machine.</p>



<p>	<b>Help for WinCvs: Index</b>
<ul>
	<dl>
	<dt><b>You are here: Setting up WinCvs 
        <ul>
              <li><a href="#gettingstarted">Getting Started</a></li>
			  <li><a href="#settingcvsroot">Setting up cvsroot</a></li>
		</ul></b>
        <dt><a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a> 
      <dt><a href="ddUsingWinCvs-02.html">Managing files in WinCvs</a> </dt></dl></ul>
<p>  

<hr noshade size=1>
<a name="gettingstarted"></a><span class="InputHeader">Getting started</span>

<p>When you launch WinCvs, you see a screen that looks like this:</p>

<p><img src="images/wincvs_launch.gif"></p>

<p>Before going further, make a new directory on your
hard disk where you will store your working copy of the project's source 
files. A good name for this directory is the one-word name of the project 
files you need. If you are working on more than one project, you may wish 
to make a general "<em>projects cvs</em> " folder, and then create subfolders for each project by name. </p> 

<p>Select the "<em>project</em>" directory in the 
WinCvs program's left-hand pane. (If you do not see your newly created 
projects directory right away, don't worry! You may need to collapse and 
expand the tree to force it to refresh.) If your project directory is on a 
different drive not displayed in the left-hand WinCvs pane, you will need 
to use the <strong>Change browse location... </strong>command under the 
<strong>View </strong>menu. Be sure to double click on the drive or 
directory you want before clicking <strong>OK</strong>.</p>

<p><img src="images/wincvs_browse.gif"></p>
<a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172" target="_new">More about setting a work area</a>

<hr noshade size=1>
<a name="settingcvsroot"></a><span class="InputHeader">Setting up cvsroot</span>

<p> First you must define the location of the WinCvs main repository, the CVSROOT. If you are only working on one project at a time, you only need to set up the cvsroot setup once, i.e. the first time you use WinCvs to access the project's source repository through this site.

<p><ol><li>From the <strong>Admin</strong> menu and select
<strong>Preferences</strong>       
<p><img src="images/wincvs_prefs.gif"><p></p>
<li>Replace "username" with your username on the 
        <strong>General</strong> tab. 
        
<li>Click on <strong>Authentication</strong> then 
change the drop down menu to <em>"passwd file on the cvs 
server"</em>. 
        
<li>Click on the <strong>Global</strong> tab. 
        
<p><img src="images/wincvs_global_pref.gif"><p></p>
<li>Uncheck the "<strong>Checkout read-only</strong>" checkbox. 
        
<li>Click on the <strong>Proxy</strong> tab. 
        
<p><img src="images/wincvs_global_proxy.gif"><p></p>
<li>Check the "<strong>Connect using a proxy 
server</strong>" checkbox. 
<li>Enter the host name or IP of proxy. For example: 
www.projectname.domain 
<li>Enter port number for the proxy. For example: 
1080</li>        
</ol>
<p> <a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173" target="_new">More about configuring WinCvs</a></p>
<p>Now you are ready to begin <a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></p>
    
<p>

<hr noshade size=1>
<a href="/servlets/HelpTOC">Back to main Help index</a>
</span>
d103 2
@


1.6
log
@broke into 3 smaller docs; html edits
@
text
@d12 1
a12 1
    <p>If you are using MS Windows, you can use the graphical client called 
d20 1
a20 1
<p>	<b>Help for WinCvs: Index</span></b>
d39 5
a43 5
<p>Before going further, make a new directory on your 
      hard disk where you will store your working copy of the project's source 
      files. A good name for this directory is the one-word name of the project 
      files you need. If you are working on more than one project, you may wish 
      to make a general "<em>projects cvs</em>                                                         " folder, and then create subfolders for each project by name. </p> 
d46 7
a52 7
      WinCvs program's left-hand pane. (If you do not see your newly created 
      projects directory right away, don't worry! You may need to collapse and 
      expand the tree to force it to refresh.) If your project directory is on a 
      different drive not displayed in the left-hand WinCvs pane, you will need 
      to use the <strong>Change browse location... </strong>command under the 
      <strong>View </strong>menu. Be sure to double click on the drive or 
      directory you want before clicking <strong>OK</strong>                                                                                  .</p>
d62 2
a63 2
<p><ol><li>From the <strong>Admin</strong> menu and select 
        <strong>Preferences</strong>       
d69 2
a70 2
        change the drop down menu to <em>"passwd file on the cvs 
        server"</em>. 
d81 5
a85 5
        server</strong>" checkbox. 
        <li>Enter the host name or IP of proxy. For example: 
        www.projectname.domain 
        <li>Enter port number for the proxy. For example: 
        1080</li>        
d87 3
a89 4
      <p> <a href="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173" target="_new">More about configuring WinCvs</a> 
      </p> 
      <p>Now you are ready to begin <a href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</a></p>
      
a93 3
      <p></p>

<p></p>
@


1.5
log
@broke the winCvs help file into three files to make load go faster
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 2
a2 2
<HTML>
<HEAD>
d4 1
a4 1
<TITLE>Using WinCVS</TITLE>
d6 7
a12 7
</HEAD>
<BODY>
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" WIDTH="100%" >
  <TR>
    <P>
    <span class="Header" nowrap>Using WinCvs to work with project source files</span> </P>
    <P>If you are using MS Windows, you can use the graphical client called 
d14 10
a23 11
    looks and behaves similar to Windows Explorer. You can <A 
    href="http://cvsgui.org/download.html" target=_new>download WinCvs</A> on 
    line and install it on your machineh.</P>
</TR></TABLE>

<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" width="100%" >
  <TR><TD class="PlainText">
<P>	<span class="InputHeader">Help for WinCvs: Index</span></p>
<UL>
	<DL>
	<DT>You are here: Setting up WinCvs 
d26 8
a33 11
			  <li><A href="#settingcvsroot">Setting up cvsroot</a></li>
		</ul>
        <Dt><A href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</A> 
      <Dt><A href="ddUsingWinCvs-02.html">Managing files in WinCvs</A> </dt></dl></ul>
      </tr></table>
   
<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" width="100%" >
  <TR>
<td>
<HR noShade SIZE=1>
<A NAME="gettingstarted"></A><span class="InputHeader">Getting started</span>
d35 1
a35 1
<P>When you launch WinCvs, you see a screen that looks like this:</P>
d37 1
a37 1
<P><IMG src="images/wincvs_launch.gif"></P>
d39 1
a39 1
<P>Before going further, make a new directory on your 
d43 1
a43 1
      to make a general "<EM>projects cvs</EM>                                                         " folder, and then create subfolders for each project by name. </P> 
d45 1
a45 1
<P>Select the "<EM>project</EM>" directory in the 
d50 17
a66 17
      to use the <STRONG>Change browse location... </STRONG>command under the 
      <STRONG>View </STRONG>menu. Be sure to double click on the drive or 
      directory you want before clicking <STRONG>OK</STRONG>                                                                                  .</P>

<P><IMG src="images/wincvs_browse.gif"></P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172" target="_new">More about setting a work area</A>

<HR noShade SIZE=1>
<A NAME="settingcvsroot"></A><span class="InputHeader">Setting up cvsroot</span>

<P> First you must define the location of the WinCvs main repository, the CVSROOT. If you are only working on one project at a time, you only need to set up the cvsroot setup once, i.e. the first time you use WinCvs to access the project's source repository through this site.

<p><ol><li>From the <STRONG>Admin</STRONG> menu and select 
        <STRONG>Preferences</STRONG>       
<p><IMG src="images/wincvs_prefs.gif"><p></p>
<li>Replace USERNAME with your username on the 
        <STRONG>General</STRONG> tab. 
d68 3
a70 3
<li>Click on <STRONG>Authentication</STRONG> then 
        change the drop down menu to <EM>"passwd file on the cvs 
        server"</EM>. 
d72 1
a72 1
<li>Click on the <STRONG>Global</STRONG> tab. 
d74 2
a75 3
<p><IMG src="images/wincvs_global_pref.gif"><p></p>
<li>Uncheck the "<STRONG>Checkout 
        read-only</STRONG>" checkbox. 
d77 1
a77 1
<li>Click on the <STRONG>Proxy</STRONG> tab. 
d79 3
a81 3
<p><IMG src="images/wincvs_global_proxy.gif"><p></p>
<li>Check the "<STRONG>Connect using a proxy 
        server</STRONG>" checkbox. 
d83 1
a83 1
        www.myprojectname.net 
d87 3
a89 4
      <P> <A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173" target="_new">More 
        about configuring WinCvs</A> 
      </P> 
      <P>Now you are ready to begin <A href="ddUsingWinCvs-01.html">Checking source files in and out of WinCvs</A></p>
d91 1
a91 1
<P>
d93 8
a100 9
<HR noShade SIZE=1>
<A href="/servlets/HelpTOC">Back to main Help index</A>
      <P></P>

<p></P>
</tr>
</TABLE>
</BODY>
</HTML>
@


1.4
log
@added <title> tags to all files
@
text
@d8 1
a8 1
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
d10 24
a33 4
    <span class="Header" nowrap>Using WinCvs to work with project source files</span>
</TR>

<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" BORDER="0" width="100%">
d35 1
a35 17
<P>	<span class="InputHeader">Index</span>

    <TD class="PlainText">

<UL>
<LI><A HREF="#gettingstarted">Getting started</A>
<LI><A HREF="#settingcvsroot">Setting cvsroot</A>
<LI><A HREF="#cvscheckout">Checking out source files</A>
<LI><A HREF="#cvsadd">Adding/committing files</A>
<LI><A HREF="#cvsupdate">Updating/merging files</A>
<LI><A HREF="#cvstatus">Find out file status</A>
<LI><A HREF="#diff">Comparing different versions of files</A>
</UL>

     
<P>If you are using MS Windows, you can use the graphical client called WinCvs to access a project's version controlled source code files. WinCvs looks and behaves similar to Windows Explorer. You can <A HREF="http://cvsgui.org/download.html" target="_new">download WinCvs</A> on line and install it on your machine.</P>

d37 1
a37 1
<A NAME="gettingstarted"></A><span class="InputHeader">Getting started</SPAN>
d41 1
a41 1
<P><IMG SRC="images/wincvs_launch.gif"></P>
d43 14
a56 1
<P>Before going further, make a new directory on your hard disk where you will store your working copy of the project's source files. A good name for this directory is &quot;projectname&quot; (the one-word name of the project files you need). If you are working on more than one project, you may wish to make a general "projects cvs" folder, and then create subfolders for each project by name. </P> 
d58 1
a58 3
<P>Select the &quot;projects&quot; directory in the WinCvs program's left-hand pane. (If you do not see your newly created projects directory right away, don't worry! You may need to collapse and expand the tree to force it to refresh.) If your project directory is on a different drive not displayed in the left-hand WinCvs pane, you will need to use the &quot;Change browse location...&quot; command under the View menu. Be sure to double click on the drive or directory you want before clicking OK.</P>

<P><IMG SRC="images/wincvs_browse.gif"></P>
d64 1
a64 1
<P>First you must tell WinCvs where the main repository, the "cvsroot", is located. If you are only working on one project at a time, you only need to set up the cvsroot setup once , i.e. the first time you use WinCvs to access the project's source repository through this site.
d66 25
a90 12
<p><ol><li>Pull down the "Admin" menu and choose "Preferences"
<p><img src="images/wincvs_prefs.gif"><p>
<li>Replace USERNAME with your username in "General" tag.</li>
<p><li>Click on "Authentication" then change the drop down menu to be "passwd file on the cvs server".</li>
<p><li>Click on the "Global" tab
<p><img src="images/wincvs_global_pref.gif"><p>
<li>Remove check mark on "Checkout read-only."</li>
<p><li>Click on the "Proxy" tab.<p>
<p><img src="images/wincvs_global_proxy.gif"><p>
<li>Place a check mark by clicking on "Connect using a proxy server."
<p><li>Enter host name or IP of proxy. For example: www.myprojectname.net
<p><li>Enter port number for the proxy. For example: 1080
d92 5
a96 86
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173" target="_new">More about configuring WinCvs</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvscheckout"></A><span class="InputHeader">Checking out source files</span>

<span class="PlainText">
<P>Now you are ready to <I>check out</I> (that this, to make a copy on your local hard disk) the project or "module" files you want. A module is a subset of the entire project file repository.
<P>
In the &quot;CvsAdmin&quot; menu, you must first &quot;Log in&quot to the project's CVS server and provide your password. Then you can use the &quot;Checkout module...&quot; command in the same pull-down menu to retrieve the latest versions of all files by default, or a specific module.</P>

<P><IMG SRC="images/wincvs_checkout.gif"></P>

<P><BR>
Use the left-hand navigation pane to see the directories and files in that module:</P>

<P><IMG SRC="images/wincvs_dir.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646179" target="_new">More about logging in to the project server</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646180" target="_new">More about checking out source files</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvsadd"></A><span class="InputHeader">Adding/committing files</span>

<P>WinCvs is not a file editor. You need to use your file editor of choice on your local machine to modify project files you have checked out. When you have completed your changes to files on your hard drive, you use WinCVS to <I>commit</I> those changes back into the project's CVS repository. This particular example shows what the WinCvs window for a directory containing html content files would look like after committing some changes.</P>

<P><IMG SRC="images/wincvs_afterchange.gif"></P>

<P>Whenever you <I>create</I> a new file on your hard disk and you want to add that file to the project, you need to let WinCvs know about this new file before you can commit it. Notice that there is a &quot;unknown file&quot; icon <IMG SRC="images/wincvs_unknown_icon.gif"> next to your new files. 
<P>
Click on the file to select it, then use the&quot;Add Selected&quot; <IMG SRC="images/wincvs_addselected.gif"> or &quot;Add Selected Binary&quot; <IMG SRC="images/wincvs_addbinary.gif"> button in the toolbar to mark the file as being under version control. Use &quot;Add Selected&quot; for files that are basically text files (e.g., *.txt or *.html).  Use &quot;Add Selected Binary&quot; for files
that have non-text formats (e.g., application data files or graphics). Note: Marking the file as "added" <I>does not</I> put it into the project's CVS repository! You must then commit it.</P>

<P>After you have told CVS to add any new files, you are ready to commit these. Files that still need to be committed display a red icon <IMG SRC="images/wincvs_modified_icon.gif"> next to them. Select the directory in the left-hand pane, or select those individual files to be committed. Press the commit icon <IMG SRC="images/wincvs_commit_icon.gif"> in the tool bar. You are prompted for a log message. This should be a brief, descriptive statement of the changes made to each file.</P>
 
<P>The results of the committing a file are displayed in the lower right-hand pane. If problems or <I>conflicts</I> are encountered during the merge, WinCvs aborts the commit process. You must then open the file in your file editor, resolve the conflicts, save it again, and then commit. <!--For more about resolving conflicts, see [LINK].-->

<P><IMG SRC="images/wincvs_commit.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646186" target="_new">More about adding files</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646185" target="_new">More about committing files</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvsupdate"></A><P><span class="InputHeader">Updating/merging files</span>

<P>A good general rule of thumb is to update your working copy of the project repository just before you commit your changes -- both newly added and updated files. This ensures that you are making changes to the most recent versions of files. Updating will not overwrite your modifications if another developer has made changes to the same file(s). Instead, WinCvs attempts to merge the two versions.

<P>To update, select &quot;Update files...&quot; under the &quot;Cvs Files&quot; menu and highlight the file(s) or folder(s) you wish to update. 

<P><IMG SRC="images/wincvs_update.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646181" target="_new">More about updating</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646192" target="_new">More about merging</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvstatus"></A><P><span class="InputHeader">Finding out file status</span>

<P>If you need to find out the status of a file relative to the version in the cvs repository, choose &quot;Status files&quot; in the &quot;Cvs files&quot; menu and select the file. The file's status is displayed in the bottom right-hand pane, along with the working revision number and repository revision number.

<P>CVS status definitions:
<P><DL>
<DT><B><I>Locally modified</I></B> <DD>Your working file contains changes made after the latest version in the repository.
<DT><B><I>Unknown</I></B> <DD>Your file is not part of the CVS repository. This means the file needs first to be added, then committed.
<DT><B><I>Up-to-date</I></B> <DD>Your working file is current with the latest version in the repository.
<!-- merge conflict message? -->
</DL>

<P><IMG SRC="images/wincvs_status.gif"></P>
<P>

<P>

<HR noShade SIZE=1>
<A NAME="diff"></A><P><span class="InputHeader">Comparing different versions of files</span>

<P>There may be circumstances when you want to compare the repository version to your file <I>before</I> you commit your changes. Sometimes you may have made some particularly complex modifications to a file that you know someone else has also worked on. Selecting &quot;Diff files...&quot; in the &quot;Cvs files&quot; menu allows you to compare your file against the file in the cvs repository, or against earlier versions.

<P><IMG SRC="images/wincvs_diff.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646183" target="_new">More about comparing files with diff</A>
<P>
</span>
d100 2
a101 1
<a href="/servlets/HelpTOC">Back to main Help index</a></p></span>
d103 2
a104 2
</TD>
</TR>
@


1.3
log
@removed window's nasty line breaks, and corrected more links in HelpBox files
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 7
d158 2
@


1.2
log
@updated screen shots; still needs C. Didio editsincorporated and need to break into smaller docs to load faster
@
text
@d1 150
a150 150
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <span class="Header" nowrap>Using WinCvs to work with project source files</span>
</TR>

<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" BORDER="0" width="100%">
  <TR>
<P>	<span class="InputHeader">Index</span>

    <TD class="PlainText">

<UL>
<LI><A HREF="#gettingstarted">Getting started</A>
<LI><A HREF="#settingcvsroot">Setting cvsroot</A>
<LI><A HREF="#cvscheckout">Checking out source files</A>
<LI><A HREF="#cvsadd">Adding/committing files</A>
<LI><A HREF="#cvsupdate">Updating/merging files</A>
<LI><A HREF="#cvstatus">Find out file status</A>
<LI><A HREF="#diff">Comparing different versions of files</A>
</UL>

     
<P>If you are using MS Windows, you can use the graphical client called WinCvs to access a project's version controlled source code files. WinCvs looks and behaves similar to Windows Explorer. You can <A HREF="http://cvsgui.org/download.html" target="_new">download WinCvs</A> on line and install it on your machine.</P>

<HR noShade SIZE=1>
<A NAME="gettingstarted"></A><span class="InputHeader">Getting started</SPAN>

<P>When you launch WinCvs, you see a screen that looks like this:</P>

<P><IMG SRC="images/wincvs_launch.gif"></P>

<P>Before going further, make a new directory on your hard disk where you will store your working copy of the project's source files. A good name for this directory is &quot;projectname&quot; (the one-word name of the project files you need). If you are working on more than one project, you may wish to make a general "projects cvs" folder, and then create subfolders for each project by name. </P> 

<P>Select the &quot;projects&quot; directory in the WinCvs program's left-hand pane. (If you do not see your newly created projects directory right away, don't worry! You may need to collapse and expand the tree to force it to refresh.) If your project directory is on a different drive not displayed in the left-hand WinCvs pane, you will need to use the &quot;Change browse location...&quot; command under the View menu. Be sure to double click on the drive or directory you want before clicking OK.</P>

<P><IMG SRC="images/wincvs_browse.gif"></P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646172" target="_new">More about setting a work area</A>

<HR noShade SIZE=1>
<A NAME="settingcvsroot"></A><span class="InputHeader">Setting up cvsroot</span>

<P>First you must tell WinCvs where the main repository, the "cvsroot", is located. If you are only working on one project at a time, you only need to set up the cvsroot setup once , i.e. the first time you use WinCvs to access the project's source repository through this site.

<p><ol><li>Pull down the "Admin" menu and choose "Preferences"
<p><img src="images/wincvs_prefs.gif"><p>
<li>Replace USERNAME with your username in "General" tag.</li>
<p><li>Click on "Authentication" then change the drop down menu to be "passwd file on the cvs server".</li>
<p><li>Click on the "Global" tab
<p><img src="images/wincvs_global_pref.gif"><p>
<li>Remove check mark on "Checkout read-only."</li>
<p><li>Click on the "Proxy" tab.<p>
<p><img src="images/wincvs_global_proxy.gif"><p>
<li>Place a check mark by clicking on "Connect using a proxy server."
<p><li>Enter host name or IP of proxy. For example: www.myprojectname.net
<p><li>Enter port number for the proxy. For example: 1080
</ol>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646173" target="_new">More about configuring WinCvs</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvscheckout"></A><span class="InputHeader">Checking out source files</span>

<span class="PlainText">
<P>Now you are ready to <I>check out</I> (that this, to make a copy on your local hard disk) the project or "module" files you want. A module is a subset of the entire project file repository.
<P>
In the &quot;CvsAdmin&quot; menu, you must first &quot;Log in&quot to the project's CVS server and provide your password. Then you can use the &quot;Checkout module...&quot; command in the same pull-down menu to retrieve the latest versions of all files by default, or a specific module.</P>

<P><IMG SRC="images/wincvs_checkout.gif"></P>

<P><BR>
Use the left-hand navigation pane to see the directories and files in that module:</P>

<P><IMG SRC="images/wincvs_dir.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646179" target="_new">More about logging in to the project server</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646180" target="_new">More about checking out source files</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvsadd"></A><span class="InputHeader">Adding/committing files</span>

<P>WinCvs is not a file editor. You need to use your file editor of choice on your local machine to modify project files you have checked out. When you have completed your changes to files on your hard drive, you use WinCVS to <I>commit</I> those changes back into the project's CVS repository. This particular example shows what the WinCvs window for a directory containing html content files would look like after committing some changes.</P>

<P><IMG SRC="images/wincvs_afterchange.gif"></P>

<P>Whenever you <I>create</I> a new file on your hard disk and you want to add that file to the project, you need to let WinCvs know about this new file before you can commit it. Notice that there is a &quot;unknown file&quot; icon <IMG SRC="images/wincvs_unknown_icon.gif"> next to your new files. 
<P>
Click on the file to select it, then use the&quot;Add Selected&quot; <IMG SRC="images/wincvs_addselected.gif"> or &quot;Add Selected Binary&quot; <IMG SRC="images/wincvs_addbinary.gif"> button in the toolbar to mark the file as being under version control. Use &quot;Add Selected&quot; for files that are basically text files (e.g., *.txt or *.html).  Use &quot;Add Selected Binary&quot; for files
that have non-text formats (e.g., application data files or graphics). Note: Marking the file as "added" <I>does not</I> put it into the project's CVS repository! You must then commit it.</P>

<P>After you have told CVS to add any new files, you are ready to commit these. Files that still need to be committed display a red icon <IMG SRC="images/wincvs_modified_icon.gif"> next to them. Select the directory in the left-hand pane, or select those individual files to be committed. Press the commit icon <IMG SRC="images/wincvs_commit_icon.gif"> in the tool bar. You are prompted for a log message. This should be a brief, descriptive statement of the changes made to each file.</P>
 
<P>The results of the committing a file are displayed in the lower right-hand pane. If problems or <I>conflicts</I> are encountered during the merge, WinCvs aborts the commit process. You must then open the file in your file editor, resolve the conflicts, save it again, and then commit. <!--For more about resolving conflicts, see [LINK].-->

<P><IMG SRC="images/wincvs_commit.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646186" target="_new">More about adding files</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646185" target="_new">More about committing files</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvsupdate"></A><P><span class="InputHeader">Updating/merging files</span>

<P>A good general rule of thumb is to update your working copy of the project repository just before you commit your changes -- both newly added and updated files. This ensures that you are making changes to the most recent versions of files. Updating will not overwrite your modifications if another developer has made changes to the same file(s). Instead, WinCvs attempts to merge the two versions.

<P>To update, select &quot;Update files...&quot; under the &quot;Cvs Files&quot; menu and highlight the file(s) or folder(s) you wish to update. 

<P><IMG SRC="images/wincvs_update.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646181" target="_new">More about updating</A><BR>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646192" target="_new">More about merging</A>
<P>

<HR noShade SIZE=1>
<A NAME="cvstatus"></A><P><span class="InputHeader">Finding out file status</span>

<P>If you need to find out the status of a file relative to the version in the cvs repository, choose &quot;Status files&quot; in the &quot;Cvs files&quot; menu and select the file. The file's status is displayed in the bottom right-hand pane, along with the working revision number and repository revision number.

<P>CVS status definitions:
<P><DL>
<DT><B><I>Locally modified</I></B> <DD>Your working file contains changes made after the latest version in the repository.
<DT><B><I>Unknown</I></B> <DD>Your file is not part of the CVS repository. This means the file needs first to be added, then committed.
<DT><B><I>Up-to-date</I></B> <DD>Your working file is current with the latest version in the repository.
<!-- merge conflict message? -->
</DL>

<P><IMG SRC="images/wincvs_status.gif"></P>
<P>

<P>

<HR noShade SIZE=1>
<A NAME="diff"></A><P><span class="InputHeader">Comparing different versions of files</span>

<P>There may be circumstances when you want to compare the repository version to your file <I>before</I> you commit your changes. Sometimes you may have made some particularly complex modifications to a file that you know someone else has also worked on. Selecting &quot;Diff files...&quot; in the &quot;Cvs files&quot; menu allows you to compare your file against the file in the cvs repository, or against earlier versions.

<P><IMG SRC="images/wincvs_diff.gif"></P>
<P>
<A HREF="http://www.cvsgui.org/winhtml/wincvs11.htm#_Toc453646183" target="_new">More about comparing files with diff</A>
<P>
</span>
<P>

<HR noShade SIZE=1>
<a href="/servlets/HelpTOC">Back to main Help index</a></p></span>

</TD>
</TR>
</TABLE>
@


1.1
log
@WinCvs user guide
@
text
@d44 1
a44 1
<p><ul><li>Pull down the "Admin" menu and choose "Preferences"
d47 1
a47 1
<li>Click on "Authentication" then change the drop down menu to be "passwd file on the cvs server".</li>
d54 2
a55 3
<li>Enter host name or IP of proxy. For example: www.myprojectname.net
<li>Enter port number for the proxy. For example: 1080
</ul>
d146 1
a146 1
<a href="Help.html">Back to main Help index</a></p></span>
@

