/usr/share/doc/monotone/html/Review.html

<!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: Review</title>

<meta name="description" content="monotone documentation: Review">
<meta name="keywords" content="monotone documentation: Review">
<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="Command-Reference.html#Command-Reference" rel="up" title="Command Reference">
<link href="Variables.html#Variables" rel="next" title="Variables">
<link href="Informative.html#Informative" rel="prev" title="Informative">
<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="Review"></a>
<div class="header">
<p>
Next: <a href="Variables.html#Variables" accesskey="n" rel="next">Variables</a>, Previous: <a href="Informative.html#Informative" accesskey="p" rel="prev">Informative</a>, Up: <a href="Command-Reference.html#Command-Reference" accesskey="u" rel="up">Command Reference</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="Review-1"></a>
<h3 class="section">4.6 Review</h3>

<dl compact="compact">
<dt><code>mtn approve <var>rev</var> [--branch=<var>branchname</var>] [--[no-]update]</code>
<a name="index-mtn-approve-rev-_005b_002d_002dbranch_003dbranchname_005d-_005b_002d_002d_005bno_002d_005dupdate_005d"></a>
</dt>
<dd><p>This command puts <var>rev</var> on the branch <var>branchname</var> (defaults
to the workspace branch).
</p>
<p>This command is a synonym for <code>mtn cert <var>rev</var> branch
<var>branchname</var></code>.
</p>
<p>See <a href="Common-Options.html#g_t_002d_002dupdate">--update</a>.
</p>
<a name="mtn-comment"></a></dd>
<dt><code>mtn comment <var>rev</var> [<var>comment</var>]</code>
<a name="index-mtn-comment-rev-_005bcomment_005d"></a>
</dt>
<dd>
<p>This adds a new comment to a committed revision.  If <var>comment</var> is
not provided, it is obtained from the Lua hook
<code><a href="User-Defaults.html#edit_005fcomment">edit_comment</a></code>; the hook is passed an empty string.
</p>
<p>This command is a synonym for <code>mtn cert <var>rev</var> comment
<var>comment</var></code>.
</p>
</dd>
<dt><code>mtn disapprove [--[no-]update] [<var>parent</var>] <var>child</var></code>
<a name="index-mtn-disapprove-_005b_002d_002d_005bno_002d_005dupdate_005d-_005bparent_005d-child"></a>
</dt>
<dd><p>See online help for more options; see <a href="Common-Options.html#Common-Options">Common Options</a>. See <a href="Common-Options.html#g_t_002d_002dupdate">--update</a>.
</p>
<p>This command records a disapproval of the changes between <var>parent</var>&rsquo;s
ancestor and <var>child</var>.  If <var>parent</var> is omitted, only <var>child</var>
is disapproved.  The command does the disapproval by committing
the <i>inverse</i> changes as a new revision descending from <var>child</var>.
</p>
<p>Conceptually, <code>disapprove</code>&rsquo;s contract is that disapprove(A) gives a
revision B such that whenever B is merged with a descendant D of A the merge
will result in what D &ldquo;would have looked like&rdquo; if A had never happened.
</p>
<p>Note that as a consequence of this contract the <code>disapprove</code>
command only works if all changesets from <var>parent</var> to <var>child</var>
have exactly one ancestor (that is, none are the result of a merge),
since it hasn&rsquo;t been worked out how to generate such a descendant in
the multi-ancestor case.
</p>
<a name="mtn-suspend"></a></dd>
<dt><code>mtn suspend [--[no-]update] [--branch <var>branchname</var>] <var>rev</var></code>
<a name="index-mtn-suspend-_005b_002d_002d_005bno_002d_005dupdate_005d-_005b_002d_002dbranch-branchname_005d-rev"></a>
</dt>
<dd><p>See <a href="Common-Options.html#g_t_002d_002dupdate">--update</a>.
</p>
<p>This makes <var>rev</var> invisible as a head of branch <var>branchname</var>
(defaults to the current workspace branch).  Any operation that looks
for heads will not count <var>rev</var>; this includes <code><a href="Informative.html#mtn-list-branches">mtn list branches</a></code> as well as <code><a href="Tree.html#mtn-merge">mtn merge</a></code> etc.
</p>
<p>If <var>rev</var> is not a head, <code>suspend</code> has no effect.
</p>
<p><code>suspend</code> is not inherited; if a new revision is committed as
the child of a <code>suspend</code>ed revision, the new revision will be
visible as a head.
</p>
<p>This command is a synonym for <code>mtn cert <var>rev</var> suspend
<var>branchname</var></code>.
</p>
</dd>
<dt><code>mtn tag <var>rev</var> <var>tagname</var></code>
<a name="index-mtn-tag-rev-tagname"></a>
</dt>
<dd><p>This command associates the symbolic name <var>tagname</var> with the
revision <var>rev</var>, so that symbolic name can later be used in
<a href="Selectors.html#Selectors">Selectors</a> for specifying revisions.
</p>
<p>This command is a synonym for <code>mtn cert <var>rev</var> tag
<var>tagname</var></code>.
</p>
</dd>
<dt><code>mtn testresult <var>rev</var> {pass | fail | true | false | yes | no | 1 | 0}</code>
<a name="index-mtn-testresult-rev-_007bpass-_007c-fail-_007c-true-_007c-false-_007c-yes-_007c-no-_007c-1-_007c-0_007d"></a>
</dt>
<dd><p>This command adds a <samp>testresult</samp> certificate to <var>rev</var>, with
a value of 0 or 1. <samp>pass</samp>, <samp>true</samp>, <samp>yes</samp> give a
value of 1; <samp>fail</samp>, <samp>false</samp>, <samp>no</samp> give a value of
0. See <a href="Quality-Assurance.html#Quality-Assurance">Quality Assurance</a>.
</p>
</dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="Variables.html#Variables" accesskey="n" rel="next">Variables</a>, Previous: <a href="Informative.html#Informative" accesskey="p" rel="prev">Informative</a>, Up: <a href="Command-Reference.html#Command-Reference" accesskey="u" rel="up">Command Reference</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>
monotone-doc 1.0-12 / usr / share / doc / monotone / html / Review.html
