user-manual: use pithier example commit
[gitweb.git] / Documentation / git-mv.txt
index f2d5882f48759fc463596e5d970e2f19785c5ebc..6756b76bb11bc17279c3f20c16d7b4ba131f5832 100644 (file)
@@ -3,19 +3,22 @@ git-mv(1)
 
 NAME
 ----
-git-mv - Script used to move or rename a file, directory or symlink.
+git-mv - Move or rename a file, a directory, or a symlink
 
 
 SYNOPSIS
 --------
-'git-mv' [-f] [-n] <source> <destination>
-'git-mv' [-f] [-k] [-n] <source> ... <destination directory>
+'git-mv' <options>... <args>...
 
 DESCRIPTION
 -----------
 This script is used to move or rename a file, directory or symlink.
+
+ git-mv [-f] [-n] <source> <destination>
+ git-mv [-f] [-n] [-k] <source> ... <destination directory>
+
 In the first form, it renames <source>, which must exist and be either
-a file, symlink or directory, to <destination>, which must not exist.
+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.
 
@@ -25,7 +28,7 @@ committed.
 OPTIONS
 -------
 -f::
-       Force renaming or moving even targets exist
+       Force renaming or moving of a file even if the target exists
 -k::
         Skip move or rename actions which would lead to an error
        condition. An error happens when a source is neither existing nor