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 http://www.svnbook.com/ for stable versions of this book.
svn commit (ci) — Send changes from your working copy to the repository.
svn commit [PATH...]
Send changes from your working copy to the repository.
If you do not supply a log message with your commit by
using either the --file
(-F
) or --message
(-m
) option,
svn will launch your editor for you
to compose a commit message. See the
editor-cmd
list entry in the section called “General configuration”.
svn commit will send any lock
tokens that it finds and will release locks on all
PATH
s committed (recursively)
unless --no-unlock
is passed.
Tip | |
---|---|
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. |
Commit a simple modification to a file with the
commit message on the command line and an implicit
target of your current directory
(“.
”):
$ svn commit -m "added howto section." Sending a Transmitting file data . Committed revision 3.
Commit a modification to the file
foo.c
(explicitly specified on the
command line) with the commit message in a file named
msg
:
$ svn commit -F msg foo.c Sending foo.c Transmitting file data . Committed revision 5.
If you want to use a file that's under version control
for your commit message with --file
(-F
), you need to pass the
--force-log
option:
$ 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.
To commit a file scheduled for deletion:
$ svn commit -m "removed file 'c'." Deleting c Committed revision 7.