<?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.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.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">
<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">
<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">
<a id="svn.ref.svnlook.sw"></a>
<p class="title">
<strong>svnlook Options</strong>
</p>
<dl class="variablelist">
<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_cmd"></a>
<span class="term"><code class="option">--diff-cmd</code> <em class="replaceable"><code>CMD</code></em></span>
</dt>
<dd>
<p>Specifies an external program to use to show differences
between files. When <span class="command"><strong>svnlook diff</strong></span> is invoked
without this option, it uses Subversion's internal differencing
engine, which provides unified diffs by default. If you want to
use an external differencing program, use
<code class="option">--diff-cmd</code>. You can then pass options to the
specified program using the <code class="option">--extensions</code>
(<code class="option">-x</code>) option.</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 class="variablelist">
<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.ignore_properties"></a>
<span class="term">
<code class="option">--ignore-properties</code>
</span>
</dt>
<dd>
<p>Instructs <span class="command"><strong>svnlook diff</strong></span> to suppress
output of property changes.</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.properties_only"></a>
<span class="term">
<code class="option">--properties-only</code>
</span>
</dt>
<dd>
<p>Instructs <span class="command"><strong>svnlook diff</strong></span> to show only property
changes.</p>
</dd>
<dt>
<a id="svn.ref.svnlook.sw.revision"></a>
<span class="term"><code class="option">--revision</code> (<code class="option">-r</code>) <em class="replaceable"><code>REV</code></em></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>) <em class="replaceable"><code>ID</code></em></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>Prints output in XML format.</p>
</dd>
</dl>
</div>
<div class="toc">
<p>
<strong>Table of Contents</strong>
</p>
<dl class="toc">
<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>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
31498a559ceee64333612647bef4b546
>
files
>
190
