<?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>svnlook Reference—Subversion Repository Examination</title> <link rel="stylesheet" type="text/css" href="styles.css" /> <meta name="generator" content="DocBook XSL Stylesheets V1.76.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.html" title="Part II. Subversion Command Reference" /> <link rel="prev" href="svn.ref.svnadmin.c.verify.html" title="svnadmin verify" /> <link rel="next" href="svn.ref.svnlook.c.author.html" title="svnlook author" /> </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">svnlook Reference—Subversion Repository Examination</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.verify.html">Prev</a> </td> <th width="60%" align="center">Part II. Subversion Command Reference</th> <td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.author.html">Next</a></td> </tr> </table> <hr /> </div> <div class="reference" title="svnlook Reference—Subversion Repository Examination"> <div class="titlepage"> <div> <div> <h1 class="title"><a id="svn.ref.svnlook"></a>svnlook Reference—Subversion Repository Examination</h1> </div> </div> <hr /> </div> <div class="partintro" title="svnlook Reference—Subversion Repository Examination"> <div></div> <p><span class="command"><strong>svnlook</strong></span> is a command-line utility for examining different aspects of a Subversion repository. It does not make any changes to the repository—it's just used for <span class="quote">“<span class="quote">peeking.</span>”</span> <span class="command"><strong>svnlook</strong></span> is typically used by the repository hooks, but a repository administrator might find it useful for diagnostic purposes.</p> <p>Since <span class="command"><strong>svnlook</strong></span> works via direct repository access (and thus can be used only on the machine that holds the repository), it refers to the repository with a path, not a URL.</p> <p>If no revision or transaction is specified, <span class="command"><strong>svnlook</strong></span> defaults to the youngest (most recent) revision of the repository.</p> <p>Options in <span class="command"><strong>svnlook</strong></span> are global, just as they are in <span class="command"><strong>svn</strong></span> and <span class="command"><strong>svnadmin</strong></span>; however, most options apply to only one subcommand since the functionality of <span class="command"><strong>svnlook</strong></span> is (intentionally) limited in scope:</p> <div class="variablelist" title="svnlook Options"> <a id="svn.ref.svnlook.sw"></a> <p class="title"> <strong>svnlook Options</strong> </p> <dl> <dt> <a id="svn.ref.svnlook.sw.copy_info"></a> <span class="term"> <code class="option">--copy-info</code> </span> </dt> <dd> <p>Causes <span class="command"><strong>svnlook changed</strong></span> to show detailed copy source information.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.diff_copy_from"></a> <span class="term"> <code class="option">--diff-copy-from</code> </span> </dt> <dd> <p>Print differences for copied items against the copy source.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.extensions"></a> <span class="term"><code class="option">--extensions</code> (<code class="option">-x</code>) <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Specifies customizations which Subversion should make when performing difference calculations. Valid extensions include:</p> <div class="variablelist"> <dl> <dt> <span class="term"><code class="option">--ignore-space-change</code> (<code class="option">-b</code>)</span> </dt> <dd> <p>Ignore changes in the amount of white space.</p> </dd> <dt> <span class="term"><code class="option">--ignore-all-space</code> (<code class="option">-w</code>)</span> </dt> <dd> <p>Ignore all white space.</p> </dd> <dt> <span class="term"> <code class="option">--ignore-eol-style</code> </span> </dt> <dd> <p>Ignore changes in EOL (end-of-line) style.</p> </dd> <dt> <span class="term"><code class="option">--show-c-function</code> (<code class="option">-p</code>)</span> </dt> <dd> <p>Show C function names in the diff output.</p> </dd> <dt> <span class="term"><code class="option">--unified</code> (<code class="option">-u</code>)</span> </dt> <dd> <p>Show three lines of unified diff context.</p> </dd> </dl> </div> <p>The default value is <code class="literal">-u</code>.</p> <p>Note that when Subversion is configured to invoke an external diff command, the value of the <code class="option">--extension</code> (<code class="option">-x</code>) option isn't restricted to the previously mentioned options, but may be <span class="emphasis"><em>any</em></span> additional arguments which Subversion should pass to that command. If you wish to pass multiple arguments, you must enclose all of them in quotes.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.full_paths"></a> <span class="term"> <code class="option">--full-paths</code> </span> </dt> <dd> <p>Causes <span class="command"><strong>svnlook tree</strong></span> to display full paths instead of hierarchical, indented path components.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.limit"></a> <span class="term"><code class="option">--limit</code> (<code class="option">-l</code>) <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Limit output to a maximum number of <em class="replaceable"><code>ARG</code></em> items.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.no_diff_deleted"></a> <span class="term"> <code class="option">--no-diff-deleted</code> </span> </dt> <dd> <p>Prevents <span class="command"><strong>svnlook diff</strong></span> from printing differences for deleted files. The default behavior when a file is deleted in a transaction/revision is to print the same differences that you would see if you had left the file but removed all the content.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.no_diff_added"></a> <span class="term"> <code class="option">--no-diff-added</code> </span> </dt> <dd> <p>Prevents <span class="command"><strong>svnlook diff</strong></span> from printing differences for added files. The default behavior when you add a file is to print the same differences that you would see if you had added the entire contents of an existing (empty) file.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.non_recursive"></a> <span class="term"><code class="option">--non-recursive</code> (<code class="option">-N</code>)</span> </dt> <dd> <p>Operate on a single directory only.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.revision"></a> <span class="term"><code class="option">--revision</code> (<code class="option">-r</code>)</span> </dt> <dd> <p>Specifies a particular revision number that you wish to examine.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.revprop"></a> <span class="term"> <code class="option">--revprop</code> </span> </dt> <dd> <p>Operates on a revision property instead of a property specific to a file or directory. This option requires that you also pass a revision with the <code class="option">--revision</code> (<code class="option">-r</code>) option.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.show_inherited_props"></a> <span class="term"> <code class="option">--show-inherited-props</code> </span> </dt> <dd> <p>Works with <span class="command"><strong>svnlook propget</strong></span> and <span class="command"><strong>svnlook proplist</strong></span> to display the versioned properties inherited by a path.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.transaction"></a> <span class="term"><code class="option">--transaction</code> (<code class="option">-t</code>)</span> </dt> <dd> <p>Specifies a particular transaction ID that you wish to examine.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.show_ids"></a> <span class="term"> <code class="option">--show-ids</code> </span> </dt> <dd> <p>Shows the filesystem node revision IDs for each path in the filesystem tree.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.verbose"></a> <span class="term"><code class="option">--verbose</code> (<code class="option">-v</code>)</span> </dt> <dd> <p>Be verbose. When used with <span class="command"><strong>svnlook proplist</strong></span>, for example, this causes Subversion to display not just the list of properties, but their values also.</p> </dd> <dt> <a id="svn.ref.svnlook.sw.xml"></a> <span class="term"> <code class="option">--xml</code> </span> </dt> <dd> <p></p> </dd> </dl> </div> <div class="toc"> <p> <strong>Table of Contents</strong> </p> <dl> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.author.html">svnlook author</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.cat.html">svnlook cat</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.changed.html">svnlook changed</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.date.html">svnlook date</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.diff.html">svnlook diff</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.dirs-changed.html">svnlook dirs-changed</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.filesize.html">svnlook filesize</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.help.html">svnlook help (h, ?)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.history.html">svnlook history</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.info.html">svnlook info</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.lock.html">svnlook lock</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.log.html">svnlook log</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.propget.html">svnlook propget (pget, pg)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.proplist.html">svnlook proplist (plist, pl)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.tree.html">svnlook tree</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.uuid.html">svnlook uuid</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svnlook.c.youngest.html">svnlook youngest</a> </span> <span class="refpurpose"></span> </dt> </dl> </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.svnadmin.c.verify.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.svnlook.c.author.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">svnadmin verify </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> svnlook author</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>