You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by le...@apache.org on 2003/01/25 18:12:53 UTC
cvs commit: jakarta-avalon-site/src/documentation skinconf.xml
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:anoncvs@cvs.apache.org:/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:anoncvs@cvs.apache.org:/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:anoncvs@cvs.apache.org 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:anoncvs@cvs.apache.org 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:anoncvs@cvs.apache.org 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:anoncvs@cvs.apache.org 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:anoncvs@cvs.apache.org login
+# enter anoncvs when promted for a password, then hit enter
+cvs -z3 -d :pserver:anoncvs@cvs.apache.org 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: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-avalon-site/src/documentation skinconf.xml
Posted by Leo Simons <le...@apache.org>.
yep. Will get to that. My plan was to just write this stuff up and then
get incubator to adopt it. I don't have commit access to incubator cvs,
and there's not much happening there right now, so....
cheers,
- Leo
Peter Donald wrote:
> On Sun, 26 Jan 2003 04:12, leosimons@apache.org wrote:
>
>>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.
>
>
> Would not it be better to point to existing jakarta (or incubator when it
> actually gets going) and improve their docs rather than copying them across ?
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-avalon-site/src/documentation skinconf.xml
Posted by Peter Donald <pe...@realityforge.org>.
On Sun, 26 Jan 2003 04:12, leosimons@apache.org wrote:
> 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.
Would not it be better to point to existing jakarta (or incubator when it
actually gets going) and improve their docs rather than copying them across ?
--
Cheers,
Peter Donald
*------------------------------------------------------*
| "Nearly all men can stand adversity, but if you want |
| to test a man's character, give him power." |
| -Abraham Lincoln |
*------------------------------------------------------*
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>