Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "STEM Source Code"

(Accessing the STEM Source Code Repository with CVS)
(Install a SVN Team Provider)
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
'''[http://wiki.eclipse.org/index.php/STEM STEM Contents Page]'''
 
==STEM Source Code==
 
==STEM Source Code==
  
Line 5: Line 6:
 
the files in the system, but only people designated as “committers”
 
the files in the system, but only people designated as “committers”
 
are allowed to add new files or make other changes to the repository.
 
are allowed to add new files or make other changes to the repository.
 +
Since STEM graduated to a top level technology project, the source
 +
code repository is SVN.
  
 
The only files that are in the repository are those that cannot be
 
The only files that are in the repository are those that cannot be
Line 11: Line 14:
 
class files.
 
class files.
  
===Accessing the STEM Source Code Repository with CVS===
+
The following sections cover some of the more common SVN tasks that you would use for STEM development.  For more information:
 +
<ul>
 +
<li>[http://wiki.eclipse.org/SVN_Howto SVN Howto]</li>
 +
</ul>
  
All elements of the Eclipse STEM project are available for anonymous read-only access to the development CVS repository.  
+
=== Install an Eclipse Team Provider for SVN ===
*'''Anonymous CVS Connection Information'''
+
Eclipse does not include a built-in SVN client with their SDK distribution, so you will need to install one into your Eclipse environment. ''Optionally, you can check out the code using a command-line client and import the projects into Eclipse.''
**'''Host''':  dev.eclipse.org
+
**'''Repository Paths''': /cvsroot/technology
+
**'''User''':  anonymous
+
**'''Password''': leave blank
+
**'''Connection Type''': pserver
+
  
To import the STEM plugin projects from CVS using the Eclipse import function, you can follow these steps:  
+
Most people use one of two SVN client plug-ins for Eclipse:
*Startup Eclipse with '''c:\stem''' as the workspace.
+
* ''' [http://subclipse.tigris.org/ Subclipse] '''
**select '''file->import'''
+
** [http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA Subclipse Installation Guide]
**select '''CVS->Projects from CVS'''
+
* ''' [http://www.eclipse.org/subversive/ Eclipse Subversive] '''
**select '''Use existing repository location'''
+
** [http://www.eclipse.org/subversive/documentation/gettingStarted/aboutSubversive/install.php Subversive Installation Guide]
**select '''next'''
+
**select '''Use existing module'''
+
**select '''next'''
+
**expand '''org.eclipse.ohf'''  
+
**select '''stem'''
+
**select the '''org.eclipse.ohf.stem.*''' projects
+
**select '''finish'''
+
  
The optional STEM projects are:
+
===Accessing the STEM Source Code Repository with SVN===
*org.eclipse.ohf.stem.tests.*  (JUnit tests)
+
*org.eclipse.ohf.stem.sample
+
*org.eclipse.ohf.stem.utility
+
  
The rest of the '''org.eclipse.ohf.stem.*''' projects are required.
+
Open the SVN Repositories window (Window->Show View->Other, SVN->SVN Repositories). Right click anywhere in the empty window and select New->Repository Location... Enter the following Url:
  
At this point, all of the projects should be checked out and then built with no errors and usually no warnings.
+
: ''' http://dev.eclipse.org/svnroot/technology/org.eclipse.stem/ '''
  
The repository is also available for browsing  [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ohf/?cvsroot=Technology_Project here].
+
The repository is also available for browsing  [http://dev.eclipse.org/viewcvs/viewvc.cgi/?root=Technology_STEM here].
 +
 
 +
 
 +
For a instructions on checking out and building the STEM source code, see the [[STEM Eclipse Setup | Setting Up your STEM Development Environment]] guide.
  
 
=== How do I send someone a patch? ===
 
=== How do I send someone a patch? ===
  
If you have modified a project that you checked out from CVS,
+
If you have modified a project that you checked out from SVN,
 
you may want to send those changes to someone else. This often occurs
 
you may want to send those changes to someone else. This often occurs
 
when you do not have commit rights, but want to send the changes to
 
when you do not have commit rights, but want to send the changes to
Line 58: Line 52:
 
       <li>Use E-mail or other delivery method to send the patch to
 
       <li>Use E-mail or other delivery method to send the patch to
 
someone else.</li>
 
someone else.</li>
 +
      <li>If the patch is associated with a Bugzilla item, it is a good idea to append to the Bugzilla item with the patch as an attachment.
 
</ol>
 
</ol>
  
Line 65: Line 60:
  
 
To apply a patch, such as one generated in the previous step, do
 
To apply a patch, such as one generated in the previous step, do
the following:</p>
+
the following:
 
<ol>
 
<ol>
 
       <li>Select the changed project in the Navigator or other view.</li>
 
       <li>Select the changed project in the Navigator or other view.</li>
       <li>Context Menu-&gt;Compare With-&gt;Patch...</li>
+
       <li>Context Menu-&gt;Team-&gt;Apply Patch...</li>
 
       <li>Fill in the location of the patch file</li>
 
       <li>Fill in the location of the patch file</li>
 
       <li>Click Next. A summary of changed files will appear.</li>
 
       <li>Click Next. A summary of changed files will appear.</li>
 
       <li>Click Finish. The changes are now merged into the workspace.</li>
 
       <li>Click Finish. The changes are now merged into the workspace.</li>
       <li>Context Menu-&gt;Team-&gt;Synchronize. You may now commit the
+
       <li>Context Menu-&gt;Team-&gt;Synchronize with Repository.</li>
changes into the repository.</li>
+
      <li>After testing the patch, if you have commit access, you may then commit the changes into the repository.</li>
 
</ol>
 
</ol>
  
===Committer access to CVS===
+
===Committer access to SVN===
  
Developers with commit rights have individual user ids and passwords in the Eclipse 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:
+
Developers with commit rights have individual user ids and passwords in the Eclipse project development repository. As a committer you can use SSH (Secure SHell) to connect to the SVN repository as follows. Go to a Repository View and add a new SVN repository location. When asked for the url enter:
  
{| style="width:60%;" border="0" cellpadding="2"
+
svn+ssh://dev.eclipse.org/svnroot/technology/org.eclipse.stem
|+Committer CVS Connection Information
+
|-
+
| '''Host''' || dev.eclipse.org  
+
|-
+
| '''Repository Paths''' || /cvsroot/technology  
+
|-
+
| '''User''' || (your committer user id, supplied by the webmaster)
+
|-
+
| '''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. The current list of committers for OHF can be found [http://www.eclipse.org/ohf/committers/index.php here].
+
Enter your user name and password and Finish.
 +
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. The current list of committers for STEM can be found [http://www.eclipse.org/projects/project_summary.php?projectid=technology.stem here].
  
 
Note that you can use the SSH protocol and your Eclipse user id to access projects for which you are not a committer but you will not be able to release changes.
 
Note that you can use the SSH protocol and your Eclipse user id to access projects for which you are not a committer but you will not be able to release changes.
 
More information about CVS usage with Eclipse is available [http://wiki.eclipse.org/index.php/CVS_Howto  here].
 

Revision as of 12:02, 29 July 2011

STEM Contents Page

STEM Source Code

All of the files that constitute the STEM project are maintained in a “source code control” system. Anyone can obtain a copy of the files in the system, but only people designated as “committers” are allowed to add new files or make other changes to the repository. Since STEM graduated to a top level technology project, the source code repository is SVN.

The only files that are in the repository are those that cannot be derived from others. For instance, Java source files would be in the repository, but not Java class files.

The following sections cover some of the more common SVN tasks that you would use for STEM development. For more information:

Install an Eclipse Team Provider for SVN

Eclipse does not include a built-in SVN client with their SDK distribution, so you will need to install one into your Eclipse environment. Optionally, you can check out the code using a command-line client and import the projects into Eclipse.

Most people use one of two SVN client plug-ins for Eclipse:

Accessing the STEM Source Code Repository with SVN

Open the SVN Repositories window (Window->Show View->Other, SVN->SVN Repositories). Right click anywhere in the empty window and select New->Repository Location... Enter the following Url:

http://dev.eclipse.org/svnroot/technology/org.eclipse.stem/

The repository is also available for browsing here.


For a instructions on checking out and building the STEM source code, see the Setting Up your STEM Development Environment guide.

How do I send someone a patch?

If you have modified a project that you checked out from SVN, you may want to send those changes to someone else. This often occurs when you do not have commit rights, but want to send the changes to someone who does. To create a patch file:

  1. Select the changed project in the Navigator or other view.
  2. Context Menu->Team->Create Patch...
  3. Select a location for the patch.
  4. Use E-mail or other delivery method to send the patch to someone else.
  5. If the patch is associated with a Bugzilla item, it is a good idea to append to the Bugzilla item with the patch as an attachment.

Note that Create patch can be run with multiple projects selected.

How do I apply a patch that someone sent me?

To apply a patch, such as one generated in the previous step, do the following:

  1. Select the changed project in the Navigator or other view.
  2. Context Menu->Team->Apply Patch...
  3. Fill in the location of the patch file
  4. Click Next. A summary of changed files will appear.
  5. Click Finish. The changes are now merged into the workspace.
  6. Context Menu->Team->Synchronize with Repository.
  7. After testing the patch, if you have commit access, you may then commit the changes into the repository.

Committer access to SVN

Developers with commit rights have individual user ids and passwords in the Eclipse project development repository. As a committer you can use SSH (Secure SHell) to connect to the SVN repository as follows. Go to a Repository View and add a new SVN repository location. When asked for the url enter:

svn+ssh://dev.eclipse.org/svnroot/technology/org.eclipse.stem

Enter your user name and password and Finish. 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. The current list of committers for STEM can be found here.

Note that you can use the SSH protocol and your Eclipse user id to access projects for which you are not a committer but you will not be able to release changes.

Back to the top