Dirk: what to do with an existing hgrc file

2009-05-16T08:20:20Z

what to do with an existing hgrc file

Dirk: Setting up a Mercurial Repository on cvs.geeklog.net

2009-05-16T08:13:12Z

Setting up a Mercurial Repository on cvs.geeklog.net

New page

'''Note:''' This requires you to be logged in using the hosting account. It does ''not'' work with a user account.

== Creating the Repository ==

First of all:

<pre>cd /cvsroot/hg</pre>

All Mercurial repositories are located in this directory.

The following instructions use <tt>newname</tt> for the name of the new repository.

=== Empty Repository ===

For a completely new and empty repository, simply do

<pre>hg init newname</pre>

=== Cloning an existing Repository ===

If you want to set up a repository that is a clone of an already existing repository (<tt>oldname</tt>), do

<pre>hg clone -U oldname newname</pre>

Note the <tt>-U</tt> (uppercase 'U') option. It creates a clone without checking out the files (as we don't need any checked-out files in a repository on this server).

=== Uploading an existing Repository ===

Use <tt>scp</tt> to upload an existing repository. You don't need to include the checked-out files, so you effectively only need the <tt>.hg</tt> directory. You could create a local clone using <tt>hg clone -U</tt> before the upload.

== Setting the Permissions ==

The repository will now be owned by the current user and not be usable from any user accounts. Therefore, do this:

<pre>chmod -R g+rws newname</pre>

Ignore the "Operation not permitted" messages. Check that the permissions for the directory are now: <tt>drwxrwsr-x</tt> (note the '<tt>s</tt>').

== Creating a hgrc file ==

Inside the <tt>newname/.hg/</tt> directory, create a new file <tt>hgrc</tt> (no leading dot!) that contains this:

<pre>
[trusted]
users = geeklog2
groups = users

[web]
baseurl = http://project.geeklog.net/cgi-bin/hgweb.cgi
style = gitweb
contact = contact-us(AT)lists.geeklog.net
description = (description goes here)
name = (repository name goes here)
allow_archive = gz
</pre>

Obviously, you should fill in something sensible for the description and the name!

The <tt>allow_archive</tt> setting is optional - it allows downloading the repository as a .gz file.

== Hooking it up with the Repository Viewer ==

* Open the file <tt>~/public_html/www/cgi-bin/hgweb.config</tt>
* Add a line <pre>newname = /cvsroot/hg/newname</pre>
* Call up the [http://project.geeklog.net/cgi-bin/hgwebdir.cgi/ viewer] and check that the new repository is listed.

[[Category:Internals]]

@@ Line 32: / Line 32: @@
 == Setting the Permissions ==
-The repository will now be owned by the current user and not be usable from any user accounts. Therefore, do this:
+The repository will now be owned by the current user and not be usable from any user account. Therefore, do this:
 <pre>chmod -R g+rws newname</pre>
@@ Line 56: / Line 56: @@
 allow_archive = gz
 </pre>
 Obviously, you should fill in something sensible for the description and the name!

Setting up a Repository - Revision history

Dirk: what to do with an existing hgrc file

Dirk: Setting up a Mercurial Repository on cvs.geeklog.net