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!