Version 7 (modified by MayankSingh, 23 months ago) (diff)

--

We generally treat the Mercurial repositories for PySoy as wikis - fairly easy to get to, but we do want to keep it tidy. Toward that end, first commit should be done to the mailing list to ensure the metadata is correct.

Linux Instructions

On linux, edit your ~/.hgrc file with your name, email address, and SMTP password. Note that if you use GMail, you'll need to  create an application-specific password. Use the application-specific password in your .hgrc file rather than your actual password if using GMail.

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. It would be a good idea to commit only once when your work for the task is done.
  4. ~ is your home directory in linux. To view .hgrc in nautilus(File browser), first show hidden files and then you can edit your .hgrc file or you could just do a "gedit ~/.hgrc" or "vim ~/.hgrc" on a terminal. If you couldn't find an already existing .hgrc file, DON'T panic. Just create a file with name .hgrc in your home directory using gedit or some text editor or you could do a "vim ~/.hgrc" or "gedit ~/.hgrc". The format for the .hgrc file is as follows. Obviously, don't forget to save.

~/.hgrc

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

[email]
from = Arc Riley <arcriley@gmail.com>
to = pysoy-dev@pysoy.org

[smtp]
host = smtp.gmail.com
port = 587
tls = starttls
username = arcriley@gmail.com
password = smtp_password

[extensions]
color =
patchbomb =

Command

After you add this, which notably ensures your username (full name and email) are recorded so you get proper credit for your work, commit your work (potentially more than one commit) and run this using the revision of the first commit in the series:

> hg email 99999

If you didn't catch the revision number when you committed, use hg log | less to find the first one you made. Replace 99999 above with the number before the colon.

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  here to check whether your mail was actually sent. Please prevent multiple mails for the same patch.

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. Also, if you are using GMail, use the application specific password instead of your account password.
[ui]
username = Arc Riley <arcriley@gmail.com>
merge = kdiff3

[email]
from = Arc Riley <arcriley@gmail.com>
to = pysoy-dev@pysoy.org

[smtp]
host = smtp.gmail.com
port = 587
tls = True
username = arcriley@gmail.com
password = smtp_password

[extensions]
color =
patchbomb =
  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 - One your repository is cloned, use the sync option in the context-sensitive TortoiseHg? menu on right clicking your project to pull and push.
  3. 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  here to check whether your mail was actually sent. Please prevent multiple mails for the same patch.

Attachments