Re: [stellation-res] Finding documentation

["Mark C. Chu-Carroll" <mcc@xxxxxxxxxxxxxx>]

On Wednesday 21 August 2002 10:37 pm, Marco Qualizza wrote:
> > Since I have found a few minor problems in the Stellation command line
> > tutorial and User Guide, I went looking for copies of these documents in
> > the CVS repository. I found two documentaion folders, one under
> > org.eclipse.stellation/devel/doc and one under org.stellation.docs. I
> > tried to download the contents of these folders using the Eclipse
> > Repository Viewer. In both cases I requested "checkout as project". The
> > result was two empty folders showing in the root of my Eclipse Navigator
> > view.
> >
> > Since I have no experience whatsoever with CVS and am still educating
> > myself about Eclipse I did not know what to expect. Have I done something
> > stupid or is it possible that there is an environmental problem
> > preventing me from getting anything?
>
> Just did a quick check.  I'll assume that "org.stellation.docs" is
> actually "org.eclipse.stellation/docs".  That being the case, then
> there is no problem either with you or your environment -- the folders
> are empty (in so far as they contain only child folders, but no
> files).  By default, CVS prunes empty folders and doesn't download
> them  (long story... the final answer about why is "because CVS has
> some quirks").

To make a long story short, you got it. CVS has quirks.

The documentation is in the "docs" directory of the  
"org.eclipse.stellation.misc" project, stored under the "plugins" directory 
in our CVS repository.

The reason for the confusing directory structure is the following:

There was a bunch of confusion surrounding our open-source release. We didn't 
know the date that the technology project was going to be launched.  We 
finally got a note on the evening of July 3 that the site would be live on 
July 4, and could we please populate it. (The OTI group that manages the 
Eclipse site is in Canada, and in the midst of leaving for the Canada day
vacation, everyone thought that someone else had told us that there was a test
site ready for us to set up...)

So, my first attempt to set up the site didn't work right. The directory 
structure was all screwed up. We've gradually fixed it up. But due to the
quirks of CVS, the old directories from that failed attempt continue to 
linger.

	-Mark
-- 
Mark Craig Chu-Carroll,  IBM T.J. Watson Research Center  
*** The Stellation project: Advanced SCM for Collaboration
***		http://www.eclipse.org/stellation
*** Work Email: mcc@xxxxxxxxxxxxxx  ------- Personal Email: markcc@xxxxxxxxxxx