e2b0d90c1e100041f98efe2300d9c13622d6451a
[git.git] / man1 / git-mv.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-MV" 1 "" "" ""
21 .SH NAME
22 git-mv \- Script used to move or rename a file, directory or symlink.
23 .SH "SYNOPSIS"
24
25
26 git\-mv <options>... <args>...
27
28 .SH "DESCRIPTION"
29
30
31 This script is used to move or rename a file, directory or symlink\&.
32
33 .nf
34 git\-mv [\-f] [\-n] <source> <destination>
35 git\-mv [\-f] [\-n] [\-k] <source> \&.\&.\&. <destination directory>
36 .fi
37
38
39 In the first form, it renames <source>, which must exist and be either a file, symlink or directory, to <destination>\&. In the second form, the last argument has to be an existing directory; the given sources will be moved into this directory\&.
40
41
42 The index is updated after successful completion, but the change must still be committed\&.
43
44 .SH "OPTIONS"
45
46 .TP
47 \-f
48 Force renaming or moving of a file even if the target exists
49
50 .TP
51 \-k
52 Skip move or rename actions which would lead to an error condition\&. An error happens when a source is neither existing nor controlled by GIT, or when it would overwrite an existing file unless \-f is given\&.
53
54 .TP
55 \-n
56 Do nothing; only show what would happen
57
58 .SH "AUTHOR"
59
60
61 Written by Linus Torvalds <torvalds@osdl\&.org> Rewritten by Ryan Anderson <ryan@michonline\&.com> Move functionality added by Josef Weidendorfer <Josef\&.Weidendorfer@gmx\&.de>
62
63 .SH "DOCUMENTATION"
64
65
66 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
67
68 .SH "GIT"
69
70
71 Part of the \fBgit\fR(7) suite
72