<?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" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" 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_dav_svn.conf.html" title="mod_dav_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_dav_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" lang="en" xml:lang="en"><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" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="svn.ref.properties.versioned-props"></a>Versioned Properties</h3></div></div></div><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 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>.</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
multi-line 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="id428056" href="#ftn.id428056" class="footnote">60</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></dl></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="svn.ref.properties.unversioned-props"></a>Unversioned Properties</h3></div></div></div><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,
then the revision was committed anonymously.)</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: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></dl></div></div><div class="footnotes"><br /><hr width="100" align="left" /><div class="footnote"><p><sup>[<a id="ftn.id428056" href="#id428056" class="para">60</a>] </sup>As of this writing, symbolic links
are indeed the only “<span class="quote">special</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_dav_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"><code class="literal">mod_dav_svn</code> 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></body></html>
