Documentation / git-mv.txton commit stash doc: add a warning about using create (2be4351)
   1git-mv(1)
   2=========
   3
   4NAME
   5----
   6git-mv - Move or rename a file, a directory, or a symlink
   7
   8
   9SYNOPSIS
  10--------
  11[verse]
  12'git mv' <options>... <args>...
  13
  14DESCRIPTION
  15-----------
  16This script is used to move or rename a file, directory or symlink.
  17
  18 git mv [-v] [-f] [-n] [-k] <source> <destination>
  19 git mv [-v] [-f] [-n] [-k] <source> ... <destination directory>
  20
  21In the first form, it renames <source>, which must exist and be either
  22a file, symlink or directory, to <destination>.
  23In the second form, the last argument has to be an existing
  24directory; the given sources will be moved into this directory.
  25
  26The index is updated after successful completion, but the change must still be
  27committed.
  28
  29OPTIONS
  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-v::
  44--verbose::
  45        Report the names of files as they are moved.
  46
  47GIT
  48---
  49Part of the linkgit:git[1] suite