Jump to: navigation, search

Difference between revisions of "Xtext/Contributor Guide"

m
(Run the script)
Line 26: Line 26:
 
=== Run the script  ===
 
=== Run the script  ===
  
Run the ant script located [http://git.eclipse.org/c/tmf/org.eclipse.xtext.git/plain/devtools/org.eclipse.xtext.contributor/workspace.ant here]. In unix you can use following commands:  
+
Run the ant script located [http://git.eclipse.org/c/tmf/org.eclipse.xtext.git/plain/devtools/org.eclipse.xtext.contributor/workspace.ant here]. In unix you can use following commands:
{{codeblock|wget -N http://git.eclipse.org/c/tmf/org.eclipse.xtext.git/plain/devtools/org.eclipse.xtext.contributor/workspace.ant; ant -f workspace.ant}}
+
<source lang="bash">
 +
wget -N http://git.eclipse.org/c/tmf/org.eclipse.xtext.git/plain/devtools/org.eclipse.xtext.contributor/workspace.ant
 +
ant -f workspace.ant
 +
</source>
 +
If it's the first time you are cloning Xtext repository, the script will ask you to input your bugzilla/gerrit id in order to create the necessary entries in the git configuration file, so you can push directly to gerrit. You can also skip this step by leaving your input empty and manually set up your local git repository. [[Gerrit|Here]] you can find a good description.
 +
 
 
=== Start eclipse ===
 
=== Start eclipse ===
 
Start your eclipse and choose ${user.home}/workspaces/xtext-sources as eclipse workspace
 
Start your eclipse and choose ${user.home}/workspaces/xtext-sources as eclipse workspace

Revision as of 10:08, 24 June 2013

Warning2.png
Draft Content
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.

Prerequisites

User Account

We use eclipse gerrit review server. To use the review server a few steps are required:

Eclipse Distribution

Download Full eclipse from Xtext website or use the eclipse DSL Package

Let Buckminster setup your Xcontributor environment

We provide an ant script which installs and runs Buckminster. Buckminster will do the most off necessary steps to crete a contributor workspace for you.

What does this script do in detail:

  • create an eclipse workspace
  • clone the Xtext git repository
  • populate workspace with necessary projects
  • create and set api baseline
  • create and set a target platform
  • set some important workspace settings
  • perform gerrit setup

Run the script

Run the ant script located here. In unix you can use following commands:

wget -N http://git.eclipse.org/c/tmf/org.eclipse.xtext.git/plain/devtools/org.eclipse.xtext.contributor/workspace.ant
ant -f workspace.ant

If it's the first time you are cloning Xtext repository, the script will ask you to input your bugzilla/gerrit id in order to create the necessary entries in the git configuration file, so you can push directly to gerrit. You can also skip this step by leaving your input empty and manually set up your local git repository. Here you can find a good description.

Start eclipse

Start your eclipse and choose ${user.home}/workspaces/xtext-sources as eclipse workspace

Setup working sets



Using git

As git client you may use whatever you want, the important thing is after setup your config looks like this:


[core]
      repositoryformatversion = 0
      filemode = true
      logallrefupdates = true
[remote "origin"]
        url = git://git.eclipse.org/gitroot/tmf/org.eclipse.xtext.git
        pushurl = ssh://<your account id>@git.eclipse.org:29418/tmf/org.eclipse.xtext.git
        fetch = +refs/heads/*:refs/remotes/origin/*
        push = HEAD:refs/for/master
[branch "master"]
        remote = origin
        merge = refs/heads/master


Pulling changes from server

git pull origin master

Pushing to review server

git push origin master

Helpful sites

Gerrit

Contribution monitoring

After you pushed your first commit to gerrit, it will be reviewed on the hudson review server. If all tests pass a manuel review will be done by one of the Xtext committers. If all looks good, your contribution will be pushed to the master repository and you can install it from the regular eclipse hudson server.

Browse Sources Online

Xtext and Xtend are hosted in Git. You can browse the repository in cgit here Xtext/Xtend repository.