<?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 Reference—Subversion Command-Line Client</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.html" title="Part II. Subversion Command Reference" /> <link rel="next" href="svn.ref.svn.c.add.html" title="svn add" /> </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 Reference—Subversion Command-Line Client</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="svn.ref.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.svn.c.add.html">Next</a></td> </tr> </table> <hr /> </div> <div class="reference" title="svn Reference—Subversion Command-Line Client"> <div class="titlepage"> <div> <div> <h1 class="title"><a id="svn.ref.svn"></a>svn Reference—Subversion Command-Line Client</h1> </div> </div> <hr /> </div> <div class="partintro" title="svn Reference—Subversion Command-Line Client"> <div></div> <p><span class="command"><strong>svn</strong></span> is the official command-line client of Subversion. Its functionality is offered via a collection of task-specific subcommands, most of which accept a number of options for fine-grained control of the program's behavior.</p> <p>When using the <span class="command"><strong>svn</strong></span> program, subcommands and other non-option arguments must appear in a specified order on the command line. Options, on the other hand, may appear anywhere on the command line (after the program name, of course), and in general, their order is irrelevant. For example, all of the following are valid ways to use <span class="command"><strong>svn status</strong></span>, and are interpreted in exactly the same way:</p> <div class="informalexample"> <pre class="screen"> $ svn -vq status myfile $ svn status -v -q myfile $ svn -q status -v myfile $ svn status -vq myfile $ svn status myfile -qv </pre> </div> <p>The following sections describe each of the various subcommands and options provided by the <span class="command"><strong>svn</strong></span> command-line client program, including some examples of each subcommand's typical uses.</p> <p>While Subversion has different options for its subcommands, all options exist in a single namespace—that is, each option is guaranteed to mean the roughly same thing regardless of the subcommand you use it with. For example, <code class="option">--verbose</code> (<code class="option">-v</code>) always means <span class="quote">“<span class="quote">verbose output,</span>”</span> regardless of the subcommand you use it with.</p> <p>The <span class="command"><strong>svn</strong></span> command-line client usually exits quickly with an error if you pass it an option which does not apply to the specified subcommand. But as of Subversion 1.5, several of the options which apply to all—or nearly all—of the subcommands have been deemed acceptable by all subcommands, even if they have no effect on some of them. (This change was made primarily to improve the client's ability to called from custom wrapping scripts.) These options appear grouped together in the command-line client's usage messages as global options, as can be seen in the following bit of output:</p> <div class="informalexample"> <pre class="screen"> $ svn help upgrade upgrade: Upgrade the metadata storage format for a working copy. usage: upgrade [WCPATH...] Local modifications are preserved. Valid options: -q [--quiet] : print nothing, or only summary information Global options: --username ARG : specify a username ARG --password ARG : specify a password ARG --no-auth-cache : do not cache authentication tokens --non-interactive : do no interactive prompting --trust-server-cert : accept SSL server certificates from unknown certificate authorities without prompting (but only with '--non-interactive') --config-dir ARG : read user configuration files from directory ARG --config-option ARG : set user configuration option in the format: FILE:SECTION:OPTION=[VALUE] For example: servers:global:http-library=serf $ </pre> </div> <p><span class="command"><strong>svn</strong></span> subcommands recognize the following options:</p> <div class="variablelist" title="svn Options"> <a id="svn.ref.svn.sw"></a> <p class="title"> <strong>svn Options</strong> </p> <dl> <dt> <a id="svn.ref.svn.sw.accept"></a> <span class="term"><code class="option">--accept</code> <em class="replaceable"><code>ACTION</code></em></span> </dt> <dd> <p>Specifies an action for automatic conflict resolution, disabling the interactive prompts which ask the user how to handle each conflict as it is noticed. Though which of the specific actions are applicable differs depending on which subcommand is in use, Subversion supports the following long (and short) values for <em class="replaceable"><code>ACTION</code></em>:</p> <div class="variablelist"> <dl> <dt> <span class="term"><code class="literal">postpone</code> (<code class="literal">p</code>)</span> </dt> <dd> <p>Take no resolution action at all and instead allow the conflicts to be recorded for future resolution.</p> </dd> <dt> <span class="term"><code class="literal">edit</code> (<code class="literal">e</code>)</span> </dt> <dd> <p>Open each conflicted file in a text editor for manual resolution of line-based conflicts.</p> </dd> <dt> <span class="term"><code class="literal">launch</code> (<code class="literal">l</code>)</span> </dt> <dd> <p>Launch an interactive merge conflict resolution tool for each conflicted file.</p> </dd> <dt> <span class="term"> <code class="literal">base</code> </span> </dt> <dd> <p>Choose the file that was the (unmodified) <code class="literal">BASE</code> revision before you tried to integrate changes from the server into your working copy.</p> </dd> <dt> <span class="term"> <code class="literal">working</code> </span> </dt> <dd> <p>Assuming that you've manually handled the conflict resolution, choose the version of the file as it currently stands in your working copy.</p> </dd> <dt> <span class="term"><code class="literal">mine-full</code> (<code class="literal">mf</code>)</span> </dt> <dd> <p>Resolve conflicted files by preserving all local modifications and discarding all changes fetched from the server during the operation which caused the conflict.</p> </dd> <dt> <span class="term"><code class="literal">theirs-full</code> (<code class="literal">tf</code>)</span> </dt> <dd> <p>Resolve conflicted files by discarding all local modifications and integrating all changes fetched from the server during the operation which caused the conflict.</p> </dd> <dt> <span class="term"><code class="literal">mine-conflict</code> (<code class="literal">mc</code>)</span> </dt> <dd> <p>Resolve conflicted files by preferring local modifications over the changes fetched from the server in conflicting regions of each file's content.</p> </dd> <dt> <span class="term"><code class="literal">theirs-conflict</code> (<code class="literal">tc</code>)</span> </dt> <dd> <p>Resolve conflicted files by preferring the changes fetched from the server over local modifications in conflicting regions of each file's content.</p> </dd> </dl> </div> <p>Consult the output of <span class="command"><strong>svn help <em class="replaceable"><code>SUBCOMMAND</code></em></strong></span> to see exactly which actions are supported by the specific subcommand of interest.</p> </dd> <dt> <a id="svn.ref.svn.sw.allow_mixed_revisions"></a> <span class="term"> <code class="option">--allow-mixed-revisions</code> </span> </dt> <dd> <p>Disables the verification—performed by default by <span class="command"><strong>svn merge</strong></span> as of Subversion 1.7—that the target of a merge operation and all of its children are at a uniform revision. While merging into a single-revision working copy target is the recommended best practice, this option may be used to permit merges into mixed-revision working copies as necessary.</p> </dd> <dt> <a id="svn.ref.svn.sw.auto_props"></a> <span class="term"> <code class="option">--auto-props</code> </span> </dt> <dd> <p>Enables automatic property assignment (per runtime configuration rules), overriding the <code class="literal">enable-auto-props</code> runtime configuration directive.</p> </dd> <dt> <a id="svn.ref.svn.sw.change"></a> <span class="term"><code class="option">--change</code> (<code class="option">-c</code>) <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Perform the requested operation using a specific <span class="quote">“<span class="quote">change</span>”</span>. Generally speaking, this option is syntactic sugar for <strong class="userinput"><code>-r <em class="replaceable"><code>ARG-1</code></em>:<em class="replaceable"><code>ARG</code></em></code></strong>. Some subcommands permit a comma-separated list of revision number arguments (e.g., <strong class="userinput"><code>-c <em class="replaceable"><code>ARG1</code></em>,<em class="replaceable"><code>ARG2</code></em>,<em class="replaceable"><code>ARG3</code></em></code></strong>). Alternatively, you can provide two arguments separated by a dash (as in <strong class="userinput"><code>-c <em class="replaceable"><code>ARG1</code></em>-<em class="replaceable"><code>ARG2</code></em></code></strong>) to identify the range of revisions between <em class="replaceable"><code>ARG1</code></em> and <em class="replaceable"><code>ARG2</code></em>, inclusive. Finally, if the revision argument is negated, the implied revision range is reversed: <strong class="userinput"><code>-c -45</code></strong> is equivalent to <strong class="userinput"><code>-r 45:44</code></strong>.</p> </dd> <dt> <a id="svn.ref.svn.sw.changelist"></a> <span class="term"><code class="option">--changelist</code> (<code class="option">--cl</code>) <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Instructs Subversion to operate only on members of the changelist named <em class="replaceable"><code>ARG</code></em>. You can use this option multiple times to specify sets of changelists.</p> </dd> <dt> <a id="svn.ref.svn.sw.config_dir"></a> <span class="term"><code class="option">--config-dir</code> <em class="replaceable"><code>DIR</code></em></span> </dt> <dd> <p>Instructs Subversion to read configuration information from the specified directory instead of the default location (<code class="filename">.subversion</code> in the user's home directory).</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.config_option"></a> <span class="term"><code class="option">--config-option</code> <em class="replaceable"><code>CONFSPEC</code></em></span> </dt> <dd> <p>Sets, for the duration of the command, the value of a runtime configuration option. <em class="replaceable"><code>CONFSPEC</code></em> is a string which specifies the configuration option namespace, name and value that you'd like to assign, formatted as <em class="replaceable"><code>FILE</code></em>:<em class="replaceable"><code>SECTION</code></em>:<em class="replaceable"><code>OPTION</code></em>=[<em class="replaceable"><code>VALUE</code></em>]. In this syntax, <em class="replaceable"><code>FILE</code></em> and <em class="replaceable"><code>SECTION</code></em> are the runtime configuration file (either <code class="literal">config</code> or <code class="literal">servers</code>) and the section thereof, respectively, which contain the option whose value you wish to change. <em class="replaceable"><code>OPTION</code></em> is, of course, the option itself, and <em class="replaceable"><code>VALUE</code></em> the value (if any) you wish to assign to the option. For example, to temporarily disable the use of the automatic property setting feature, use <code class="option">--config-option=config:miscellany:enable-auto-props=no</code>. You can use this option multiple times to change multiple option values simultaneously.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.depth"></a> <span class="term"><code class="option">--depth</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Instructs Subversion to limit the scope of an operation to a particular tree depth. <em class="replaceable"><code>ARG</code></em> is one of <code class="literal">empty</code> (only the target itself), <code class="literal">files</code> (the target and any immediate file children thereof), <code class="literal">immediates</code> (the target and any immediate children thereof), or <code class="literal">infinity</code> (the target and all of its descendants—full recursion).</p> </dd> <dt> <a id="svn.ref.svn.sw.diff"></a> <span class="term"> <code class="option">--diff</code> </span> </dt> <dd> <p>Enables a special output mode for <span class="command"><strong>svn log</strong></span> which includes a difference report (a la <span class="command"><strong>svn diff</strong></span>) as part of each revision's information.</p> </dd> <dt> <a id="svn.ref.svn.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>svn 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.svn.sw.diff3_cmd"></a> <span class="term"><code class="option">--diff3-cmd</code> <em class="replaceable"><code>CMD</code></em></span> </dt> <dd> <p>Specifies an external 3-way differencing program (used to merge line-based changes into files).</p> </dd> <dt> <a id="svn.ref.svn.sw.dry_run"></a> <span class="term"> <code class="option">--dry-run</code> </span> </dt> <dd> <p>Goes through all the motions of running a command, but makes no actual changes—either on disk or in the repository.</p> </dd> <dt> <a id="svn.ref.svn.sw.editor_cmd"></a> <span class="term"><code class="option">--editor-cmd</code> <em class="replaceable"><code>CMD</code></em></span> </dt> <dd> <p>Specifies an external program to use to edit a log message or a property value. See the <code class="literal">editor-cmd</code> section in <a class="xref" href="svn.advanced.confarea.html#svn.advanced.confarea.opts.config" title="General configuration">the section called “General configuration”</a> for ways to specify a default editor.</p> </dd> <dt> <a id="svn.ref.svn.sw.encoding"></a> <span class="term"><code class="option">--encoding</code> <em class="replaceable"><code>ENC</code></em></span> </dt> <dd> <p>Tells Subversion that your commit message is composed using the character encoding provided. The default character encoding is derived from your operating system's native locale; use this option if your commit message is composed using any other encoding.</p> </dd> <dt> <a id="svn.ref.svn.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 of <em class="replaceable"><code>ARG</code></em> is <code class="literal">-u</code>. If you wish to pass multiple arguments, you must enclose all of them in quotes.</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.</p> </dd> <dt> <a id="svn.ref.svn.sw.file"></a> <span class="term"><code class="option">--file</code> (<code class="option">-F</code>) <em class="replaceable"><code>FILENAME</code></em></span> </dt> <dd> <p>Uses the contents of the named file for the specified subcommand. Different subcommands do different things with this content. For example, <span class="command"><strong>svn commit</strong></span> uses the content as a commit log message, whereas <span class="command"><strong>svn propset</strong></span> uses it as a property value.</p> </dd> <dt> <a id="svn.ref.svn.sw.force"></a> <span class="term"> <code class="option">--force</code> </span> </dt> <dd> <p>Forces a particular command or operation to run. Subversion will prevent you from performing some operations in normal usage, but you can pass this option to tell Subversion <span class="quote">“<span class="quote">I know what I'm doing as well as the possible repercussions of doing it, so let me at 'em.</span>”</span> This option is the programmatic equivalent of doing your own electrical work with the power on—if you don't know what you're doing, you're likely to get a nasty shock.</p> </dd> <dt> <a id="svn.ref.svn.sw.force_log"></a> <span class="term"> <code class="option">--force-log</code> </span> </dt> <dd> <p>Forces a suspicious parameter passed to the <code class="option">--message</code> (<code class="option">-m</code>) or <code class="option">--file</code> (<code class="option">-F</code>) option to be accepted as valid. By default, Subversion will produce an error if parameters to these options look like they might instead be targets of the subcommand. For example, if you pass a versioned file's path to the <code class="option">--file</code> (<code class="option">-F</code>) option, Subversion will assume you've made a mistake, that the path was instead intended as the target of the operation, and that you simply failed to provide some other—unversioned—file as the source of your log message. To assert your intent and override these types of errors, pass the <code class="option">--force-log</code> option to subcommands that accept log messages.</p> </dd> <dt> <a id="svn.ref.svn.sw.git"></a> <span class="term"> <code class="option">--git</code> </span> </dt> <dd> <p>Enables a special output mode for <span class="command"><strong>svn diff</strong></span> designed for cross-compatibility with the popular Git distributed version control system.</p> </dd> <dt> <a id="svn.ref.svn.sw.help"></a> <span class="term"><code class="option">--help</code> (<code class="option">-h</code>, <code class="option">-?</code>)</span> </dt> <dd> <p>If used with one or more subcommands, shows the built-in help text for each. If used alone, it displays the general client help text.</p> </dd> <dt> <a id="svn.ref.svn.sw.ignore_ancestry"></a> <span class="term"> <code class="option">--ignore-ancestry</code> </span> </dt> <dd> <p>Tells Subversion to ignore ancestry when calculating differences (rely on path contents alone). Also disables <a class="xref" href="svn.branchmerge.basicmerging.html#svn.branchmerge.basicmerging.mergetracking" title="Merge Tracking">Merge Tracking</a> when used with the <span class="command"><strong>svn merge</strong></span> subcommand. </p> </dd> <dt> <a id="svn.ref.svn.sw.ignore_externals"></a> <span class="term"> <code class="option">--ignore-externals</code> </span> </dt> <dd> <p>Tells Subversion to ignore externals definitions and the external working copies managed by them.</p> </dd> <dt> <a id="svn.ref.svn.sw.ignore_keywords"></a> <span class="term"> <code class="option">--ignore-keywords</code> </span> </dt> <dd> <p>Disables keyword expansion.</p> </dd> <dt> <a id="svn.ref.svn.sw.ignore_whitespace"></a> <span class="term"> <code class="option">--ignore-whitespace</code> </span> </dt> <dd> <p>Instructs <span class="command"><strong>svn patch</strong></span> to ignore whitespace when attempting to identify patch context.</p> </dd> <dt> <a id="svn.ref.svn.sw.incremental"></a> <span class="term"> <code class="option">--incremental</code> </span> </dt> <dd> <p>Prints output in a format suitable for concatenation to prior similar output.</p> </dd> <dt> <a id="svn.ref.svn.sw.internal_diff"></a> <span class="term"> <code class="option">--internal-diff</code> </span> </dt> <dd> <p>Instructs Subversion to use its built-in differencing engine despite any external differencing mechanism that may be specified for use in the user's runtime configuration.</p> </dd> <dt> <a id="svn.ref.svn.sw.keep_changelists"></a> <span class="term"> <code class="option">--keep-changelists</code> </span> </dt> <dd> <p>Tells Subversion not to remove the changelist assigments from working copy items after committing.</p> </dd> <dt> <a id="svn.ref.svn.sw.keep_local"></a> <span class="term"> <code class="option">--keep-local</code> </span> </dt> <dd> <p>Keeps the local copy of a file or directory (used with the <span class="command"><strong>svn delete</strong></span> command).</p> </dd> <dt> <a id="svn.ref.svn.sw.limit"></a> <span class="term"><code class="option">--limit</code> (<code class="option">-l</code>) <em class="replaceable"><code>NUM</code></em></span> </dt> <dd> <p>Shows only the first <em class="replaceable"><code>NUM</code></em> log messages.</p> </dd> <dt> <a id="svn.ref.svn.sw.message"></a> <span class="term"><code class="option">--message</code> (<code class="option">-m</code>) <em class="replaceable"><code>MESSAGE</code></em></span> </dt> <dd> <p>Indicates that you will specify either a log message or a lock comment on the command line, following this option. For example:</p> <div class="informalexample"> <pre class="screen"> $ svn commit -m "They don't make Sunday." </pre> </div> </dd> <dt> <a id="svn.ref.svn.sw.native_eol"></a> <span class="term"><code class="option">--native-eol</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Causes <span class="command"><strong>svn export</strong></span> to use a specific end-of-line sequence as if it was the native sequence for the client platform. <em class="replaceable"><code>ARG</code></em> may be one of <code class="literal">CR</code>, <code class="literal">LF</code>, or <code class="literal">CRLF</code>.</p> </dd> <dt> <a id="svn.ref.svn.sw.new"></a> <span class="term"><code class="option">--new</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Uses <em class="replaceable"><code>ARG</code></em> as the newer target (for use with <span class="command"><strong>svn diff</strong></span>).</p> </dd> <dt> <a id="svn.ref.svn.sw.no_auth_cache"></a> <span class="term"> <code class="option">--no-auth-cache</code> </span> </dt> <dd> <p>Prevents caching of authentication information (e.g., username and password) in the Subversion runtime configuration directories.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.no_auto_props"></a> <span class="term"> <code class="option">--no-auto-props</code> </span> </dt> <dd> <p>Disables automatic property setting, overriding the <code class="literal">enable-auto-props</code> runtime configuration directive.</p> </dd> <dt> <a id="svn.ref.svn.sw.no_diff_deleted"></a> <span class="term"> <code class="option">--no-diff-deleted</code> </span> </dt> <dd> <p>Prevents Subversion from printing differences for deleted files. The default behavior when you remove a file is for <span class="command"><strong>svn diff</strong></span> to print the same differences that you would see if you had kept the file but removed all of its content.</p> </dd> <dt> <a id="svn.ref.svn.sw.no_ignore"></a> <span class="term"> <code class="option">--no-ignore</code> </span> </dt> <dd> <p>Shows files in the status listing or adds/imports files that would normally be omitted since they match a pattern in the <code class="literal">global-ignores</code> configuration option or the <code class="literal">svn:ignore</code> or <code class="literal">svn:global-ignores</code>properties. See <a class="xref" href="svn.advanced.confarea.html#svn.advanced.confarea.opts.config" title="General configuration">the section called “General configuration”</a> and <a class="xref" href="svn.advanced.props.special.ignore.html" title="Ignoring Unversioned Items">the section called “Ignoring Unversioned Items”</a> for more information.</p> </dd> <dt> <a id="svn.ref.svn.sw.no_unlock"></a> <span class="term"> <code class="option">--no-unlock</code> </span> </dt> <dd> <p>Tells Subversion not to automatically unlock files. (The default commit behavior is to unlock all files listed as part of the commit.) See <a class="xref" href="svn.advanced.locking.html" title="Locking">the section called “Locking”</a> for more information.</p> </dd> <dt> <a id="svn.ref.svn.sw.non_interactive"></a> <span class="term"> <code class="option">--non-interactive</code> </span> </dt> <dd> <p>Disables all interactive prompting. Some examples of interactive prompting include requests for authentication credentials and conflict resolution decisions. This is useful if you're running Subversion inside an automated script and it's more appropriate to have Subversion fail than to prompt for more information.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.non_recursive"></a> <span class="term"><code class="option">--non-recursive</code> (<code class="option">-N</code>)</span> </dt> <dd> <p><span class="emphasis"><em>Deprecated</em></span>. Stops a subcommand from recursing into subdirectories. Most subcommands recurse by default, but some do not. Users should avoid this option and use the more precise <code class="option">--depth</code> option instead. For most subcommands, specifying <code class="option">--non-recursive</code> produces behavior which is the same as if you'd specified <code class="option">--depth=files</code>, but there are exceptions: non-recursive <span class="command"><strong>svn status</strong></span> operates at the <code class="literal">immediates</code> depth, and the non-recursive forms of <span class="command"><strong>svn revert</strong></span>, <span class="command"><strong>svn add</strong></span>, and <span class="command"><strong>svn commit</strong></span> operate at an <code class="literal">empty</code> depth.</p> </dd> <dt> <a id="svn.ref.svn.sw.notice_ancestry"></a> <span class="term"> <code class="option">--notice-ancestry</code> </span> </dt> <dd> <p>Pays attention to ancestry when calculating differences.</p> </dd> <dt> <a id="svn.ref.svn.sw.old"></a> <span class="term"><code class="option">--old</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Uses <em class="replaceable"><code>ARG</code></em> as the older target (for use with <span class="command"><strong>svn diff</strong></span>).</p> </dd> <dt> <a id="svn.ref.svn.sw.parents"></a> <span class="term"> <code class="option">--parents</code> </span> </dt> <dd> <p>Creates and adds nonexistent or nonversioned parent subdirectories to the working copy or repository as part of an operation. This is useful for automatically creating multiple subdirectories where none currently exist. If performed on a URL, all the directories will be created in a single commit.</p> </dd> <dt> <a id="svn.ref.svn.sw.password"></a> <span class="term"><code class="option">--password</code> <em class="replaceable"><code>PASSWD</code></em></span> </dt> <dd> <p>Specifies the password to use when authenticating against a Subversion server. If not provided, or if incorrect, Subversion will prompt you for this information as needed.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.quiet"></a> <span class="term"><code class="option">--quiet</code> (<code class="option">-q</code>)</span> </dt> <dd> <p>Requests that the client print only essential information while performing an operation.</p> </dd> <dt> <a id="svn.ref.svn.sw.record_only"></a> <span class="term"> <code class="option">--record-only</code> </span> </dt> <dd> <p>Enables a special mode of <span class="command"><strong>svn merge</strong></span> in which the specified merge operation is recorded in the local merge tracking information, but is not actually performed.</p> </dd> <dt> <a id="svn.ref.svn.sw.recursive"></a> <span class="term"><code class="option">--recursive</code> (<code class="option">-R</code>)</span> </dt> <dd> <p>Makes a subcommand recurse into subdirectories. (Most subcommands recurse by default.)</p> </dd> <dt> <a id="svn.ref.svn.sw.reintegrate"></a> <span class="term"> <code class="option">--reintegrate</code> </span> </dt> <dd> <p>Deprecated. Used with the <span class="command"><strong>svn merge</strong></span> subcommand to merge changes from a feature branch back into the feature branch's ancestor branch. Since Subversion 1.8 the <span class="command"><strong>svn merge</strong></span> subcommand automatically detects this scenario and performs the appropriate merge. See <a class="xref" href="svn.branchmerge.basicmerging.html#svn.branchmerge.basicmerging.reintegrate" title="Reintegrating a Branch">the section called “Reintegrating a Branch”</a> for details.</p> </dd> <dt> <a id="svn.ref.svn.sw.relocate"></a> <span class="term"> <code class="option">--relocate</code> </span> </dt> <dd> <p>Deprecated. When used with the <span class="command"><strong>svn switch</strong></span> subcommand, changes the location of the repository that your working copy references. The preferred approach as of Subversion 1.7, however, is to use the <span class="command"><strong>svn relocate</strong></span> subcommand. See <a class="xref" href="svn.ref.svn.c.relocate.html" title="svn relocate">svn relocate</a> for more details and an example.</p> </dd> <dt> <a id="svn.ref.svn.sw.remove"></a> <span class="term"> <code class="option">--remove</code> </span> </dt> <dd> <p>Used with <span class="command"><strong>svn changelist</strong></span> to disassociate—rather than associate (which is the default operation)—the target(s) from a changelist.</p> </dd> <dt> <a id="svn.ref.svn.sw.reverse_diff"></a> <span class="term"> <code class="option">--reverse-diff</code> </span> </dt> <dd> <p>Causes <span class="command"><strong>svn patch</strong></span> to interpret the input patch instructions in reverse—treating added lines as removed ones and vice-versa.</p> </dd> <dt> <a id="svn.ref.svn.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 revision (or range of revisions) on with which to operate. You can provide revision numbers, keywords, or dates (in curly braces) as arguments to the revision option. If you wish to offer a range of revisions, you can provide two revisions separated by a colon. For example:</p> <div class="informalexample"> <pre class="screen"> $ svn log -r 1729 $ svn log -r 1729:HEAD $ svn log -r 1729:1744 $ svn log -r {2001-12-04}:{2002-02-17} $ svn log -r 1729:{2002-02-17} </pre> </div> <p>See <a class="xref" href="svn.tour.revs.specifiers.html#svn.tour.revs.keywords" title="Revision Keywords">the section called “Revision Keywords”</a> for more information.</p> </dd> <dt> <a id="svn.ref.svn.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.svn.sw.set_depth"></a> <span class="term"><code class="option">--set-depth</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Sets the sticky depth on a directory in a working copy to one of <code class="literal">exclude</code>, <code class="literal">empty</code>, <code class="literal">files</code>, <code class="literal">immediates</code>, or <code class="literal">infinity</code>. For detailed coverage of what these mean and how to use this option, see <a class="xref" href="svn.advanced.sparsedirs.html" title="Sparse Directories">the section called “Sparse Directories”</a>.</p> </dd> <dt> <a id="svn.ref.svn.sw.show_copies_as_adds"></a> <span class="term"> <code class="option">--show-copies-as-adds</code> </span> </dt> <dd> <p>Enables a special output mode for <span class="command"><strong>svn diff</strong></span> in which the content difference for a file created via a copy operation appears as it would for a brand new file (with each line therein appearing as an addition to an empty file) rather than as a delta against the original file from which the copy was created.</p> </dd> <dt> <a id="svn.ref.svn.sw.show_inherited_props"></a> <span class="term"> <code class="option">--show-inherited-props</code> </span> </dt> <dd> <p>Causes <span class="command"><strong>svn propget</strong></span> and <span class="command"><strong> svn proplist</strong></span> to display the versioned properties inherited by the target file or directory.</p> </dd> <dt> <a id="svn.ref.svn.sw.show_revs"></a> <span class="term"><code class="option">--show-revs</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>Used to make <span class="command"><strong>svn mergeinfo</strong></span> display certain classes of merge tracking information. <em class="replaceable"><code>ARG</code></em> may be either <code class="literal">merged</code> or <code class="literal">eligible</code>, indicating a desire to see revisions either already merged or eligible for future merge from the specified source URL, respectively.</p> </dd> <dt> <a id="svn.ref.svn.sw.show_updates"></a> <span class="term"><code class="option">--show-updates</code> (<code class="option">-u</code>)</span> </dt> <dd> <p>Causes the client to display information about which files in your working copy are out of date. This doesn't actually update any of your files—it just shows you which files will be updated if you then use <span class="command"><strong>svn update</strong></span>.</p> </dd> <dt> <a id="svn.ref.svn.sw.stop_on_copy"></a> <span class="term"> <code class="option">--stop-on-copy</code> </span> </dt> <dd> <p>Causes a Subversion subcommand that traverses the history of a versioned resource to stop harvesting that historical information when a copy—that is, a location in history where that resource was copied from another location in the repository—is encountered.</p> </dd> <dt> <a id="svn.ref.svn.sw.strict"></a> <span class="term"> <code class="option">--strict</code> </span> </dt> <dd> <p>Causes Subversion to use strict semantics, a notion that is rather vague unless talking about specific subcommands (namely, <span class="command"><strong>svn propget</strong></span>).</p> </dd> <dt> <a id="svn.ref.svn.sw.strip"></a> <span class="term"><code class="option">--strip</code> <em class="replaceable"><code>NUM</code></em></span> </dt> <dd> <p>Used by <span class="command"><strong>svn patch</strong></span> to ignore <em class="replaceable"><code>NUM</code></em> leading path components found on paths specified in the patch input file.</p> </dd> <dt> <a id="svn.ref.svn.sw.summarize"></a> <span class="term"> <code class="option">--summarize</code> </span> </dt> <dd> <p>Display only high-level summary notifications about the operation instead of its detailed output.</p> </dd> <dt> <a id="svn.ref.svn.sw.targets"></a> <span class="term"><code class="option">--targets</code> <em class="replaceable"><code>FILENAME</code></em></span> </dt> <dd> <p>Tells Subversion to read additional target paths for the operation from <em class="replaceable"><code>FILENAME</code></em>. <em class="replaceable"><code>FILENAME</code></em> should contain one path per line, with each path expected to use the same encoding and formatting that it would if you had specified it directly as an argument on the command line.</p> </dd> <dt> <a id="svn.ref.svn.sw.trust_server_cert"></a> <span class="term"> <code class="option">--trust-server-cert</code> </span> </dt> <dd> <p>When used with <code class="option">--non-interactive</code>, instructs Subversion to accept SSL server certificates issued by unknown certificate authorities without first prompting the user. For security's sake, you should use this option only when the integrity of the remote server and the network path between it and your client is known to be trustworthy.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.use_merge_history"></a> <span class="term"><code class="option">--use-merge-history</code> (<code class="option">-g</code>)</span> </dt> <dd> <p>Uses or displays additional information from merge history.</p> </dd> <dt> <a id="svn.ref.svn.sw.username"></a> <span class="term"><code class="option">--username</code> <em class="replaceable"><code>NAME</code></em></span> </dt> <dd> <p>Specifies the username to use when authenticating against a Subversion server. If not provided, or if incorrect, Subversion will prompt you for this information as needed.</p> <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p>This option is accepted by all <span class="command"><strong>svn</strong></span> subcommands.</p> </td> </tr> </table> </div> </dd> <dt> <a id="svn.ref.svn.sw.verbose"></a> <span class="term"><code class="option">--verbose</code> (<code class="option">-v</code>)</span> </dt> <dd> <p>Requests that the client print out as much information as it can while running any subcommand. This may result in Subversion printing out additional fields, detailed information about every file, or additional information regarding its actions.</p> </dd> <dt> <a id="svn.ref.svn.sw.version"></a> <span class="term"> <code class="option">--version</code> </span> </dt> <dd> <p>Prints the client version info. This information includes not only the version number of the client, but also a listing of all repository access modules that the client can use to access a Subversion repository. With <code class="option">--quiet</code> (<code class="option">-q</code>) it prints only the version number in a compact form.</p> </dd> <dt> <a id="svn.ref.svn.sw.with_all_revprops"></a> <span class="term"> <code class="option">--with-all-revprops</code> </span> </dt> <dd> <p>Used with the <code class="option">--xml</code> option to <span class="command"><strong>svn log</strong></span>, instructs Subversion to retrieve and display all revision properties—the standard ones used internally by Subversion as well as any user-defined ones—in the log output.</p> </dd> <dt> <a id="svn.ref.svn.sw.with_no_revprops"></a> <span class="term"> <code class="option">--with-no-revprops</code> </span> </dt> <dd> <p>Used with the <code class="option">--xml</code> option to <span class="command"><strong>svn log</strong></span>, instructs Subversion to omit all revision properties—including the standard log message, author, and revision datestamp—from the log output.</p> </dd> <dt> <a id="svn.ref.svn.sw.with_revprop"></a> <span class="term"><code class="option">--with-revprop</code> <em class="replaceable"><code>ARG</code></em></span> </dt> <dd> <p>When used with any command that writes to the repository, sets the revision property, using the <em class="replaceable"><code>NAME=VALUE</code></em> format, <em class="replaceable"><code>NAME</code></em> to <em class="replaceable"><code>VALUE</code></em>. When used with <span class="command"><strong>svn log</strong></span> in <code class="option">--xml</code> mode, this displays the value of <em class="replaceable"><code>ARG</code></em> in the log output.</p> </dd> <dt> <a id="svn.ref.svn.sw.xml"></a> <span class="term"> <code class="option">--xml</code> </span> </dt> <dd> <p>Prints output in XML format. XML schemas for the output (in RELAX NG format) are maintained in the <code class="filename">subversion/svn/schema/</code> directory of the Subversion source tree.</p> </dd> </dl> </div> <div class="toc"> <p> <strong>Table of Contents</strong> </p> <dl> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.add.html">svn add</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.blame.html">svn blame (praise, annotate, ann)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.cat.html">svn cat</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.changelist.html">svn changelist (cl)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.checkout.html">svn checkout (co)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.cleanup.html">svn cleanup</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.commit.html">svn commit (ci)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.copy.html">svn copy (cp)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.delete.html">svn delete (del, remove, rm)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.diff.html">svn diff (di)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.export.html">svn export</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.help.html">svn help (h, ?)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.import.html">svn import</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.info.html">svn info</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.list.html">svn list (ls)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.lock.html">svn lock</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.log.html">svn log</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.merge.html">svn merge</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.mergeinfo.html">svn mergeinfo</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.mkdir.html">svn mkdir</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.move.html">svn move (mv)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.patch.html">svn patch</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.propdel.html">svn propdel (pdel, pd)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.propedit.html">svn propedit (pedit, pe)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.propget.html">svn propget (pget, pg)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.proplist.html">svn proplist (plist, pl)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.propset.html">svn propset (pset, ps)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.relocate.html">svn relocate</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.resolve.html">svn resolve</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.resolved.html">svn resolved</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.revert.html">svn revert</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.status.html">svn status (stat, st)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.switch.html">svn switch (sw)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.unlock.html">svn unlock</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.update.html">svn update (up)</a> </span> <span class="refpurpose"></span> </dt> <dt> <span class="refentrytitle"> <a href="svn.ref.svn.c.upgrade.html">svn upgrade</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.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.svn.c.add.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">Part II. Subversion Command Reference </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> svn add</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>