]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-mv.txt
Add git-mv
[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--------
11'git-mv' [-f] [-n] <source> <destination>
12'git-mv' [-f] [-k] [-n] <source> ... <destination directory>
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
18a file, symlink or directory, to <destination>, which must not exist.
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::
28 Force renaming or moving even targets exist
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