[Savannah-cvs] [UsingHg] (edit) Initial Mercurial help

[aleix]

??changed:
-To Be Documented
URL-s summary:

* ssh://hg.sv.gnu.org/project - developer access using SSH
* http://hg.sv.gnu.org/hgweb/project - lightwieght protocol, http-based 
(read-only access)

Web browser: http://hg.sv.gnu.org/hgweb/

Basic commands
==============

* Checkout::

   hg clone ssh://address@hidden/project

   or

   hg clone http://hg.sv.gnu.org/hgweb/project (read-only access)

Developer setup
===============

Your identity for when you push commits (strongly recommended) editing your 
user configuration file (~/.hgrc)::

   [ui]
   username = Your Name Comes Here <address@hidden>

It is also possible to edit your identity in each project (project/.hg/hgrc). 
This allows different identities for different projects.

Developer basic commands
========================

* Initial push / import::

   mkdir test
   cd test
   hg init
   touch README
   # edit/add other files...
   # Import everything:
   hg add . 
   hg commit -m "Initial import"
   
   #  initial publication to Savannah
   hg push ssh://address@hidden/project

  Note: at this point your repository is not setup to merge _from_ the remote 
branch when you type 'hg pull'.
  You can either freshly 'clone' the repository (see "Developer checkout" 
below), or configure your current repository this way:

  Edit project/.hg/hgrc::

   [paths]
   default = ssh://hg.sv.gnu.org/project

* Developer checkout::

   hg clone ssh://address@hidden/project

* Commit::

   cd project/
   
   # <edit some_existing_file>
   hg commit -m "I automatically commit modified files"
   
   # <edit some_other_existing_file and something_else>
   hg add some_other_existing_file
   hg commit -m "I only marked some_other_existing_file and other changes for 
commit"

   or::

   hg commit -A -m "I automatically add new files and commit any other changes"

   # <only commit one modified file>
   touch some_existing_file
   hg commit -m "I only commit one file" some_existing_file

   # Check your changes with the graphical tool
   hg view

   # Check what's going to be pushed
   hg outgoing

   # Check what's coming from Savannah (from other developers)
   hg incoming

   # Send everything to Savannah
   hg push



--
forwarded from 
https://savannah.gnu.org/maintenance/address@hidden://savannah.gnu.org/maintenance