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