]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-mv.txt
Update the git-ls-tree documentation
[thirdparty/git.git] / Documentation / git-mv.txt
CommitLineData
1114b26e
JW
1git-mv(1)
2=========
3
4NAME
5----
6git-mv - Script used to move or rename a file, directory or symlink.
7
8
9SYNOPSIS
10--------
b933e818
JW
11 'git-mv' [-f] [-n] <source> <destination>
12 'git-mv' [-f] [-n] [-k] <source> ... <destination directory>
1114b26e
JW
13
14DESCRIPTION
15-----------
16This script is used to move or rename a file, directory or symlink.
17In the first form, it renames <source>, which must exist and be either
b933e818 18a file, symlink or directory, to <destination>.
1114b26e
JW
19In the second form, the last argument has to be an existing
20directory; the given sources will be moved into this directory.
21
22The index is updated after successful completion, but the change must still be
23committed.
24
25OPTIONS
26-------
27-f::
b933e818 28 Force renaming or moving of a file even if the target exists
1114b26e
JW
29-k::
30 Skip move or rename actions which would lead to an error
31 condition. An error happens when a source is neither existing nor
32 controlled by GIT, or when it would overwrite an existing
33 file unless '-f' is given.
34-n::
35 Do nothing; only show what would happen
36
37
38Author
39------
40Written by Linus Torvalds <torvalds@osdl.org>
41Rewritten by Ryan Anderson <ryan@michonline.com>
42Move functionality added by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>
43
44Documentation
45--------------
46Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
47
48GIT
49---
50Part of the gitlink:git[7] suite
51