/usr/share/doc/monotone/html/GIT-Export-Hooks.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 | <!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: GIT Export Hooks</title>
<meta name="description" content="monotone documentation: GIT Export Hooks">
<meta name="keywords" content="monotone documentation: GIT Export Hooks">
<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="Validation-Hooks.html#Validation-Hooks" rel="next" title="Validation Hooks">
<link href="Attribute-Handling.html#Attribute-Handling" rel="prev" title="Attribute Handling">
<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="GIT-Export-Hooks"></a>
<div class="header">
<p>
Next: <a href="Validation-Hooks.html#Validation-Hooks" accesskey="n" rel="next">Validation Hooks</a>, Previous: <a href="Attribute-Handling.html#Attribute-Handling" accesskey="p" rel="prev">Attribute Handling</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="GIT-Export-Hooks-1"></a>
<h4 class="subsection">6.1.11 GIT Export Hooks</h4>
<p>Exporting monotone revisions in git-fast-import(1) format often
requires translation of monotone author cert values and associated
signing keys into corresponding git author and committer
values. Translation of author and committer values and validation of
the results is controlled by these hooks. See <code><a href="VCS.html#mtn-git_005fexport">mtn git_export</a></code>.
</p>
<dl compact="compact">
<dt><code>unmapped_git_author(<var>author</var>)</code>
<a name="index-unmapped_005fgit_005fauthor_0028author_0029"></a>
</dt>
<dd>
<p>This hook is called for any git author or committer value that does
not come from the current <em>author map</em> file, specified by
<samp>--authors-file</samp>. If no <em>author map</em> file is specified
this hook will be called for <em>every</em> unique git author and
committer value. It may return the value unchanged or modify it in
some way in an effort to ensure that it is valid. The default
implementation attempts several common pattern replacements to produce
valid authors from monotone authors.
</p>
</dd>
<dt><code>validate_git_author(<var>author</var>)</code>
<a name="index-validate_005fgit_005fauthor_0028author_0029"></a>
</dt>
<dd>
<p>This hook is called before the git author or committer value is
written to the export output stream. The <var>author</var> value is either
the mapped value from the current <em>author map</em> file or the value
produced by the <code>unmapped_git_author</code> hook. This hook may return
true if the author is valid or false if it is not. The export will be
aborted if this hook returns false for any value.
</p>
<p>The default definition enforces the <code>Name <email></code> pattern.
</p>
</dd>
</dl>
</body>
</html>
|