wiki:install/repositories

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

  • In the eclipse menu: File -> Import -> Mercurial -> Clone repository using Mercurial -> Next
  • 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.

Last modified 4 years ago Last modified on 09/12/2010 09:36:03 AM