Mercurial quick memo

• Mercurial startup memo
• Mercurial concept memo
• Mercurial example memo
• Miscellaneous

Mercurial startup memo

• Set up central repository. hg_repository is an example of repository directory name.

       # mkdir hg_repository
       # cd hg_repository
       # hg init
       

• Start small http server for the hg_repository, access with machine:8000. In the hg_repository/,

       # hg serve      ; start the small server
       # hostname
       YOUR_MACHINE_HOST_NAME
       # cd somewhere/your/project/to/checkout
       # hg clone http://${YOUR_MACHINE_HOST_NAME}:8000 clonetest
       

• Single repository in your local network only.
  • If you only need a single repository, or using single repository is the usual case, hg serve is a simple solution. In that case, you might see the following error.

         [19]bash % hg push
         pushing to http://myhost:8000
         searching for changes
         ssl required
              

    You neee to set up ssl enabled server. To do this, please see the more detailed hg documentation, here assumes just local use. To enable anyone local to push with 'hg serve':
    • open hg_repository/.hg/hgrc and add the following lines.

            [web]
            push_ssl=False
            allow_push=*
                

    Note: This is dangerous in the public, so please limit this method in the local. 'hg server' is just a default small server ability and it has no authorization capability.

  It seems hg serve doesn't have a path after the host (http://host:8000//path), so multiple repositories by hg serve is not simple. But hg serve is simple for one repository.

• Multiple repository usage.
  

  In many cases, you want to have multiple repositories. Since you may have several projects.

  Mercurial (or git) uses project based repository (each project has own repository. Instead of host based repository. I came from CVS, subversion, so I didn't think about this until I started hg and git, but, a host machine is nothing about a project...)

  It seems an easy way to create multiple repositories is by cloning via hg ssh protocol.

  First on your server, hg init the directory.

       # hg init /your/repository/project0
       

  Then clone it.

       # hg clone ssh://${YOUR_MACHINE_HOST_NAME}:22//your/repository/project0 project0
       

  You can omit :22 if you use standard ssh port.

• Basic update the repository
  • hg commit ; commit the local change to local
  • hg push ; push the commits to the central repository
  • hg pull ; pull the central repository to local repository
  • hg update ; update the local project from local repository
• User name settings
  • add ~/.hgrc (or Windows, %USERPROFILE%\Mercurial.ini)

              [ui]
              username = My Name <name@email.de>
              

• Ignore settings
  • Add ~/.hgrc to refer which ignore file will be used as:

              [ui]
              ignore = ~/.hgignore
              

  • Edit ~/.hgignore as:

              #
              # Mercurial ignore file
              #
              syntax: regexp
              /Ubuntu9.04.*/
              ^TMakefile.priv$
              

Mercurial concept memo

• I started to use Google Code for my open source projects, then I see Mercurial as a revision control tool. This is a memo of Mercurial.
• One advantage of mercurial for single user over subversion is it works without network. Subversion can also work some extent without network, but, Mercurial works better.
• Here is a great tutorial http://hginit.com
• Mercurial structure and basic commands. I use subversion, but Mercurial is distributed revision control system. It means you can have many repositories and also many local repositories. My usage is (see the tutorial also):

       +------------------------------+
       |Google code repository        |
       +------------------------------+
          ^ hg push                  ^
          |                          |
          |                          |
          |                          |
          v hg pull                  v
       +---------------------+    +---------------------+
       |my local repository 0|    |my local repository 1|  ...
       +---------------------+    +---------------------+
          ^ hg commit                ^
          |                          |
          |                          |
          |                          |
          v hg update                v
       +-----------------+        +-----------------+
       |my working copy 0|        |my working copy 1|      ...
       +-----------------+        +-----------------+
       

  I have a few machines, one is desktop and ther others are notebooks.

Mercurial example memo

• If I want to forget the local change.
  • remove or move the file and hg revert fname.

Miscellaneous

• I put local hgserver's hostname as hgserver (/etc/hosts's alias).