CVS Repository
From Skyway Wiki
There are several ways to get the source for the Skyway Visual Perspectives projects. Most developers are actually developing their own Skyway Steps (or other extensions) and are interested in browsing the Skyway Visual Perspectives source and using it during debugging. For this, you can either browse the CVS repository online or use the source included in the Skyway Visual Perspectives SDK download.
Contents |
Anonymous CVS
For people actually want to edit Skyway Visual Perspectives code but who do not have the required commit rights in that area, all elements of the Skyway Visual Perspectives projects are available via anonymous access to the development CVS repository. Using anonymous access you can checkout code and modify it locally, but cannot write it back to the repository. This is handy if you would like to fix a bug or add a feature. Get the code via anonymous access, do your work and then pass the work on to a committer (in a patch attached to a bug report) for inclusion in the repository.
To use anonymous access from a running Eclipse platform or Skyway Visual Perspectives, simply go to a Repository View and add a new CVS repository location. Use the following information to connect:
| Host | cvs.skywayperspectives.org |
| Repository Paths | /CVS |
| User | guest |
| Password | (leave blank) |
| Connection Type | pserver |
From there you can browse the repository and add projects to your workspace. If you do some changes that you'd like to contribute, rather than committing the changes to the repository (which you can't do as the anonymous user), you should save a patch file and attach it to an issue report.
Note that the pserver protocol is only available to the anonymous user. All committers must use SSH to access the CVS repository if they wish to use their user id and password (i.e., if they want to write to the repository).
The repository is also made available for browsing at http://www.skywayperspectives.org/fisheye/browse/CVS_OpenSource
Committer access to CVS
Developers with commit rights have individual user ids and passwords in the Skyway Visual Perspectives project development repository. As a committer you can use SSH (Secure SHell) to connect to the CVS repository as follows. Go to a Repository View and add a new CVS repository location. When asked for the repository location enter the following:
| Host | cvs.skywayperspectives.org |
| Repository Paths | /CVS |
| User | (your committer user id) |
| Password | (your committer password) |
| Connection Type | extssh |
Once your information is authenticated, you can browse the repository and add projects to your workspace. If you do some changes that you'd like to contribute, after testing and ensuring that you have followed the contribution guidelines, you are free to release your changes to the repository. Of course, you can only release changes to projects for which you have commit rights.
Note that you can use the SSH protocol and your Skyway Visual Perspectives user id to access projects for which you are not a committer but you will not be able to release changes.
CVS Repository Paths
The Skyway Visual Perspectives repository is organized as follows:
| /skyway/common/config | Files to help configure your Eclipse development environment for working with the Skyway Visual Perspectives source |
| /skyway/common/bundles | Plugin projects that contain library dependencies required to build Skyway Visual Perspectives |
| /skyway/common/plugins | The plugin projects that make up the Skyway Visual Perspectives functionality. Each plugin is represented under here as a separate Eclipse Project |
| /skyway/common/util | <need description for this folder> |
| /skyway/releng | Projects and a script for building the Skyway Visual Perspectives features and product |
| /skyway/testing | Projects that contain unit tests for the core plugin projects |
| /skyway/visualperspectives | Projects that define the Skyway Visual Perspectives features, product, and update sites |
| /skyway/examples | Example applications built with Skyway Visual Perspectives that can be imported into a workspace where Skyway is installed |
Other CVS Clients
The Skyway Visual Perspectives CVS repository is a standard CVS implementation. As such, you can use just about any CVS client to read/write resources from/to the repository. There are however a number of files maintained in the workspace which contain Eclipse metadata (e.g., project definitions, Java classpath information). These files are written locally by Eclipse tools and then persisted in the the CVS repository. If you are using third party CVS clients, these resources may get out of date or inconsistent.
A checkout of a CVS repository created by Eclipse with the extssh protocol is, however, in nonstandard format. Not all CVS clients understand the reference to the extssh protocol in the CVS/Root files. See [1] for more details.
