# # # patch "monotone.texi" # from [3f748cc4aff1052d8ce1fe84b38be3ae0f9f1e1b] # to [15db78283b37ff391e0deba3c08a3aeb3de75098] # ============================================================ --- monotone.texi 3f748cc4aff1052d8ce1fe84b38be3ae0f9f1e1b +++ monotone.texi 15db78283b37ff391e0deba3c08a3aeb3de75098 @@ -32,6 +32,7 @@ Copyright @copyright{} 2005, 2006 Daniel Carosone @* Copyright @copyright{} 2006 Jeronimo Pellegrini @* Copyright @copyright{} 2006 Alex Queiroz @* +Copyright @copyright{} 2006 William Uther @* All rights reserved Licensed to the public under the terms of the GNU FDL (>= 1.1). See the file COPYING for details @@ -2862,9 +2863,9 @@ @heading Finding a workspace However, some monotone commands do require a workspace and will fail if no @file{_MTN} directory can be found. -The @command{checkout} and @command{setup} commands create a @i{new -workspace} and initialize a new @file{_MTN/options} file based on their -current option settings. +The @command{checkout}, @command{clone} and @command{setup} commands +create a @i{new workspace} and initialize a new @file{_MTN/options} +file based on their current option settings. @page @@ -3296,7 +3297,7 @@ @section Reserved Certs @item tag This cert's value is a symbolic name given to a revision, which may be used as a way of selecting the revision by name for later commands like address@hidden and @command{diff}. address@hidden, @command{log} or @command{diff}. @item testresult This cert's value is interpreted as a boolean string, either @code{0} @@ -4135,6 +4136,16 @@ @section Tree @emph{must} provide a @var{branchname}; monotone will attempt to infer @var{id} as the unique head of @var{branchname} if it exists. address@hidden mtn clone address@hidden @var{address} @var{directory} + +The clone command is a helper command that performs the roles of a +number of other commands all at once. Firstly, it constructs a new +database. It then populates this database by @command{pull}ing any data +in the branch @var{branchname} from the remote database, @var{address}. +Finally, it copies the files out of the newly created database into a +local directory, just as @command{checkout} would. The created +database is placed in the new workspace as @address@hidden/_MTN/mtn.db}. + @item mtn disapprove @var{id} This command records a disapproval of the changes between @var{id}'s