ceph/doc/source/clone-source.rst

=========================================
 Cloning the Ceph Source Code Repository
=========================================
To clone the source, you must install Git. See `Set Up Git`_ for details.

.. _Set Up Git: ../git

Clone the Source
----------------
To clone the Ceph source code repository, execute::

	git clone --recursive https://github.com/ceph/ceph.git

Once ``git clone`` executes, you should have a full copy of the Ceph 
repository.

.. tip:: Make sure you maintain the latest copies of the submodules
   included in the repository. Running ``git status`` will tell you if
   the submodules are out of date::

	cd ceph
	git status

   If they are, run::

        git submodule update

Choose a Branch
---------------
Once you clone the source code and submodules, your Ceph repository 
will be on the ``master`` branch by default, which is the unstable 
development branch. You may choose other branches too.

- ``master``: The unstable development branch.
- ``stable``: The bugfix branch.
- ``next``: The release candidate branch.

::

	git checkout master