monotone-doc 1.0-12 / usr / share / doc / monotone / html / Tutorial.html

This file is indexed.

/usr/share/doc/monotone/html/Tutorial.html is in monotone-doc 1.0-12.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>monotone documentation: Tutorial</title>

<meta name="description" content="monotone documentation: Tutorial">
<meta name="keywords" content="monotone documentation: Tutorial">
<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="index.html#Top" rel="up" title="Top">
<link href="Creating-a-Database.html#Creating-a-Database" rel="next" title="Creating a Database">
<link href="Branches.html#Branches" rel="prev" title="Branches">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
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" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Tutorial"></a>
<div class="header">
<p>
Next: <a href="Advanced-Uses.html#Advanced-Uses" accesskey="n" rel="next">Advanced Uses</a>, Previous: <a href="Concepts.html#Concepts" accesskey="p" rel="prev">Concepts</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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="Tutorial-1"></a>
<h2 class="chapter">2 Tutorial</h2>

<p>This chapter illustrates the basic uses of monotone by means of an
example, fictional software project.
</p>
<a name="Issues"></a>
<h3 class="section">2.1 Issues</h3>
<p>Before we walk through the tutorial, there are two minor issues to
address: standard options and revision selectors.
</p>
<a name="Standard-Options"></a>
<h4 class="subsection">2.1.1 Standard Options</h4>
<p>Before operating monotone, two important command-line options should
be explained.
</p>
<ul>
<li> Most commands operate on a <i>database</i>, which is selected with
the <samp>--db</samp> option.
</li><li> Many commands operate on a subset of the database, called a
<i>branch</i>, which is selected with the <samp>--branch</samp> option.
</li></ul>

<p>Monotone will cache the settings for these options in your workspace, so
ordinarily once you have checked out a project, you will not need to
specify them again.  We will therefore only mention these arguments in
the first example.
</p>
<a name="Revision-Selectors"></a>
<h4 class="subsection">2.1.2 Revision Selectors</h4>
<p>Many commands require you to supply 40-character <small>SHA1</small> values as
arguments, which identify revisions. These &ldquo;revision IDs&rdquo; are
tedious to type, so monotone permits you to supply &ldquo;revision
selectors&rdquo; rather than complete revision IDs. Selectors are a more
&ldquo;human friendly&rdquo; way of specifying revisions by combining certificate
values into unique identifiers. This &ldquo;selector&rdquo; mechanism can be
used anywhere a revision ID would normally be used. For details on
selector syntax, see <a href="Selectors.html#Selectors">Selectors</a>.
</p>
<p>We are now ready to explore our fictional project.
</p>
<a name="The-Fictional-Project"></a>
<h3 class="section">2.2 The Fictional Project</h3>

<p>Our fictional project involves 3 programmers cooperating to write
firmware for a robot, the JuiceBot 7, which dispenses fruit juice. The
programmers are named Jim, Abe and Beth.
</p>
<ul>
<li> Jim lives in Japan, and owns JuiceBot Inc. You will know when we&rsquo;re talking
about Jim, because everything he does involves the letter &ldquo;j&rdquo;.
</li><li> Abe lives in Australia and writes code related to apple juice. You will
know when we&rsquo;re talking about Abe, because everything he does involves
the letter &ldquo;a&rdquo;.
</li><li> Beth lives in Brazil and writes code related to banana juice. You will
know when we&rsquo;re talking about Beth, because everything she does involves
the letter &ldquo;b&rdquo;.
</li></ul>

<p>In our example the programmers work privately on laptops, and are
usually <em>disconnected</em> from the network. They share no storage
system. Thus when each programmer enters a command, it affects only
his or her own computer, unless otherwise stated.
</p>
<p>In the following, our fictional project team will work through several
version control tasks. Some tasks must be done by each member of our
example team; other tasks involve only one member.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="Creating-a-Database.html#Creating-a-Database" accesskey="1">Creating a Database</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Generating-Keys.html#Generating-Keys" accesskey="2">Generating Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Starting-a-New-Project.html#Starting-a-New-Project" accesskey="3">Starting a New Project</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Adding-Files.html#Adding-Files" accesskey="4">Adding Files</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Committing-Work.html#Committing-Work" accesskey="5">Committing Work</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Basic-Network-Service.html#Basic-Network-Service" accesskey="6">Basic Network Service</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Synchronising-Databases.html#Synchronising-Databases" accesskey="7">Synchronising Databases</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Making-Changes.html#Making-Changes" accesskey="8">Making Changes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Dealing-with-a-Fork.html#Dealing-with-a-Fork" accesskey="9">Dealing with a Fork</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Branching-and-Merging.html#Branching-and-Merging">Branching and Merging</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Network-Service-Revisited.html#Network-Service-Revisited">Network Service Revisited</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>


<hr>
<div class="header">
<p>
Next: <a href="Advanced-Uses.html#Advanced-Uses" accesskey="n" rel="next">Advanced Uses</a>, Previous: <a href="Concepts.html#Concepts" accesskey="p" rel="prev">Concepts</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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>



</body>
</html>

APT Browse - Built by Thomas Orozco.