From: Shawn O. Pearce Date: Tue, 10 Jul 2007 01:27:55 +0000 (-0400) Subject: Clarify documentation of fast-import's D subcommand X-Git-Tag: v1.5.2.4~3 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=512e44b24501df0b4b231cc7f999f9646d96617b;p=git.git 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 --- diff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt index 8d06775a6..87e70fe12 100644 --- a/Documentation/git-fast-import.txt +++ b/Documentation/git-fast-import.txt @@ -481,8 +481,9 @@ It is recommended that `` always be encoded using UTF-8. `filedelete` ^^^^^^^^^^^^ -Included in a `commit` command to remove a file from the branch. -If the file removal makes its directory empty, the directory will +Included in a `commit` command to remove a file or recursively +delete an entire directory from the branch. If the file or directory +removal makes its parent directory empty, the parent directory will be automatically removed too. This cascades up the tree until the first non-empty directory or the root is reached. @@ -490,7 +491,8 @@ first non-empty directory or the root is reached. 'D' SP LF .... -here `` is the complete path of the file to be removed. +here `` is the complete path of the file or subdirectory to +be removed from the branch. See `filemodify` above for a detailed description of ``. `filedeleteall`