init
====

:Purpose: Make a directory into a versioned branch.
:Usage:   bzr init [LOCATION]

:Options:
  -v, --verbose         Display more information.
  --create-prefix       Create the path leading up to the branch if it does
                        not already exist.
  -q, --quiet           Only display errors and warnings.
  --append-revisions-only
                        Never change revnos or the existing log.  Append
                        revisions to it only.
  --usage               Show usage message and options.
  --no-tree             Create a branch without a working tree.
  -h, --help            Show help message.

  Branch format:
    --format=ARG        Specify a format for this branch. See "help formats".
    --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:
  Use this to create an empty branch, or before importing an
  existing project.
  
  If there is a repository in a parent directory of the location, then
  the history of the branch will be stored in the repository.  Otherwise
  init creates a standalone branch which carries its own history
  in the .bzr directory.
  
  If there is already a branch at the location but it has no working tree,
  the tree can be populated with 'bzr checkout'.
  
  Recipe for importing a tree of files::
  
      cd ~/project
      bzr init
      bzr add .
      bzr status
      bzr commit -m "imported project"

:See also: :doc:`branch <branch-help>`, :doc:`checkout <checkout-help>`, :doc:`init-repository <init-repository-help>`