1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
\r
4 <article lang="en" id="git-mv(1)">
\r
6 <title>git-mv(1)</title>
\r
8 <primary>git-mv(1)</primary>
\r
11 <simplesect id="_name">
\r
13 <simpara>git-mv - Move or rename a file, a directory, or a symlink</simpara>
\r
15 <simplesect id="_synopsis">
\r
16 <title>SYNOPSIS</title>
\r
17 <simpara><emphasis>git mv</emphasis> <options>… <args>…</simpara>
\r
19 <simplesect id="_description">
\r
20 <title>DESCRIPTION</title>
\r
21 <simpara>This script is used to move or rename a file, directory or symlink.</simpara>
\r
22 <literallayout class="monospaced">git mv [-f] [-n] <source> <destination>
\r
23 git mv [-f] [-n] [-k] <source> ... <destination directory></literallayout>
\r
24 <simpara>In the first form, it renames <source>, which must exist and be either
\r
25 a file, symlink or directory, to <destination>.
\r
26 In the second form, the last argument has to be an existing
\r
27 directory; the given sources will be moved into this directory.</simpara>
\r
28 <simpara>The index is updated after successful completion, but the change must still be
\r
29 committed.</simpara>
\r
31 <simplesect id="_options">
\r
32 <title>OPTIONS</title>
\r
40 Force renaming or moving of a file even if the target exists
\r
50 Skip move or rename actions which would lead to an error
\r
51 condition. An error happens when a source is neither existing nor
\r
52 controlled by GIT, or when it would overwrite an existing
\r
53 file unless <emphasis>-f</emphasis> is given.
\r
66 Do nothing; only show what would happen
\r
72 <simplesect id="_author">
\r
73 <title>Author</title>
\r
74 <simpara>Written by Linus Torvalds <<ulink url="mailto:torvalds@osdl.org">torvalds@osdl.org</ulink>>
\r
75 Rewritten by Ryan Anderson <<ulink url="mailto:ryan@michonline.com">ryan@michonline.com</ulink>>
\r
76 Move functionality added by Josef Weidendorfer <<ulink url="mailto:Josef.Weidendorfer@gmx.de">Josef.Weidendorfer@gmx.de</ulink>></simpara>
\r
78 <simplesect id="_documentation">
\r
79 <title>Documentation</title>
\r
80 <simpara>Documentation by David Greaves, Junio C Hamano and the git-list <<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>>.</simpara>
\r
82 <simplesect id="_git">
\r
84 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>
\r