Add a quick overview about what is OK and what is not to cover all cases. Signed-off-by: Miklos Vajna <vmiklos@xxxxxxxxxxxxxx> Signed-off-by: Jeff King <peff@xxxxxxxx> --- On Wed, Oct 14, 2009 at 07:04:34PM -0400, Jeff King <peff@xxxxxxxx> wrote: > Maybe it makes sense instead to do a quick overview of what is OK and > what is not (like the list above). Here it is. Documentation/git-add.txt | 18 +++++++++++++++--- 1 files changed, 15 insertions(+), 3 deletions(-) diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt index 45ebf87..1ea074c 100644 --- a/Documentation/git-add.txt +++ b/Documentation/git-add.txt @@ -86,9 +86,21 @@ OPTIONS edit it. After the editor was closed, adjust the hunk headers and apply the patch to the index. + -*NOTE*: Obviously, if you change anything else than the first character -on lines beginning with a space or a minus, the patch will no longer -apply. +The intent of this option is to pick and choose lines of the diff to +apply, or even to munge the lines. So it is safe to: ++ +* remove lines with a "+" (don't stage the addition) +* munge any lines with a "+" (stage modified contents) +* add lines with a "+" (stage an addition) +* convert lines with a " " to "-" (stage removal) +* convert lines with a "-" to " " (don't stage removal) ++ +It is a bad idea to: ++ +* delete "-" lines +* delete " " lines +* add " " or "-" lines +* munge the contents of " " or "-" lines -u:: --update:: -- 1.6.5 -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html