init-repository
===============

:Purpose: Create a shared repository for branches to share storage space.
:Usage:   bzr init-repository LOCATION

:Options:
  --no-trees            Branches in the repository will default to not having
                        a working tree.
  -v, --verbose         Display more information.
  -q, --quiet           Only display errors and warnings.
  --usage               Show usage message and options.
  -h, --help            Show help message.

  Repository format:
    --format=ARG        Specify a format for this repository. See "bzr help
                        formats" for details.
    --2a                Format for the bzr 2.0 series. Uses group-compress
                        storage. Provides rich roots which are a one-way
                        transition.
    --default           Format for the bzr 2.0 series. Uses group-compress
                        storage. Provides rich roots which are a one-way
                        transition.
    --development-colo  The 2a format with experimental support for colocated
                        branches.
    --pack-0.92         Pack-based format used in 1.x series. Introduced in
                        0.92. Interoperates with bzr repositories before 0.92
                        but cannot be read by bzr < 0.92.

:Description:
  New branches created under the repository directory will store their
  revisions in the repository, not in the branch directory.  For branches
  with shared history, this reduces the amount of storage needed and 
  speeds up the creation of new branches.
  
  If the --no-trees option is given then the branches in the repository
  will not have working trees by default.  They will still exist as 
  directories on disk, but they will not have separate copies of the 
  files at a certain revision.  This can be useful for repositories that
  store branches which are interacted with through checkouts or remote
  branches, such as on a server.

:Examples:
    Create a shared repository holding just branches::

        bzr init-repo --no-trees repo
        bzr init repo/trunk

    Make a lightweight checkout elsewhere::

        bzr checkout --lightweight repo/trunk trunk-checkout
        cd trunk-checkout
        (add files here)

:Aliases:  init-repo
:See also: :doc:`branch <branch-help>`, :doc:`checkout <checkout-help>`, :doc:`init <init-help>`, :doc:`repositories <repositories-help>`