What is Mercurial?
Mercurial (sometimes abbreviated to HG) is version control software—it allows for multiple people to work on a single document, piece of code, or part of a project together, storing the changed versions along the way. Wikis act in a similar fashion for wiki articles, where as Mercurial repositories handle files. For more information and a bit of history on the Mercurial software, see Revision Control and Mercurial.
Why does Sonic Retro have Mercurial repositories? What are they used for?
Much in the same way that our wiki allows for collaboration on documentation of Sonic research, the Mercurial repositories allow for members to work together directly on things such as disassemblies and experimental projects.
How do I access them?
The access path for the Mercurial repositories is at http://repo.sonicretro.org/.
Do I need an account to use Mercurial?
Currently, you do not need an account to checkout (download). However, in order to make revisions (upload) you will need to link your Sonic Retro account into the Mercurial system. Currently this is only available to Tech Members and 'above', but you can appeal if you feel that you should have write-access. For more information, please visit this topic.
Okay, I now have write access, how do I commit my changes?
You will need Mercurial software in order to fully use and to offer commits to a Mercurial repository. There are about a million clients available, but we recommend:
Windows: TortoiseHG
Mac OS X: MacHG
I have something cool that I'd like to put on the Mercurial repositories. I just upload it, right?
No. Please post any proposed uploads in this forum so we can see if they have any merit.
Things likely to have merit:
- Disassemblies
- Open work on utilities
- Custom coding for video game consoles
- Files being hacked or examined
Things NOT likely to have merit:
- Your own hack
- Something you randomly found on the Internet
- Something that isn't yours or you don't have expressed permission to upload
Are there other resources related to the Community Mercurial Project?
You can join #repo on irc.badnik.net to get help, to discuss with other contributors or to know when new revisions are committed.


