Clarify documentation of fast-import's D subcommand
The 'D' subcommand within a commit can also delete a directory recursively. This wasn't clear in the prior version of the documentation, leading to a question on the mailing list. Signed-off-by: Shawn O. Pearce <spearce@spearce.org>
Shawn O. Pearce committed
Jul 9, 2007 at 21:27 UTC
512e44b24501df0b4b231cc7f999f9646d96617b
1 file changed
+5
-3
Documentation/git-fast-import.txt
+5
-3
@@ -481,8 +481,9 @@ It is recommended that `<path>` always be encoded using UTF-8.
481
482
`filedelete`
483
^^^^^^^^^^^^
484
-Included in a `commit` command to remove a file from the branch.
485
-If the file removal makes its directory empty, the directory will
484
+Included in a `commit` command to remove a file or recursively
485
+delete an entire directory from the branch. If the file or directory
486
+removal makes its parent directory empty, the parent directory will
487
be automatically removed too. This cascades up the tree until the
488
first non-empty directory or the root is reached.
489
@@ -490,7 +491,8 @@ first non-empty directory or the root is reached.
491
'D' SP <path> LF
492
....
493
493
-here `<path>` is the complete path of the file to be removed.
494
+here `<path>` is the complete path of the file or subdirectory to
495
+be removed from the branch.
496
See `filemodify` above for a detailed description of `<path>`.
497
498
`filedeleteall`