<?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>svn propget (pget, pg)</title> <link rel="stylesheet" type="text/css" href="styles.css" /> <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /> <style type="text/css"> body { background-image: url('images/draft.png'); background-repeat: no-repeat; background-position: top left; /* The following properties make the watermark "fixed" on the page. */ /* I think that's just a bit too distracting for the reader... */ /* background-attachment: fixed; */ /* background-position: center center; */ }</style> <link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" /> <link rel="up" href="svn.ref.svn.html" title="svn Reference—Subversion Command-Line Client" /> <link rel="prev" href="svn.ref.svn.c.propedit.html" title="svn propedit (pedit, pe)" /> <link rel="next" href="svn.ref.svn.c.proplist.html" title="svn proplist (plist, pl)" /> </head> <body> <div xmlns="" id="vcws-version-notice"> <p>This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a> for stable versions of this book.</p> </div> <div class="navheader"> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">svn propget (pget, pg)</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.c.propedit.html">Prev</a> </td> <th width="60%" align="center">svn Reference—Subversion Command-Line Client</th> <td width="20%" align="right"> <a accesskey="n" href="svn.ref.svn.c.proplist.html">Next</a></td> </tr> </table> <hr /> </div> <div class="refentry"> <a id="svn.ref.svn.c.propget"></a> <div class="titlepage"></div> <a id="idm12505" class="indexterm"></a> <div class="refnamediv"> <h2>Name</h2> <p>svn propget (pget, pg) — Print the value of a property.</p> </div> <div class="refsynopsisdiv"> <h2>Synopsis</h2> <p> <code class="literal">svn propget PROPNAME [TARGET[@REV]...]</code> </p> <p> <code class="literal">svn propget PROPNAME --revprop -r REV [URL]</code> </p> </div> <div class="refsect1"> <a id="idm12517"></a> <h2>Description</h2> <p>Print the value of a property on files, directories, or revisions. The first form prints the versioned property of an item or items in your working copy, and the second prints unversioned remote properties on a repository revision. See <a class="xref" href="svn.advanced.props.html" title="Properties">the section called “Properties”</a> for more information on properties.</p> </div> <div class="refsect1"> <a id="idm12521"></a> <h2>Options</h2> <div class="informalexample"> <pre class="screen"> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.changelist"><code class="option">--changelist</code> (<code class="option">--cl</code>) <em class="replaceable"><code>ARG</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.depth"><code class="option">--depth</code> <em class="replaceable"><code>ARG</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.recursive"><code class="option">--recursive</code> (<code class="option">-R</code>)</a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.revision"><code class="option">--revision</code> (<code class="option">-r</code>) <em class="replaceable"><code>REV</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.revprop"><code class="option">--revprop</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.show_inherited_props"><code class="option">--show-inherited-props</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.strict"><code class="option">--strict</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.verbose"><code class="option">--verbose</code> (<code class="option">-v</code>)</a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.xml"><code class="option">--xml</code></a> </pre> </div> </div> <div class="refsect1"> <a id="idm12534"></a> <h2>Examples</h2> <p>Examine a property of a file in your working copy:</p> <div class="informalexample"> <pre class="screen"> $ svn propget svn:keywords foo.c Author Date Rev </pre> </div> <p>The same goes for a revision property:</p> <div class="informalexample"> <pre class="screen"> $ svn propget svn:log --revprop -r 20 Began journal. </pre> </div> <p>For a more structured display of properties, use the <code class="option">--verbose</code> (<code class="option">-v</code>) option:</p> <div class="informalexample"> <pre class="screen"> $ svn propget svn:keywords foo.c --verbose Properties on 'foo.c': svn:keywords Author Date Rev </pre> </div> <p>Examine the versioned properties inherited by a URL in your repository using the <code class="option">--show-inherited-props </code> option:</p> <div class="informalexample"> <pre class="screen"> $ svn pg svn:global-ignores --verbose --show-inherited-props ^/branches/1.x Inherited properties on 'http://svn.example.com/repos/branches/1.x', from 'http://svn.example.com/repos': svn:global-ignores *.diff *.patch </pre> </div> <p>By default, <span class="command"><strong>svn propget</strong></span> will append a trailing end-of-line sequence to the property value it prints. Most of the time, this is a desirable feature that has a positive effect on the printed output. But there are times when you might wish to capture the precise property value, perhaps because that value is not textual in nature, but of some binary format (such as a JPEG thumbnail stored as a property value, for example). To disable pretty-printing of property values, use the <code class="option">--strict</code> option.</p> <p>Lastly, you can get <span class="command"><strong>svn propget</strong></span> output in XML format with the <code class="option">--xml</code> option:</p> <div class="informalexample"> <pre class="screen"> $ svn propget --xml svn:ignore . <?xml version="1.0"?> <properties> <target path=""> <property name="svn:ignore">*.o </property> </target> </properties> </pre> </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.svn.c.propedit.html">Prev</a> </td> <td width="20%" align="center"> <a accesskey="u" href="svn.ref.svn.html">Up</a> </td> <td width="40%" align="right"> <a accesskey="n" href="svn.ref.svn.c.proplist.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">svn propedit (pedit, pe) </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> svn proplist (plist, pl)</td> </tr> </table> </div> <div xmlns="" id="vcws-footer"> <hr /> <img src="images/cc-by.png" style="float: right;" /> <p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.8), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.</p> <p>This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.</p> <p>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>