/usr/share/doc/monotone/html/Selector-Expansion.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 | <!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: Selector Expansion</title>
<meta name="description" content="monotone documentation: Selector Expansion">
<meta name="keywords" content="monotone documentation: Selector Expansion">
<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="Hooks.html#Hooks" rel="up" title="Hooks">
<link href="Attribute-Handling.html#Attribute-Handling" rel="next" title="Attribute Handling">
<link href="External-Merge-Tools.html#External-Merge-Tools" rel="prev" title="External Merge Tools">
<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="Selector-Expansion"></a>
<div class="header">
<p>
Next: <a href="Attribute-Handling.html#Attribute-Handling" accesskey="n" rel="next">Attribute Handling</a>, Previous: <a href="External-Merge-Tools.html#External-Merge-Tools" accesskey="p" rel="prev">External Merge Tools</a>, Up: <a href="Hooks.html#Hooks" accesskey="u" rel="up">Hooks</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="Selector-Expansion-1"></a>
<h4 class="subsection">6.1.9 Selector Expansion</h4>
<p>Monotone’s selectors are a powerful mechanism used to refer to revisions
with symbolic names or groupings. Thanks to the hooks described in this
section, it is possible to use various forms of shorthand in selection
strings; these hooks are designed to recognise shorthand patterns and
expand them to their full form.
</p>
<p>For more detail on the use of selectors, see <a href="Selectors.html#Selectors">Selectors</a>.
</p>
<dl compact="compact">
<dd><a name="expand_005fselector"></a></dd>
<dt><code>expand_selector (<var>str</var>)</code>
<a name="index-expand_005fselector-_0028str_0029"></a>
</dt>
<dd>
<p>Called by any command that can take a selector argument, for each
element of a combined selector string (between <code>/</code> separators).
</p>
<p>The input <var>str</var> is the command line argument. The hook should return
a string that is a valid monotone selector.
</p>
<p>Expansion generally means providing a type prefix for the selector,
such as <code>a:</code> for authors or <code>d:</code> for dates.
</p>
<p>The default definition of this hook attempts to recognize certs, email
addresses, branch names, hex ids, and dates, and adds the appropriate
prefix. See <a href="Default-hooks.html#Default-hooks">Default hooks</a>.
</p>
<a name="expand_005fdate"></a></dd>
<dt><code>expand_date (<var>str</var>)</code>
<a name="index-expand_005fdate-_0028str_0029"></a>
</dt>
<dd><p>Called when processing a date selector (<code>d:</code>).
</p>
<p>The input <var>str</var> is the command line selector, after processing by
<code>expand_selector</code>. The hook should return a date that can be
used by a standard SQL select statement.
</p>
<p>The default hook recognizes special words such as <code>yesterday</code> or
<code>6 months ago</code> and converts them into well formed date
expressions. See <a href="Default-hooks.html#Default-hooks">Default hooks</a>.
</p>
</dd>
</dl>
</body>
</html>
|