/usr/share/doc/monotone/html/Tutorial.html is in monotone-doc 1.1-7.
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 6.0, 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.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="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> [<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 “revision IDs” are
tedious to type, so monotone permits you to supply “revision
selectors” rather than complete revision IDs. Selectors are a more
“human friendly” way of specifying revisions by combining certificate
values into unique identifiers. This “selector” 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’re talking
about Jim, because everything he does involves the letter “j”.
</li><li> Abe lives in Australia and writes code related to apple juice. You will
know when we’re talking about Abe, because everything he does involves
the letter “a”.
</li><li> Beth lives in Brazil and writes code related to banana juice. You will
know when we’re talking about Beth, because everything she does involves
the letter “b”.
</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">• <a href="Creating-a-Database.html#Creating-a-Database" accesskey="1">Creating a Database</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Generating-Keys.html#Generating-Keys" accesskey="2">Generating Keys</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Starting-a-New-Project.html#Starting-a-New-Project" accesskey="3">Starting a New Project</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Adding-Files.html#Adding-Files" accesskey="4">Adding Files</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Committing-Work.html#Committing-Work" accesskey="5">Committing Work</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Basic-Network-Service.html#Basic-Network-Service" accesskey="6">Basic Network Service</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Synchronising-Databases.html#Synchronising-Databases" accesskey="7">Synchronising Databases</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Making-Changes.html#Making-Changes" accesskey="8">Making Changes</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Dealing-with-a-Fork.html#Dealing-with-a-Fork" accesskey="9">Dealing with a Fork</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Branching-and-Merging.html#Branching-and-Merging">Branching and Merging</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Network-Service-Revisited.html#Network-Service-Revisited">Network Service Revisited</a>:</td><td> </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> [<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>
|