/usr/share/doc/monotone/html/Review.html is in monotone-doc 1.1-9.
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 163 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.1, 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.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.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; 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="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> [<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">
<dd><a name="mtn-approve"></a></dd>
<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 (see <a href="Selectors.html#Selectors">Selectors</a>).
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>’s ancestor and <var>child</var>. <var>parent</var> and <var>child</var>
are revision ids (see <a href="Selectors.html#Selectors">Selectors</a>). 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>’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 “would have looked like” 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’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> (a revision id; see <a href="Selectors.html#Selectors">Selectors</a>) 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> (a revision id; see <a href="Selectors.html#Selectors">Selectors</a>), so that
symbolic name can later be used in selectors 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> [<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>
|