Merge branch 'maint' into ef/ipv4-connect-error-report
[git] / Documentation / git-mv.txt
1 git-mv(1)
2 =========
3
4 NAME
5 ----
6 git-mv - Move or rename a file, a directory, or a symlink
7
8
9 SYNOPSIS
10 --------
11 [verse]
12 'git mv' <options>... <args>...
13
14 DESCRIPTION
15 -----------
16 This script is used to move or rename a file, directory or symlink.
17
18  git mv [-f] [-n] <source> <destination>
19  git mv [-f] [-n] [-k] <source> ... <destination directory>
20
21 In the first form, it renames <source>, which must exist and be either
22 a file, symlink or directory, to <destination>.
23 In the second form, the last argument has to be an existing
24 directory; the given sources will be moved into this directory.
25
26 The index is updated after successful completion, but the change must still be
27 committed.
28
29 OPTIONS
30 -------
31 -f::
32 --force::
33         Force renaming or moving of a file even if the target exists
34 -k::
35         Skip move or rename actions which would lead to an error
36         condition. An error happens when a source is neither existing nor
37         controlled by GIT, or when it would overwrite an existing
38         file unless '-f' is given.
39 -n::
40 --dry-run::
41         Do nothing; only show what would happen
42
43 GIT
44 ---
45 Part of the linkgit:git[1] suite