- JPFWiki - Welcome Page
- System requirements
- Download snapshots
- Download repositories
- Create site.properties
- Install NetBeans IDE plugin
- Install Eclipse IDE plugin
- Building and testing
- Summer Projects
- External Projects
- Table of Context
JPF Source Repository Access
JPF sources are kept as Mercurial repositories within the http://babelfish.arc.nasa.gov/hg/jpf directory. You need to clone the subrepositories (e.g. http://babelfish.arc.nasa.gov/hg/jpf/jpf-core) you are interested in, not the root directory ../hg/jpf itself (which most likely will give you old subrepo revisions).
We provide anonymous, public read access. If you want to push your changes back to the repository, and you are not a NASA Ames employee, you need to obtain a JPF contributor account.
Mercurial is a Distributed Version Control System (DVCS), like Git. If you are not familiar with this, it means "all repositories are created equal", and you have to read up a bit. The foremost authority is Mercurial: The Definite Guide, useful cheat sheets are here, here and here.
For the unpatient, we also provide a short Mercurial primer.
Command Line Access
To "check out" the jpf-core (the mercurial term is actually "clone"):
> cd ~/projects > hg clone http://babelfish.arc.nasa.gov/hg/jpf/jpf-core destination directory: jpf-core requesting all changes ... added 71 changesets with 2045 changes to 1694 files updating working directory 683 files updated, 0 files merged, 0 files removed, 0 files unresolved
The same process can be repeating by substituting jpf-core with the project you are interested in. You can install the projects wherever you want, but you have to remember where you installed them for the subsequent site.properties configuration.
To update your local repository, change to its directory and do a "pull" (don't forget the "-u" option, or your working directories will not get updated)
> cd ~/projects/jpf-core > hg pull -u
If you want - and are allowed - to push back your changes, you use https://babelfish.arc.nasa.gov/hg/jpf/<project> as the URL, which will require entering your user-name and password. Before pushing the changes you have to commit the changes from your working directory to your local repository.
> cd ~/projects/jpf-core > hg commit -m "this commits to the local repository"
The changes now can be pushed to the central repository using the following command
> hg push https://babelfish.arc.nasa.gov/hg/jpf/jpf-core
Not specifying a command lists all available ones.
Mercurial Support within NetBeans
There is no need to install any plugins, NetBeans is distributed with Mercurial support.
Mercurial Plugin for Eclipse
To work within Eclipse
- Download and install the MercurialEclipse plugin, which at the time of this writing is available from the update site: http://cbes.javaforge.com/update (the usual Eclipse spiel: "Help" -> "Install New Software..." -> "add site", enter the update URL above)
- In the eclipse menu: File -> Import -> Mercurial -> Clone repository using Mercurial -> Next
- In the repository location, URL, specify http://babelfish.arc.nasa.gov/hg/jpf/jpf-core
- Check the box for 'Search for .project files in clone and use them to create projects'
- Click on Finish
The steps listed above will clone the repository in your workspace. The same set of instructions can be followed to get access to all the other projects. Subsequently right clicking on the project will show a 'Team' option that allows to perform all the version control operations.