Trac is being migrated to new services! Issues can be found in our new
YouTrack instance and WIKI pages can be found on our
website.
- Timestamp:
-
Jul 1, 2012, 6:18:01 AM (12 years ago)
- Author:
-
MarkDoliner
- Comment:
-
We're using Mercurial now, so make this present tense instead of future tense
Legend:
- Unmodified
- Added
- Removed
- Modified
-
|
v9
|
v10
|
|
| 1 | 1 | = Using Pidgin Mercurial = |
| 2 | | This page is intended to house documentation for using Pidgin's Mercurial repositories once we switch from Monotone to Mercurial. |
| | 2 | The master copy of the source code for libpurple, Pidgin, Finch, http://pidgin.im/, and http://imfreedom.org/ resides in [http://mercurial.selenic.com/ Mercurial] repositories. |
| 3 | 3 | |
| 4 | 4 | == Background == |
| … |
… |
|
| 6 | 6 | |
| 7 | 7 | == Anonymous Pull (Non-Developers) == |
| 8 | | All Pidgin Mercurial repositories will be available via HTTP from [http://hg.pidgin.im http://hg.pidgin.im]. |
| | 8 | All Pidgin Mercurial repositories are available via HTTP from [http://hg.pidgin.im http://hg.pidgin.im]. |
| 9 | 9 | |
| 10 | 10 | == Developers == |
| 11 | 11 | |
| 12 | 12 | === Configure Mercurial === |
| 13 | | Mercurial uses an rc file to control its configuration. There are several that will affect your use. One set of them is in `/etc/mercurial` and will be controlled by your package manager. The others are entirely under your control. Each repository has its own `hgrc` file in `repository/.hg/hgrc` which can be used to configure mercurial's behavior when interacting with that repository. Finally, there is `~/.hgrc`, which will configure mercurial's behavior for any repository your user account touches. |
| | 13 | Mercurial uses an rc file to control its configuration. There are several that affect your use. One set of them is in `/etc/mercurial` and is controlled by your package manager. The others are entirely under your control. Each repository has its own `hgrc` file in `repository/.hg/hgrc` which can be used to configure Mercurial's behavior when interacting with that repository. Finally, there is `~/.hgrc`, which affects Mercurial's behavior for any repository your user account touches. |
| 14 | 14 | |
| 15 | | When working with Pidgin's mercurial repositories, we expect that you will have at least a minimum configuration that gives your name in the 'First Last <email@address.tld>' format. To do that, two simple lines need to be inserted into an appropriate `hgrc` (I believe most people will want to do this in `~/.hgrc`): |
| | 15 | When working with Pidgin's Mercurial repositories, we expect you to have at least a minimum configuration that gives your name in the 'First Last <email@address.tld>' format. To do that, two simple lines need to be inserted into an appropriate `hgrc` (I believe most people will want to do this in `~/.hgrc`): |
| 16 | 16 | {{{ |
| 17 | 17 | [ui] |
| … |
… |
|
| 19 | 19 | }}} |
| 20 | 20 | |
| 21 | | Other useful options that can be set in the `[ui]` section of an `hgrc` are the merge tool and to make mercurial verbose or not: |
| | 21 | Other useful options that can be set in the `[ui]` section of an `hgrc` are the merge tool and to make Mercurial verbose or not: |
| 22 | 22 | {{{ |
| 23 | 23 | [ui] |
| … |
… |
|
| 63 | 63 | |
| 64 | 64 | === Access Control === |
| 65 | | Access control on Pidgin's Mercurial server is strict. The repositories will be structured like so (developers/CPW's listed here are for the purpose of example): |
| | 65 | Access control on Pidgin's Mercurial server is strict. The repositories are structured like so (developers/CPW's listed here are for the purpose of example): |
| 66 | 66 | |
| 67 | 67 | {{{ |
| 68 | 68 | hg.pidgin.im # Mercurial server |
| 69 | 69 | + pidgin # "Official" Pidgin and libpurple repositories |
| 70 | | | + main # replaces im.pidgin.pidgin in Monotone |
| 71 | | | + 2_x_y # replaces im.pidgin.pidgin.2.x.y in Monotone |
| | 70 | | + main # replaced im.pidgin.pidgin in Monotone |
| | 71 | | + 2_x_y # replaced im.pidgin.pidgin.2.x.y in Monotone |
| 72 | 72 | + dev # Developers' repositories |
| 73 | 73 | | + darkrain # for all repositories darkrain wishes to create |
| 74 | | | | + irc # replaces im.pidgin.cpw.darkrain42.irc in Monotone |
| 75 | | | | + xmpp_roster # replaces im.pidgin.cpw.darkrain42.xppp.roster in Monotone |
| | 74 | | | + irc # replaced im.pidgin.cpw.darkrain42.irc in Monotone |
| | 75 | | | + xmpp_roster # replaced im.pidgin.cpw.darkrain42.xppp.roster in Monotone |
| 76 | 76 | | + rekkanoryo # for all repositories rekkanoryo wishes to create |
| 77 | | | + examples # replaces im.pidgin.cpw.rekkanoryo.examples in Monotone |
| | 77 | | + examples # replaced im.pidgin.cpw.rekkanoryo.examples in Monotone |
| 78 | 78 | + cpw # Crazy Patch Writers' repositories |
| 79 | 79 | | + eionrobb # for all repositories eionrobb wishes to create |
| … |
… |
|
| 92 | 92 | }}} |
| 93 | 93 | |
| 94 | | Access control will be as follows: |
| | 94 | Access control is as follows: |
| 95 | 95 | * Developers have write access to `pidgin/*` |
| 96 | 96 | * Developers can create and modify repositories in `dev/$NICKNAME/` |
All information, including names and email addresses, entered onto this website or sent to mailing lists affiliated with this website will be public. Do not post confidential information, especially passwords!