This file is indexed.

/usr/share/doc/monotone/html/Reserved-Certs.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
<!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: Reserved Certs</title>

<meta name="description" content="monotone documentation: Reserved Certs">
<meta name="keywords" content="monotone documentation: Reserved Certs">
<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="Advanced-Uses.html#Advanced-Uses" rel="up" title="Advanced Uses">
<link href="Naming-Conventions.html#Naming-Conventions" rel="next" title="Naming Conventions">
<link href="Reserved-Files.html#Reserved-Files" rel="prev" title="Reserved Files">
<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="Reserved-Certs"></a>
<div class="header">
<p>
Next: <a href="Naming-Conventions.html#Naming-Conventions" accesskey="n" rel="next">Naming Conventions</a>, Previous: <a href="Reserved-Files.html#Reserved-Files" accesskey="p" rel="prev">Reserved Files</a>, Up: <a href="Advanced-Uses.html#Advanced-Uses" accesskey="u" rel="up">Advanced Uses</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="Reserved-Certs-1"></a>
<h3 class="section">3.12 Reserved Certs</h3>

<p>Every certificate has a name. Some names have meaning which is built
in to monotone, others may be used for customization by a particular
user, site, or community. If you wish to define custom certificates,
you should prefix such certificate names with <code>x-</code>. For example,
if you want to make a certificate describing the existence of security
vulnerabilities in a revision, you might wish to create a certificate
called <code>x-vulnerability</code>.  Monotone reserves all names which do
not begin with <code>x-</code> for possible internal use. If an <code>x-</code>
certificate becomes widely used, monotone will likely adopt it as a
reserved cert name and standardize its semantics.
</p>
<p>Most reserved certificate names have no meaning yet; some do. Usually
monotone is also responsible for <em>generating</em> many of these certs
as part of normal operation, such as during a <code>commit</code>. Others
will be added explicitly via other commands, like <code>tag</code> or
<code>approve</code>.
</p>
<p>As well as carrying other information, certs (and combinations of certs)
are useful for identifying revisions with <a href="Selectors.html#Selectors">Selectors</a>; in
particular, this is the primary purpose of the <code>tag</code> cert.
</p>
<p>The pre-defined, reserved certificate names are:
</p>
<dl compact="compact">
<dt><code>author</code></dt>
<dd><p>This cert&rsquo;s value is the name of a person who committed the revision
the cert is attached to. The cert is generated when you commit a
revision. It is displayed by the <code>log</code> command.
</p>
</dd>
<dt><code>branch</code></dt>
<dd><p>This cert&rsquo;s value is the name of a branch. A <code>branch</code> cert
associates a revision with a branch. The revision is said to be &ldquo;in
the branch&rdquo; named by the cert. The cert is generated when you commit
a revision, either directly with the <code>commit</code> command or
indirectly with the <code>merge</code> or <code>propagate</code> commands. The
<code>branch</code> certs are read and directly interpreted by <em>many</em>
monotone commands, and play a fundamental role in organizing work in
any monotone database.
</p>
</dd>
<dt><code>changelog</code></dt>
<dd><p>This cert&rsquo;s value is the change log message you provide when you
commit a revision. It is displayed by the <code>log</code> command.
</p>
</dd>
<dt><code>comment</code></dt>
<dd><p>This cert&rsquo;s value is an additional comment, usually provided after
committing, about a revision. Certs with the name <code>comment</code> will be
shown together with <code>changelog</code> certs by the <code>log</code> command.
</p>
</dd>
<dt><code>date</code></dt>
<dd><p>This cert&rsquo;s value is an ISO date string indicating the time at which a
revision was committed. It is displayed by the <code>log</code> command, and
may be used as an additional heuristic or selection criterion in other
commands in the future.
</p>
</dd>
<dt><code>suspend</code></dt>
<dd><p>This cert&rsquo;s value is the name of a branch (see the <code>branch</code> cert).
This cert is generated by the <code>suspend</code> command.  A suspended
revision is removed from the list of head revisions of a branch in most
cases.  A branch with all its heads suspended will not appear in the
list of branches.  Suspended revisions can still have children, and those
children are in no way affected by the suspend cert on their parent.
</p>
</dd>
<dt><code>tag</code></dt>
<dd><p>This cert&rsquo;s value is a symbolic name given to a revision, which may be
used as a way of selecting the revision by name for later commands like
<code>checkout</code>, <code>log</code> or <code>diff</code>.
</p>
</dd>
<dt><code>testresult</code></dt>
<dd><p>This cert&rsquo;s value is interpreted as a boolean string, either <code>0</code>
or <code>1</code>. It is generated by the <code>testresult</code> command and
represents the results of running a particular test on the underlying
revision. Typically you will make a separate signing key for each test
you intend to run on revisions. This cert influences the
<code>update</code> algorithm.
</p>
</dd>
</dl>

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