We generally treat the Mercurial repositories for PySoy as wikis - fairly easy to get to, but we do want to keep it tidy.

Registering

Connect to our IRC channel (#PySoy on irc.freenode.net) and type /msg _hg help register

If you have not done so already, you will need to register with NickServ? before _hg will help you. The nickname you register with will be what _hg will use for updating your password and for _hg to report issues to. The name and email address you register with must match your .hgrc setting and will be used as alternative means to contact you and record your changes for attribution.

Developers are expected to be on IRC while they work, and certainly when they push, so that issues can get fixed immediately. _hg reports all changesets as they're received and will let you know if there's a problem.

Linux Instructions

On linux, edit your ~/.hgrc file with your name and email address. If this file doesn't already exist, create it.

Some points to remember:

  1. DON'T COMMIT without first setting up your .hgrc file.
  2. DON'T FORGET to "hg pull -u" (Update your working copy with latest changes) before committing.
  3. Commit early and often, but only when the code you're working on compiles and tests clean.

~/.hgrc

[ui]
username = Arc Riley <arcriley@gmail.com>

[extensions]
color =

Command

Once you've registered with _hg and edited your .hgrc file, you may run:

hg pull -u     # download recent changes
hg commit      # commit your work locally
hg push        # send your changes to the server

Windows Instructions

On windows, you should use tortoisehg as a client. Here are some instructions on how to perform certain necessary tasks on it:

  1. Cloning repositories - you should create an empty folder with project name and right click -> clone. Replace source with the repository address and click clone.
  2. Setting up mercurial.ini - To setup mercurial on windows, right click on project -> TortoiseHg? -> Global Settings. Click on edit file and copy the format from below. Don't forget to save.
[ui]
username = Arc Riley <arcriley@gmail.com>
merge = kdiff3

[extensions]
color =
  1. Committing - Right click project and click on "Hg commit" to commit your work. Don't forget to put a nice commit message before pressing commit.
  2. Pulling and pushing - Once your commits are made, use the sync option in the context-sensitive TortoiseHg? menu on right clicking your project to pull and push.