Hello, savannah-hackers! I've just imported a Mercurial repository for the new group cc-mode, as part of moving a project from SourceForge to Savannah.
The process didn't run as smoothly as hoped for. Twice, I had to raise a support request. Both of these were handled promptly, to the point, and effectively. However, had the documentation on savannah.nongnu.org/maintenance/UsingHg/ been more complete, I would have sailed through without problem. So, I propose that that this page be amended, and I enclose a proposed patch. Just that my HTML competence is somewhat rudimentary, so the patch will probably need amendment from somebody more skilled in HTML. Also, there is at least one "http://"; on the page which I think should be "https://";. I haven't changed any of these. I could do, though. -- Alan Mackenzie (Nuremberg, Germany).
--- UsingHg.html.orig 2023-08-03 13:08:18.207012057 +0000 +++ UsingHg.html 2023-08-03 13:56:13.745119286 +0000 @@ -61,7 +61,18 @@ <div id="content" role="main"> <h1>Mercurial at Savannah</h1> -<p>URL summary:</p> +<h2>Introduction</h2> +<p>To use Mercurial on Savannah, you first need to enable it for your group. +Go to +<pre><code>https://savannah.gnu.org/project/admin/editgroupfeatures.php?group=<em>group</em> +</code></pre> +, and enable Mercurial there.</p> + +<p>Note that Savannah only allows one Mercurial repository per group. This +repository is created in your very first <code>hg push</code>, and cannot be +changed later without administrator intervention. So get it right!</p> + +<h2>URL summary</h2> <ul> <li>ssh://hg.sv.gnu.org/<em>group</em> - developer access using SSH</li> @@ -108,6 +119,9 @@ <ul> <li><p>Initial push / import:</p> +<p>If you are creating a new project and wish to upload a fresh repository, +proceed as follows to create the repository on your machine:</p> + <pre><code>mkdir test cd test hg init @@ -116,7 +130,14 @@ # Import everything: hg add . hg commit -m "Initial import" +</code></pre> + +<p>Alternatively, if you are importing an existing repository, +just <code>cd</code> to the repository's top level.</p> + +<p>Now create the repository at Savannah:</p> +<pre><code> # initial publication to Savannah hg push ssh://lo...@hg.sv.gnu.org/group </code></pre>
