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.
    --1.14              A working-tree format that supports content filtering.
    --1.14-rich-root    A variant of 1.14 that supports rich-root data (needed
                        for bzr-svn and bzr-git).
    --2a                First format for bzr 2.0 series. Uses group-compress
                        storage. Provides rich roots which are a one-way
                        transition.
    --default           First format for bzr 2.0 series. Uses group-compress
                        storage. Provides rich roots which are a one-way
                        transition.
    --pack-0.92         New in 0.92: Pack-based format with data compatible
                        with dirstate-tags format repositories. 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>`