/usr/share/doc/monotone/html/File-Attributes.html is in monotone-doc 1.0-3.
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 | <html lang="en">
<head>
<title>File Attributes - monotone documentation</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="monotone documentation">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Advanced-Uses.html#Advanced-Uses" title="Advanced Uses">
<link rel="prev" href="Naming-Conventions.html#Naming-Conventions" title="Naming Conventions">
<link rel="next" href="Migrating-and-Dumping.html#Migrating-and-Dumping" title="Migrating and Dumping">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
<link rel="stylesheet" type="text/css" href="texinfo.css">
</head>
<body>
<div class="node">
<a name="File-Attributes"></a>
<p>
Next: <a rel="next" accesskey="n" href="Migrating-and-Dumping.html#Migrating-and-Dumping">Migrating and Dumping</a>,
Previous: <a rel="previous" accesskey="p" href="Naming-Conventions.html#Naming-Conventions">Naming Conventions</a>,
Up: <a rel="up" accesskey="u" href="Advanced-Uses.html#Advanced-Uses">Advanced Uses</a>
<hr>
</div>
<h3 class="section">3.14 File Attributes</h3>
<p>Monotone contains a support for storing <dfn>persistent attributes</dfn> on
files and directories, generally known as <dfn>attrs</dfn> for short. An
attr associates a simple name/value pair with a file or directory, and
is stored in the manifest. Attrs are first-class versioned data; they
can be changed in a workspace, and those changes will be saved when
the workspace is committed. The merger knows how to intelligently
merge attrs.
<p>The attribute mechanism was originally motivated by the fact that some
people like to store executable programs in version control systems,
and would like the programs to remain executable when they check out a
workspace. For example, the <samp><span class="command">configure</span></samp> shell script commonly
shipped with many programs should be executable. Similarly, some
people would like to store devices, symbolic links, read-only files,
and all manner of extra attributes of a file, not directly related to
a file's data content.
<p>Monotone comes with support for some attrs built-in; for instance, if
an executable file is given to <samp><span class="command">mtn add</span></samp>, then it will
automatically mark the new file with a <code>mtn:execute</code> attr, and
when the file is checked out later, the executable bit will be set
automatically. (Of course, if it is checked out on Windows, which
does not support the executable bit, then the executable bit will not
be set. However, monotone will still know that the attr is set, and
Windows users can view and modify the attr like anyone else.)
<p>Attrs in the current workspace can be seen and modified using the
<samp><span class="command"><a href="mtn-attr.html#mtn-attr">mtn attr</a></span></samp> command. Attrs can also be found by examining any
manifest directly.
<p>You can tell monotone to automatically take actions based on these
attributes by defining hooks; see <a href="attr_005ffunctions.html#attr_005ffunctions">attr_functions</a>. Every time
your workspace is written to, monotone will run the corresponding
hooks registered for each attr in your workspace. This way, you can
extend the vocabulary of attrs understood by monotone simply by
writing new hooks.
<p>You can make up your own attrs for anything you find useful; the
mechanism is fully general. (If you make up some particularly useful
ones, we may even be interested in adding support to monotone proper.)
We only ask that if you do use custom attrs, you use some prefix for
them besides <code>mtn:</code>; attrs beginning with <code>mtn:</code> are
reserved for monotone's own use.
</body></html>
|