+ website
+ Added Harbour website (except art, docs and stat subdirs)
; TODO: configure automatic mechanism to extract site from
here and regularly updload to sf.net web area
; TODO: Clean HTML code, remove unused picture/files, avoid JS
Any takers?
; NOTE: Please make modifications to website code only in
SVN, then upload the content to web server manually.
IOW never update on web server directly.
140 lines
5.2 KiB
HTML
140 lines
5.2 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<LINK REV="made" HREF="mailto:harbour-faq@netfang.net">
|
|
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
|
|
<TITLE>What is CVS and how do I use it?</TITLE>
|
|
</HEAD>
|
|
<BODY text="#000000" bgcolor="#ffffff">
|
|
|
|
<A HREF="harbour.html"><EM>Frequently Asked Questions about Harbour</EM></A>
|
|
<b>:</b> <A HREF="harbour20.html"><EM>Helping develop Harbour</EM></A>
|
|
<b>:</b> <EM>What is CVS and how do I use it?</EM><BR>
|
|
<b>Previous:</b> <A HREF="harbour24.html"><EM>Where can I find the source?</EM></A><BR>
|
|
<b>Next:</b> <A HREF="harbour26.html"><EM>How do I build Harbour?</EM></A>
|
|
|
|
|
|
<HR NOSHADE>
|
|
<H2><A NAME="25"></A>3.5. What is CVS and how do I use it?<A NAME="WhatIsCVS"></A></H2>
|
|
<p>Before proceeding you should probably have a good read of the <A href="http://www.cvshome.org/docs/blandy.html">introduction to CVS by Jim Blandy</A>. Reading this document should save you a lot of confusion later
|
|
on.</p>
|
|
<p>To use the CVS server you first need to get a copy of the CVS client
|
|
software for your operating system:</p>
|
|
<p>
|
|
<ul>
|
|
<li>Microsoft Windows
|
|
<p>See <A href="http://www.cyclic.com/cvs/windows.html">http://www.cyclic.com/cvs/windows.html</A> for more details.</p>
|
|
|
|
|
|
</li>
|
|
<li>DOS 16bit/32bit
|
|
<p>See the DOS section at <A href="http://www.cyclic.com/cvs/other.html">http://www.cyclic.com/cvs/other.html</A>.</p>
|
|
|
|
</li>
|
|
<li>GNU/Linux
|
|
<p>Many GNU/Linux distributions come with the cvs client packaged as part of
|
|
the distribution. If you don't have it installed check your install CDs or
|
|
check the ftp site for the distribution in question.</p>
|
|
|
|
|
|
</li>
|
|
<li>OS/2
|
|
<ul>
|
|
<li><A href="http://www.cyclic.com/cvs/os2.html">http://www.cyclic.com/cvs/os2.html</A></li>
|
|
<li><A href="ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/devtools/cvs110.zip">ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/devtools/cvs110.zip</A></li>
|
|
</ul>
|
|
|
|
|
|
|
|
</li>
|
|
<li>Macintosh
|
|
<p>See <A href="http://www.cyclic.com/cvs/mac.html">http://www.cyclic.com/cvs/mac.html</A> for more details.</p>
|
|
|
|
|
|
</li>
|
|
<li>Other
|
|
<p>If you are building Harbour with an operating system not listed then please
|
|
contact the FAQ maintainer with full details so that this list can be
|
|
updated.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
</p>
|
|
<p>Once you have got your CVS client installed you can gain anonymous access to
|
|
the Harbour CVS server. Depending on platform, the first thing you need to
|
|
do is set the <code>CVSROOT</code> environment variable to:</p>
|
|
<p>
|
|
<blockquote><code>
|
|
<pre>
|
|
:pserver:anonymous@cvs.sourceforge.net:/cvsroot/harbour-project
|
|
</pre>
|
|
</code></blockquote>
|
|
</p>
|
|
<p>In addition to the above some environments might require extra information.
|
|
For example, the DOS, Windows and OS/2 CVS clients need to be given two
|
|
extra environment variables, <code>HOMEDRIVE</code> and <code>HOMEPATH</code>. These two
|
|
environment variables tell the CVS client where the source will live
|
|
locally. For example, if your Harbour development directory is at
|
|
S:\FREESOFT\HARBOUR you'd set:</p>
|
|
<p>
|
|
<blockquote><code>
|
|
<pre>
|
|
SET HOMEDRIVE=S
|
|
SET HOMEPATH=\FREESOFT\HARBOUR\
|
|
</pre>
|
|
</code></blockquote>
|
|
</p>
|
|
<p>Users of the Windows client have reported that the <code>HOMEPATH</code> environment
|
|
variable must start with and finish with a directory separator. Users of the
|
|
DOS client have reported that the <code>HOMEDRIVE</code> environment variable must
|
|
end with a colon.</p>
|
|
<p>Ensure that your harbour directory is created and change into it. Then run:</p>
|
|
<p>
|
|
<blockquote><code>
|
|
<pre>
|
|
cvs login
|
|
</pre>
|
|
</code></blockquote>
|
|
</p>
|
|
<p>and press enter when prompted for a password. Now run:</p>
|
|
<p>
|
|
<blockquote><code>
|
|
<pre>
|
|
cvs extract -P harbour
|
|
</pre>
|
|
</code></blockquote>
|
|
</p>
|
|
<p>to get a copy of the Harbour CVS repository (users of the DOS client have
|
|
reported that it doesn't have the <code>extract</code> command and that the
|
|
<code>checkout</code> command should be used instead, I'm also told that the cvs
|
|
client on GNU/Linux requires that you use <code>checkout</code>).</p>
|
|
<p><b>Note</b>: The CVS commands and directories are case sensitive: <code>harbour</code>
|
|
must be in all lower case (also note that on <A href="http://www.sourceforge.net/">SourceForge</A> Harbour is known as
|
|
"harbour-project").</p>
|
|
<p>Later, when you want to get changes from the CVS, you can do one of two
|
|
things:</p>
|
|
<p>
|
|
<ul>
|
|
<li>Repeat the <code>extract</code> command from your Harbour directory.</li>
|
|
<li>From your Harbour directory run '<code>cvs update</code>'.</li>
|
|
</ul>
|
|
</p>
|
|
<p>If you have problems after reading the above please consider reading the
|
|
<A href="http://www.cvshome.org/docs/blandy.html">CVS introduction</A> and also the documentation for the CVS client you've
|
|
installed. If, after reading both those documents, you are still having
|
|
problems you should drop a polite message into the
|
|
<A HREF="harbour35.html#DevMailList">developer's mailing list</A> detailing your platform, environment, all
|
|
the steps you performed and the exact nature of the problem.</p>
|
|
|
|
<HR NOSHADE>
|
|
<A HREF="harbour.html"><EM>Frequently Asked Questions about Harbour</EM></A>
|
|
<b>:</b> <A HREF="harbour20.html"><EM>Helping develop Harbour</EM></A>
|
|
<b>:</b> <EM>What is CVS and how do I use it?</EM><BR>
|
|
<b>Previous:</b> <A HREF="harbour24.html"><EM>Where can I find the source?</EM></A><BR>
|
|
<b>Next:</b> <A HREF="harbour26.html"><EM>How do I build Harbour?</EM></A>
|
|
|
|
|
|
|
|
</BODY>
|
|
</HTML>
|