<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Subversion Properties</title>
<link rel="stylesheet" type="text/css" href="styles.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1" />
<link rel="home" href="index.html" title="Version Control with Subversion" />
<link rel="up" href="svn.ref.html" title="Chapter 9. Subversion Complete Reference" />
<link rel="prev" href="svn.ref.mod_authz_svn.conf.html" title="mod_authz_svn Configuration Directives" />
<link rel="next" href="svn.ref.reposhooks.html" title="Repository Hooks" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Subversion Properties</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.mod_authz_svn.conf.html">Prev</a> </td>
<th width="60%" align="center">Chapter 9. Subversion Complete Reference</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" title="Subversion Properties">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="svn.ref.properties"></a>Subversion Properties</h2>
</div>
</div>
</div>
<p>Subversion allows users to invent arbitrarily named
versioned properties on files and directories, as well as
unversioned properties on revisions. The only restriction is on
properties whose names begin with <code class="literal">svn:</code> (those
are reserved for Subversion's own use). While these properties
may be set by users to control Subversion's behavior, users may
not invent new <code class="literal">svn:</code> properties.</p>
<div class="sect2" title="Versioned Properties">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="svn.ref.properties.versioned-props"></a>Versioned Properties</h3>
</div>
</div>
</div>
<p>These are the versioned properties that Subversion reserves
for its own use:</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">
<code class="literal">svn:executable</code>
</span>
</dt>
<dd>
<p>If present on a file, the client will make the
file executable in Unix-hosted working copies. See
<a class="xref" href="svn.advanced.props.file-portability.html#svn.advanced.props.special.executable" title="File Executability">the section called “File Executability”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:mime-type</code>
</span>
</dt>
<dd>
<p>If present on a file, the value indicates the
file's MIME type. This allows the client to decide
whether line-based contextual merging is safe to
perform during updates, and can also affect how the
file behaves when fetched via a web browser. See
<a class="xref" href="svn.advanced.props.file-portability.html#svn.advanced.props.special.mime-type" title="File Content Type">the section called “File Content Type”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:ignore</code>
</span>
</dt>
<dd>
<p>If present on a directory, the value is a list of
<span class="emphasis"><em>unversioned</em></span> file patterns to be ignored
by <span class="command"><strong>svn status</strong></span> and other
subcommands. See
<a class="xref" href="svn.advanced.props.special.ignore.html" title="Ignoring Unversioned Items">the section called “Ignoring Unversioned Items”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:keywords</code>
</span>
</dt>
<dd>
<p>If present on a file, the value tells the client
how to expand particular keywords within the file.
See
<a class="xref" href="svn.advanced.props.special.keywords.html" title="Keyword Substitution">the section called “Keyword Substitution”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:eol-style</code>
</span>
</dt>
<dd>
<p>If present on a file, the value tells the client how
to manipulate the file's line-endings in the working
copy and in exported trees. See <a class="xref" href="svn.advanced.props.file-portability.html#svn.advanced.props.special.eol-style" title="End-of-Line Character Sequences">the section called “End-of-Line Character Sequences”</a> and
<a class="xref" href="svn.ref.svn.c.export.html" title="svn export">svn export</a> earlier in this chapter.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:externals</code>
</span>
</dt>
<dd>
<p>If present on a directory, the value is a multiline
list of other paths and URLs the client should check
out. See
<a class="xref" href="svn.advanced.externals.html" title="Externals Definitions">the section called “Externals Definitions”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:special</code>
</span>
</dt>
<dd>
<p>If present on a file, indicates that the file is not
an ordinary file, but a symbolic link or other special
object.<sup>[<a id="idp20701680" href="#ftn.idp20701680" class="footnote">72</a>]</sup></p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:needs-lock</code>
</span>
</dt>
<dd>
<p>If present on a file, tells the client to make the
file read-only in the working copy, as a reminder that
the file should be locked before editing begins. See
<a class="xref" href="svn.advanced.locking.html#svn.advanced.locking.lock-communication" title="Lock Communication">the section called “Lock Communication”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:mergeinfo</code>
</span>
</dt>
<dd>
<p>Used by Subversion to track merge data. See
<a class="xref" href="svn.branchmerge.basicmerging.html#svn.branchmerge.basicmerging.mergeinfo" title="Mergeinfo and Previews">the section called “Mergeinfo and Previews”</a>
for details, but you should never edit this property
unless you <span class="emphasis"><em>really</em></span> know what you're
doing.</p>
</dd>
</dl>
</div>
</div>
<div class="sect2" title="Unversioned Properties">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="svn.ref.properties.unversioned-props"></a>Unversioned Properties</h3>
</div>
</div>
</div>
<p>These are the unversioned properties that Subversion reserves
for its own use:</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">
<code class="literal">svn:author</code>
</span>
</dt>
<dd>
<p>If present, contains the authenticated username of
the person who created the revision. (If not present,
the revision was committed anonymously.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:autoversioned</code>
</span>
</dt>
<dd>
<p>If present, the revision was created via the
autoversioning feature. See
<a class="xref" href="svn.webdav.autoversioning.html" title="Autoversioning">the section called “Autoversioning”</a>.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:date</code>
</span>
</dt>
<dd>
<p>Contains the UTC time the revision was created, in
ISO 8601 format. The value comes from the
<span class="emphasis"><em>server</em></span> machine's clock, not the
client's.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:log</code>
</span>
</dt>
<dd>
<p>Contains the log message describing the
revision.</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:rdump-lock</code>
</span>
</dt>
<dd>
<p>Used to temporarily enforce mutually exclusive
access to the repository by <span class="command"><strong>svnrdump
load</strong></span>. This property is generally only
observed when such an operation is active—or when
an <span class="command"><strong>svnrdump</strong></span> command failed to cleanly
disconnect from the repository. (This property is only
relevant when it appears on revision 0.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:sync-currently-copying</code>
</span>
</dt>
<dd>
<p>Contains the revision number from the source
repository which is currently being mirrored to this one
by the <span class="command"><strong>svnsync</strong></span> tool. (This property
is only relevant when it appears on revision 0.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:sync-from-uuid</code>
</span>
</dt>
<dd>
<p>Contains the UUID of the repository of which this
repository has been initialized as a mirror by
the <span class="command"><strong>svnsync</strong></span> tool. (This property is
only relevant when it appears on revision 0.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:sync-from-url</code>
</span>
</dt>
<dd>
<p>Contains the URL of the repository directory of
which this repository has been initialized as a mirror
by the <span class="command"><strong>svnsync</strong></span> tool. (This property
is only relevant when it appears on revision 0.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:sync-last-merged-rev</code>
</span>
</dt>
<dd>
<p>Contains the revision of the source repository which
was most recently and successfully mirrored to this one.
(This property is only relevant when it appears on
revision 0.)</p>
</dd>
<dt>
<span class="term">
<code class="literal">svn:sync-lock</code>
</span>
</dt>
<dd>
<p>Used to temporarily enforce mutually exclusive
access to the repository by <span class="command"><strong>svnsync</strong></span>
mirroring operations. This property is generally only
observed when such an operation is active—or when
an <span class="command"><strong>svnsync</strong></span> command failed to cleanly
disconnect from the repository. (This property is
only relevant when it appears on revision 0.)</p>
</dd>
</dl>
</div>
</div>
<div class="footnotes">
<br />
<hr width="100" align="left" />
<div class="footnote">
<p><sup>[<a id="ftn.idp20701680" href="#idp20701680" class="para">72</a>] </sup>As of this writing, symbolic
links are indeed the only <span class="quote">“<span class="quote">special</span>”</span>
objects. But there might be more in future releases of
Subversion.</p>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.mod_authz_svn.conf.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">mod_authz_svn Configuration Directives </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Repository Hooks</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>
distrib
>
Mageia
>
3
>
i586
>
media
>
core-updates
>
by-pkgid
>
1d6e0a3784534d5165fa22faeeca008d
>
files
>
94
