/usr/share/doc/monotone/html/Starting-a-New-Project.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>monotone documentation: Starting a New Project</title>

<meta name="description" content="monotone documentation: Starting a New Project">
<meta name="keywords" content="monotone documentation: Starting a New Project">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="General-Index.html#General-Index" rel="index" title="General Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Tutorial.html#Tutorial" rel="up" title="Tutorial">
<link href="Adding-Files.html#Adding-Files" rel="next" title="Adding Files">
<link href="Generating-Keys.html#Generating-Keys" rel="prev" title="Generating Keys">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="texinfo.css">


</head>

<body lang="en">
<a name="Starting-a-New-Project"></a>
<div class="header">
<p>
Next: <a href="Adding-Files.html#Adding-Files" accesskey="n" rel="next">Adding Files</a>, Previous: <a href="Generating-Keys.html#Generating-Keys" accesskey="p" rel="prev">Generating Keys</a>, Up: <a href="Tutorial.html#Tutorial" accesskey="u" rel="up">Tutorial</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="General-Index.html#General-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Starting-a-New-Project-1"></a>
<h3 class="section">2.5 Starting a New Project</h3>

<p>Before he can begin work on the project, Jim needs to create a
<i>workspace</i> &mdash; a directory whose contents monotone will keep track
of.  Often, one works on projects that someone else has started, and
creates workspaces with the <code>checkout</code> command, which you&rsquo;ll
learn about later.  Jim is starting a new project, though, so he does
something a little bit different.  He uses the <code>mtn setup</code>
command to create a new workspace.
</p>
<p>This command creates the named directory (if it doesn&rsquo;t already exist),
and creates the <samp>_MTN</samp> directory within it.  The <samp>_MTN</samp> directory
is how monotone recognizes that a directory is a workspace, and
monotone stores some bookkeeping files within it.  For instance, command
line values for the <samp>--db</samp>, <samp>--branch</samp> or <samp>--key</samp>
options to the <code>setup</code> command will be cached in a file called
<samp>_MTN/options</samp>, so you don&rsquo;t have to keep passing them to monotone
all the time.
</p>
<p>He chooses <code>jp.co.juicebot.jb7</code> as a branch name. (See
<a href="Naming-Conventions.html#Naming-Conventions">Naming Conventions</a> for more information about appropriate branch
names.)  Jim then creates his workspace:
</p>
<div class="smallexample">
<pre class="smallexample">/home/jim$ mtn --db=jim.mtn --branch=jp.co.juicebot.jb7 setup juice
/home/jim$ cd juice
/home/jim/juice$
</pre></div>

<p>Notice that Jim has changed his current directory to his newly created
workspace. For the rest of this example we will assume that everyone
issues all further monotone commands from their workspace
directories.
</p>



</body>
</html>
monotone-doc 1.1-7 / usr / share / doc / monotone / html / Starting-a-New-Project.html
