| 2 | | We generally treat the Mercurial repositories for PySoy as wikis - fairly easy to get to, but we do want to keep it tidy. |
| 3 | | Toward that end, first commit should be done to the mailing list to ensure the metadata is correct. Mercurial makes this really simple, edit your ~/.hgrc file with your name, email address, and SMTP password. Note that if you use GMail, you'll need to [https://accounts.google.com/b/0/IssuedAuthSubTokens?hl=en create an application-specific password]. |
| | 5 | On linux, edit your ~/.hgrc file with your name, email address, and SMTP password. Note that if you use GMail, you'll need to [https://accounts.google.com/b/0/IssuedAuthSubTokens?hl=en create an application-specific password]. Use the application-specific password in your .hgrc file rather than your actual password if using GMail. |
| | 50 | |
| | 51 | = Windows Instructions = |
| | 52 | |
| | 53 | On windows, you should use tortoisehg as a client. Here are some instructions on how to perform certain necessary tasks on it: |
| | 54 | 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. |
| | 55 | 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. Also, if you are using GMail, use the application specific password instead of your account password. |
| | 56 | |
| | 57 | {{{ |
| | 58 | [ui] |
| | 59 | username = Arc Riley <arcriley@gmail.com> |
| | 60 | merge = kdiff3 |
| | 61 | |
| | 62 | [email] |
| | 63 | from = Arc Riley <arcriley@gmail.com> |
| | 64 | to = pysoy-dev@pysoy.org |
| | 65 | |
| | 66 | [smtp] |
| | 67 | host = smtp.gmail.com |
| | 68 | port = 587 |
| | 69 | tls = True |
| | 70 | username = arcriley@gmail.com |
| | 71 | password = smtp_password |
| | 72 | |
| | 73 | [extensions] |
| | 74 | color = |
| | 75 | patchbomb = |
| | 76 | }}} |
| | 77 | |
| | 78 | 3. 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. |
| | 79 | 4. Pulling and pushing - One your repository is cloned, use the sync option in the context-sensitive TortoiseHg menu on right clicking your project to pull and push. |
| | 80 | 5. Emailing commits - The Hg email option is also found in the sync dialog box. If your email settings are correct, you are good to go. Select your commits and mail them. You won't be able see whether your mail was sent unless you are subscribed to the mailing list. It WON'T appear on the gci site. Subscribe to the mailing list [http://lists.pysoy.org/mailman/listinfo/pysoy-dev here] to check whether your mail was actually sent. Please prevent multiple mails for the same patch. |