Hello everyone.
Firstly an introduction: I'm based in Hobart, Tasmania and I'm commencing
work, as a developer for Geometry (http://www.geometryit.com
<http://www.geometryit.com/> ), on additions to the GeoNetwork software for
the BlueNet project (http://www.bluenet.org.au/>
). I'm a seasoned Java developer, but also have a strong C++ and assembler
background and have a particular interest in real-time graphics. I have
been pointed toward this list to use as a resource to aid my understanding,
and it has been suggested that I contribute where I can.
To that end, I thought I'd just take the opportunity to document the steps
and pitfalls that I encounter when navigating through the maze of
setup/configuration information. There is a lot of information, and much of
it makes sense, but sometimes finding the right way to start is daunting.
I use Eclipse (http://www.eclipse.org/> ) as my
preferred Java IDE, so these instructions explain how to connect to CVS via
that tool. I did do a search on the mailing list first to see if anyone
else was using Eclipse - there was one message detailing a problem
configuring CVS (April/2006). I did follow the online instructions to get
TortoiseCVS up and running (I develop on a Windows XP platform), and there
were a few minor 'gotchas' that are worth noting.
One big 'gotcha' -- when selecting the 'Module' in the CVS checkout, you
cannot select 'GeoNetwork_2' (which would seem the obvious choice). If you
do this, you will receive the error 'cannot open CVS/Entries for reading.
No such file or directory exists'. I had more success when I selected
'geonetwork' as the module.
So, here are the TortoiseCVS settings for GeoNetwork retrieval from CVS for
GeoNetwork.
Protocol: Password server (:pserver:)
Protocol parameters:
Server: geonetwork.cvs.sourceforge.net
Port:
Repository folder: /cvsroot/geonetwork
User name: anonymous
Module: geonetwork
Using the above, I was able to retrieve (via context-menu right-click in
Windows Explorer) the source.
However, as I stated, Eclipse is my preferred IDE - and so I prefer to use
that as my CVS/checkout tool. I don't believe it is necessary to
install/configure TortoiseCVS if you plan to use Eclipse. To open and
configure Eclipse for the GeoNetwork project, open Eclipse and use the
following steps.
* create a new project (File/New Project/CVS/Checkout project from
CVS)
* set 'Host' to geonetwork.cvs.sourceforge.net
* set 'Repository path' to /cvsroot/geonetwork
* set 'User' to anonymous
* leave 'Password' blank
* set 'Connection type' to pserver
* check 'Use default port
* click Next
You should now be able to click on 'Use an existing module." and it will
load the module names.
* select 'geonetwork' from the modules
* click Next
* click "Check out as a project in the workspace" and set 'Project
Name' to geonetwork
* click Next
* Choose your workspace location (for reference, I use
e:\BlueNet\geonetwork)
* Click Next
* Select the 'tag' (this is the CVS's 'marked code' that you want.
Typically this will be HEAD)
* Click Finish
The IDE should now be busy for a while, checking out the files from the CVS
at SourceForge.
I also found it useful to retrieve 'jeeves' (upon which geonetwork is
dependant) from SourceForge via CVS. To import Jeeves into your Eclipse
project , follow the above steps (from "create a new project"), replacing
'geonetwork' with "jeeves"
If you wish to retrieve the JDOM code/binaries (another code dependency),
you can visit www.jdom.org <http://www.jdom.org/> -- you might like to add
the JAR file (if you download the binary only) as a dependency (external
JAR) to the geonetwork project.
After following the above steps, you should have two projects in your
Eclipse IDE - 'geonetwork' and 'jeeves'. As to compilation and running,
that's another issue. To be honest, I'm not quite sure why I'm unable to
compile the projects when imported via the above process into a clean
workspace. When imported into an existing workspace, I can compile OK. I'm
investigating the issue now.
The above, at least, should allow you to retrieve and browse the source.
Cheers
A
