Mercurial User Repositories - Revision history

DS: /* Creating a Repository */ Fixed typo

2013-08-25T23:20:10Z

‎Creating a Repository: Fixed typo

DS at 10:08, 18 December 2009

2009-12-18T10:08:01Z

DS: A tired rough draft

2009-12-18T10:07:18Z

A tired rough draft

New page

At AlliedModders, every developer who has commit access to a Mercurial repository (or even an SVN repository that requires SSH access) is able to have their own Mercurial forest. These forests are located under the /users subdirectory and may contain multiple repository clones.

=Configuring SSH=
So that you won't need to type your username every time, add the following lines to <tt>~/.ssh/config</tt>:
<pre>
Host hg.alliedmods.net
User mailuser@domain.com
</pre>
where <tt>mailuser@domain.com</tt> refers to the e-mail address you use for Mercurial or SVN access.

=Creating a Repository=
In order to create a repository, run the following command. You're going to be using the same command whether you are creating a new, empty repository or cloning an existing one.
<pre>
ssh hg.alliedmods.net clone myrepo
</pre>

'''Note:''' <tt>myrepo</tt> refers to the name of the new repository you wish to create, not the repository you're trying to clone from.

Runnning the above command will start an interactive script which will prompt you to make a few choices. It is mostly self-explanatory. The out of the command should look something like this:
<pre>
ds@iroh ~ $ ssh hg.alliedmods.net clone myrepo
Making repo myrepo for ds@alliedmods.net.
This repo will appear as hg.alliedmods.net/users/ds_alliedmods.net/myrepo

0) Exit
1) Yes
2) No

Proceed?
</pre>

If you select <tt>Yes</tt> it will proceed to ask you about which existing repository you want to clone from or whether you wish to create a new, empty repository.

'''Note:''' As a shortcut, you may add a second argument to the clone command in order to specify an existing repository if you already know which one you wish to clone from:
<pre>
ssh hg.alliedmods.net clone myrepo sourcemod-central
</pre>

=Editing a Repository=
Once your repository has been created, you can edit its description. This description will appear when you go to http://hg.alliedmods.net/users/mailuser_domain.com. In order to do this, use the <tt>edit</tt> command:
<pre>
ds@iroh ~ $ ssh hg.alliedmods.net edit myrepo
0) Exit
1) Delete the repository
2) Edit the description

What would you like to do?
</pre>

You may also delete the repository using this command.

=Access Via the Web=
Your Mercurial forest is visible at http://hg.alliedmods.net/users/mailuser_domain.com and you'll be able to browse repository history via a web interface.

Everyone may clone a repository using the following format:
<pre>
hg clone http://hg.alliedmods.net/users/mailuser_domain.com/myrepo
</pre>

=Pushing Changes=
In order to push changes, you must use SSH like so:
<pre>
ssh://hg.alliedmods.net/users/mailuser_domain.com/myrepo
</pre>

You may wish to add this to your local repository's hgrc file so that you don't need to type it every time:
<pre>
default-push = ssh://hg.alliedmods.net/users/mailuser_domain.com/myrepo
</pre>

← Older revision		Revision as of 10:08, 18 December 2009
Line 1:		Line 1:
−	At AlliedModders, every developer who has commit access to a Mercurial repository (or even an SVN repository that requires SSH access) is able to have their own Mercurial forest. These forests are located under the /users subdirectory and may contain multiple repository clones.	+	At AlliedModders, every developer who has commit access to a [[Mercurial Tutorial\|Mercurial]] repository (or even an SVN repository that requires SSH access) is able to have their own Mercurial forest. These forests are located under the /users subdirectory and may contain multiple repository clones.

	=Configuring SSH=		=Configuring SSH=

@@ Line 17: / Line 17: @@
 '''Note:''' <tt>myrepo</tt> refers to the name of the new repository you wish to create, not the repository you're trying to clone from.
-Runnning the above command will start an interactive script which will prompt you to make a few choices. It is mostly self-explanatory. The out of the command should look something like this:
+Runnning the above command will start an interactive script which will prompt you to make a few choices. It is mostly self-explanatory. The output of the command should look something like this:
 <pre>
 ds@iroh ~ $ ssh hg.alliedmods.net clone myrepo