> I have Eclipse set up to use the subclipse plugin to pull sourcecode
> out of the trackbot repository at Java.net.
I also use the subclipse plugin.
> have newer used the plugin before. It seem to work fine except that
> Eclipse does not seem to recognize the source tree as a real
> project. I say this because which I attempt to use the "generate
Eclipse needs to have a ".project" file in order to recognize a group
of files as a "project", and to tell it what kind of project (Java,
C/C++, etc) it is.
The TrackBotCode project at java.net has several projects under it.
This may not be the most common way to use the SVN "trunk" but at
Java.net I think it's logical to group related "projects" together
instead of making them all completely independent, apparently
unrelated "projects" in the Java.net sense of "project". So I never
make an eclipse project which is the "trunk" of TrackBotCode, I use
eclipse to checkout the subprojects such as TrackBotCommonV2 which
then has the SVN repository:
Then I can commit and update each subproject separately, which seems
like the obvious way to do it.
and likewise for other subprojects such as TrackBotSensorEval:
and so forth.
If you browse the java.net subversion space for TrackBotCode you will
see a separate "www" folder which is where all the html files, images,
docs, etc are stored. So I make another Eclipse "project" for that,
called "TrackBotCode WWW" which uses the SVN URL:
Then I use subclipse to commit and update the html pages there. I
actually edit them in DreamWeaver. But java.net doesn't allow FTP for
html uploading or downloading, so I only edit in DreamWeaver and use
Eclipse/subclipse to commit and update.
In Eclipse I can open a "SVN Repository" perspective and create a new
repository entry for the TrackBotCode trunk, with this URL:
Then below that I can browse all current and future subprojects such
as TrackBotCommonV2, the www folder described above, etc.
Right-click on any such folder and then follow these instructions to
checkout that project:
well I don't see the instructions I meant... there is some eclipse
help there and as usual it could have more added. There's also an
Eclipse help project at java.net, though I don't recall its name.
> Javadoc" option 'neither the trunk project, nor TrackbotCommonV2
> project (1 have attempted to pull down both the entire trunk and
> just CommonV2) are listed under projects I can select for generation.
You obviously don't want to generate javadocs for the entire trunk as
if it was a single project.
If you have an eclipse "project", the root folder will have a
superscript uppercase "J" if it is recognized as a Java project. If
not, you can edit this part of the .project file - the buildCommand
and natures properties:
Save the edited .project file and refresh the project. Now it should
be recognized as a Java project by Eclipse.
> Taking a step back, what I really want to do is generate the Javadoc
> for TrackbotCommonV2 so I can read it.
Some of Shawn's build.xml don't have a "javadoc" task, but there is a
separate JAR and javadoc Ant file. This is just Shawn's style
preference. In the case of TrackBotCommonV2 it is a "build-jars.xml"
file which does have a "javadocs" target. Please run that to generate
In the case of TrackBotSensorEval I have made a "doc" target in the
build.xml file, which is my preference.
Shawn also uses a build.properties file to handle PC vs Mac
differences. Such is the case in TrackbotCommonV2.
I hope that helps!
I'll try to find some more Eclipse project creation tips -- which I