leosimons 2003/01/25 09:12:53
Modified: src/documentation/content/xdocs cvs.xml
src/documentation/resources/images group-logo.gif
src/documentation skinconf.xml
Added: src/documentation/resources/images
tortoise-cvs-screenshot.gif
tortoisecvs-checkout.jpg tortoisecvs-settings.jpg
wincvs-checkout.jpg wincvs-preferences.jpg
wincvs-settings.jpg
Log:
adding in GUI information to the cvs info docs.
Revision Changes Path
1.2 +127 -26 jakarta-avalon-site/src/documentation/content/xdocs/cvs.xml
Index: cvs.xml
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/src/documentation/content/xdocs/cvs.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- cvs.xml 24 Jan 2003 19:39:40 -0000 1.1
+++ cvs.xml 25 Jan 2003 17:12:52 -0000 1.2
@@ -28,17 +28,17 @@
<title>CVS data</title>
<p>If you know what you're doing, all you need to know:</p>
<source>
- anonymous CVSROOT: :pserver:[EMAIL PROTECTED]:/home/cvspublic
- viewcvs: http://cvs.apache.org/viewcvs.cgi/
- modules:
- avalon-sandbox # alpha & pre-alpha code
- jakarta-avalon # framework and documentation
- jakarta-avalon-apps # avalon applications
- jakarta-avalon-excalibur # component/utility/container
repository
- jakarta-avalon-cornerstone # component repository
- jakarta-avalon-logkit # cool logging toolkit
- jakarta-avalon-phoenix # the phoenix container and related
libraries
- jakarta-avalon-site # this website
+anonymous CVSROOT: :pserver:[EMAIL PROTECTED]:/home/cvspublic
+viewcvs: http://cvs.apache.org/viewcvs.cgi/
+modules:
+ avalon-sandbox # alpha & pre-alpha code
+ jakarta-avalon # framework and documentation
+ jakarta-avalon-apps # avalon applications
+ jakarta-avalon-excalibur # component/utility/container repository
+ jakarta-avalon-cornerstone # component repository
+ jakarta-avalon-logkit # cool logging toolkit
+ jakarta-avalon-phoenix # the phoenix container and related libraries
+ jakarta-avalon-site # this website
</source>
</section>
<section>
@@ -62,18 +62,18 @@
enter the following commands:</p>
<source>
- rem you can use any directory in place of C:\cvs
- rem replace $CVSUTILS with where you installed the cvs binary, or with
- rem nothing if you added the utility to your PATH
- mkdir C:\cvs
- cd C:\cvs
- $CVSUTILS\cvs.exe -d :pserver:[EMAIL PROTECTED] login
- rem enter anoncvs when promted for a password, then hit enter
- rem the below command should be on one line
- $CVSUTILS\cvs.exe -z3 -d :pserver:[EMAIL PROTECTED] checkout
jakarta-avalon
- jakarta-avalon-excalibur jakarta-avalon-cornerstone
- jakarta-avalon-phoenix jakarta-avalon-logkit jakarta-avalon-site
- avalon-sandbox jakarta-site xml-forrest
+rem you can use any directory in place of C:\cvs
+rem replace $CVSUTILS with where you installed the cvs binary, or with
+rem nothing if you added the utility to your PATH
+mkdir C:\cvs
+cd C:\cvs
+$CVSUTILS\cvs.exe -d :pserver:[EMAIL PROTECTED] login
+rem enter anoncvs when promted for a password, then hit enter
+rem the below command should be on one line
+$CVSUTILS\cvs.exe -z3 -d :pserver:[EMAIL PROTECTED] checkout jakarta-avalon
+ jakarta-avalon-excalibur jakarta-avalon-cornerstone
+ jakarta-avalon-phoenix jakarta-avalon-logkit jakarta-avalon-site
+ avalon-sandbox jakarta-site xml-forrest
</source>
<p>This will take a while, depending on your connection. Go ahead and
grab
@@ -85,18 +85,119 @@
<section>
<title>Use TortoiseCVS</title>
- <p>Screenshots coming soon....</p>
+ <p><link href="http://www.tortoisecvs.org/";>TortoiseCVS</link> is a
neat extension
+ for the Windows Explorer which integrates cvs. Using it is real
simple:</p>
+
+ <p>After you've created a folder where you want to check out the
sources to,
+ right-click and select CVS Checkout...:<br/>
+ <img src="images/tortoisecvs-checkout.jpg" alt="screenshot of cvs
settings"/></p>
+
+ <p>Then, fill out the settings like in the screenshot below, and then
click ok.<br/>
+ <img src="images/tortoisecvs-settings.jpg" alt="screenshot of cvs
settings"/></p>
+
+ <p>This checks out the jakarta-avalon cvs module. Repeat this
procedure for all
+ the modules you wish to check out. See above under "CVS Data" for the
list of avalon modules, or use the
+ <link href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS Webpage</link>
for a full
+ list of ASF-hosted cvs modules.</p>
</section>
<section>
<title>Use WinCVS</title>
- <p>Screenshots coming soon....</p>
+ <p><link href="http://www.wincvs.org/";>WinCVS</link> is a standalone
windows
+ application for working with cvs. It has more features than
TortoiseCVS, and
+ hence more buttons a novice is not likely to use.</p>
+
+ <p>After you've created a folder where you want to check out the
sources to,
+ select the Checkout module... option from the Create menu:<br/>
+ <img src="images/wincvs-checkout.jpg" alt="screenshot of cvs
settings"/></p>
+
+ <p>Then, select the "general tab" and fill out the settings like in the
+ screenshot below:<br/>
+ <img src="images/wincvs-preferences.jpg" alt="screenshot of cvs
settings"/>.</p>
+
+ <p>Now, switch back to the first tab and fill out the settings like in
the
+ screenshot below, and then click ok.<br/>
+ <img src="images/wincvs-checkout.jpg" alt="screenshot of cvs
settings"/>.</p>
+
+ <p>This checks out the jakarta-avalon cvs module. Repeat this
procedure for all
+ the modules you wish to check out. See above under "CVS Data" for the
list of avalon modules, or use the
+ <link href="http://cvs.apache.org/viewcvs.cgi/";>ViewCVS Webpage</link>
for a full
+ list of ASF-hosted cvs modules.</p>
</section>
</section>
<section>
<title>Getting the sources from CVS under linux</title>
- <p>Coming soon...</p>
+ <section>
+ <title>Use the commandline tools</title>
+
+ <p>The CVS utilities are available as native linux binaries. Chances
are
+ you already have them installed. Try it by opening a console and
typing 'cvs'.
+ If you get an error along the lines of "bash: cvs: command not found",
then
+ you need to install them first. Under debian, you can do so by opening
a console
+ window and entering the commands:</p>
+
+ <source>
+su -
+# enter the root password when prompted
+apt-get update
+apt-get install cvs
+exit
+ </source>
+
+ <p>Under Red Hat, the commands are a little different:</p>
+
+ <source>
+su -
+# enter the root password when prompted
+rpm -i
ftp://ftp.redhat.com/pub/redhat/linux/8.0/en/os/i386/RedHat/RPMS/cvs-1.11.2-5.i386.rpm
+exit
+ </source>
+
+ <p>The procedure is similar for other linux distributions. Once you
have
+ these tools installed, open a command window, then enter the following
+ commands:</p>
+
+ <source>
+# you can use any directory in place of ~/cvs
+mkdir ~/cvs
+cd ~/cvs
+cvs -d :pserver:[EMAIL PROTECTED] login
+# enter anoncvs when promted for a password, then hit enter
+cvs -z3 -d :pserver:[EMAIL PROTECTED] checkout jakarta-avalon \
+ jakarta-avalon-excalibur jakarta-avalon-cornerstone \
+ jakarta-avalon-phoenix jakarta-avalon-logkit jakarta-avalon-site \
+ avalon-sandbox jakarta-site xml-forrest
+ </source>
+
+ <p>This will take a while, depending on your connection. Go ahead and
grab
+ yourself a coffee or ten. When done, you should have checked out all
avalon
+ sources and the most important utility libraries you need to build it
(save
+ for <link href="http://ant.apache.org/";>Apache Ant</link>, which you
should
+ go install right now if you haven't already).</p>
+ </section>
+
+ <section>
+ <title>Using Cervisia</title>
+
+ <p>KDE's Konqueror browser has CVS support built-in. I've never used
it so I
+ can't comment on it. See
+ <link href="http://cervisia.sourceforge.net/";>the cervisia
website</link> for
+ more information.</p>
+ </section>
+</section>
+<section>
+ <title>Platform-independent: jCVS</title>
+
+ <p><link href="http://www.jcvs.org/";>jCVS</link> is a 100% java cvs package
that I've
+ never used.</p>
+</section>
+<section>
+ <title>Using an IDE for CVS access</title>
+
+ <p>Most decent IDEs these days provide cvs integration. See the
+ <link href="http://jakarta.apache.org/site/idedevelopers.html";>IDE Developer's
Guide</link>
+ if you need information on how to configure your ide.</p>
</section>
</body>
1.2 +32 -53
jakarta-avalon-site/src/documentation/resources/images/group-logo.gif
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/tortoise-cvs-screenshot.gif
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/tortoisecvs-checkout.jpg
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/tortoisecvs-settings.jpg
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/wincvs-checkout.jpg
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/wincvs-preferences.jpg
<<Binary file>>
1.1
jakarta-avalon-site/src/documentation/resources/images/wincvs-settings.jpg
<<Binary file>>
1.2 +5 -5 jakarta-avalon-site/src/documentation/skinconf.xml
Index: skinconf.xml
===================================================================
RCS file: /home/cvs/jakarta-avalon-site/src/documentation/skinconf.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- skinconf.xml 23 Jan 2003 17:10:48 -0000 1.1
+++ skinconf.xml 25 Jan 2003 17:12:53 -0000 1.2
@@ -54,9 +54,9 @@
<!-- optional group logo
skin: forrest-site renders it at the top-left corner -->
- <!--<group-name></group-name>
- <group-url></group-url>
- <group-logo></group-logo>-->
+ <group-name>Apache</group-name>
+ <group-url>http://www.apache.org/</group-url>
+ <group-logo>images/group-logo.gif</group-logo>
<!-- optional host logo (e.g. sourceforge logo)
skin: forrest-site renders it at the bottom-left corner -->
@@ -71,8 +71,8 @@
want these, set the attributes to blank. The DTD purposefully requires them.
-->
<trail>
- <link1 name="apache" href="http://www.apache.org/"/>
- <link2 name="avalon" href="http://avalon.apache.org/"/>
+ <link1 name="" href=""/>
+ <link2 name="" href=""/>
<link3 name="" href=""/>
</trail>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
