<?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 commit (ci)</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.svn.html" title="svn Reference—Subversion Command-Line Client" /> <link rel="prev" href="svn.ref.svn.c.cleanup.html" title="svn cleanup" /> <link rel="next" href="svn.ref.svn.c.copy.html" title="svn copy (cp)" /> </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 commit (ci)</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="svn.ref.svn.c.cleanup.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.copy.html">Next</a></td> </tr> </table> <hr /> </div> <div class="refentry" title="svn commit (ci)"> <a id="svn.ref.svn.c.commit"></a> <div class="titlepage"></div> <a id="idp20165856" class="indexterm"></a> <div class="refnamediv"> <h2>Name</h2> <p>svn commit (ci) — Send changes from your working copy to the repository.</p> </div> <div class="refsynopsisdiv" title="Synopsis"> <h2>Synopsis</h2> <p> <code class="literal">svn commit [PATH...]</code> </p> </div> <div class="refsect1" title="Description"> <a id="idp20170512"></a> <h2>Description</h2> <p>Send changes from your working copy to the repository. If you do not supply a log message with your commit by using either the <code class="option">--file</code> (<code class="option">-F</code>) or <code class="option">--message</code> (<code class="option">-m</code>) option, <span class="command"><strong>svn</strong></span> will launch your editor for you to compose a commit message. See the <code class="literal">editor-cmd</code> list entry in <a class="xref" href="svn.advanced.confarea.html#svn.advanced.confarea.opts.config" title="General configuration">the section called “General configuration”</a>.</p> <p><span class="command"><strong>svn commit</strong></span> will send any lock tokens that it finds and will release locks on all <em class="replaceable"><code>PATH</code></em>s committed (recursively) unless <code class="option">--no-unlock</code> is passed.</p> <div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Tip"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Tip]" src="images/tip.png" /> </td> <th align="left">Tip</th> </tr> <tr> <td align="left" valign="top"> <p>If you begin a commit and Subversion launches your editor to compose the commit message, you can still abort without committing your changes. If you want to cancel your commit, just quit your editor without saving your commit message and Subversion will prompt you to either abort the commit, continue with no message, or edit the message again.</p> </td> </tr> </table> </div> </div> <div class="refsect1" title="Options"> <a id="idp20179296"></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.editor_cmd"><code class="option">--editor-cmd</code> <em class="replaceable"><code>CMD</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.encoding"><code class="option">--encoding</code> <em class="replaceable"><code>ENC</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.file"><code class="option">--file</code> (<code class="option">-F</code>) <em class="replaceable"><code>FILENAME</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.force_log"><code class="option">--force-log</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.keep_changelists"><code class="option">--keep-changelists</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.message"><code class="option">--message</code> (<code class="option">-m</code>) <em class="replaceable"><code>MESSAGE</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.no_unlock"><code class="option">--no-unlock</code></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.quiet"><code class="option">--quiet</code> (<code class="option">-q</code>)</a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.targets"><code class="option">--targets</code> <em class="replaceable"><code>FILENAME</code></em></a> <a class="xref" href="svn.ref.svn.html#svn.ref.svn.sw.with_revprop"><code class="option">--with-revprop</code> <em class="replaceable"><code>ARG</code></em></a> </pre> </div> </div> <div class="refsect1" title="Examples"> <a id="idp20190016"></a> <h2>Examples</h2> <p>Commit a simple modification to a file with the commit message on the command line and an implicit target of your current directory (<span class="quote">“<span class="quote"><code class="filename">.</code></span>”</span>):</p> <div class="informalexample"> <pre class="screen"> $ svn commit -m "added howto section." Sending a Transmitting file data . Committed revision 3. </pre> </div> <p>Commit a modification to the file <code class="filename">foo.c</code> (explicitly specified on the command line) with the commit message in a file named <code class="filename">msg</code>:</p> <div class="informalexample"> <pre class="screen"> $ svn commit -F msg foo.c Sending foo.c Transmitting file data . Committed revision 5. </pre> </div> <p>If you want to use a file that's under version control for your commit message with <code class="option">--file</code> (<code class="option">-F</code>), you need to pass the <code class="option">--force-log</code> option:</p> <div class="informalexample"> <pre class="screen"> $ svn commit -F file_under_vc.txt foo.c svn: E205004: Log message file is a versioned file; use '--force-log' to override $ svn commit --force-log -F file_under_vc.txt foo.c Sending foo.c Transmitting file data . Committed revision 6. </pre> </div> <p>To commit a file scheduled for deletion:</p> <div class="informalexample"> <pre class="screen"> $ svn commit -m "removed file 'c'." Deleting c Committed revision 7. </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.cleanup.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.copy.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">svn cleanup </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> svn copy (cp)</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>