init
====

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

:Options:
  -v, --verbose         Display more information.
  --format=ARG          Specify a format for this branch. See "help formats".
  --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.

: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 'brz checkout'.
  
  Recipe for importing a tree of files::
  
      cd ~/project
      brz init
      brz add .
      brz status
      brz commit -m "imported project"

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


