From: Thomas Rast Date: Thu, 7 Jan 2010 16:42:27 +0000 (+0100) Subject: Documentation: warn prominently against merging with dirty trees X-Git-Tag: v1.7.0-rc0~7^2~14 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=e330d8ca1a9ec38ce40b0f67123b1dd893f0b31c;p=git.git Documentation: warn prominently against merging with dirty trees We do this for both git-merge and git-pull, so as to hopefully alert (over)users of git-pull to the issue. Signed-off-by: Thomas Rast --- diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt index 489658702..3277f4e26 100644 --- a/Documentation/git-merge.txt +++ b/Documentation/git-merge.txt @@ -22,6 +22,10 @@ The second syntax ( `HEAD` ...) is supported for historical reasons. Do not use it from the command line or in new scripts. It is the same as `git merge -m ...`. +*Warning*: Running 'git-merge' with uncommitted changes is +discouraged: while possible, it leaves you in a state that is hard to +back out of in the case of a conflict. + OPTIONS ------- diff --git a/Documentation/git-pull.txt b/Documentation/git-pull.txt index b93201158..b3fa312d7 100644 --- a/Documentation/git-pull.txt +++ b/Documentation/git-pull.txt @@ -24,6 +24,10 @@ when merging local branches into the current branch. Also note that options meant for 'git-pull' itself and underlying 'git-merge' must be given before the options meant for 'git-fetch'. +*Warning*: Running 'git-pull' (actually, the underlying 'git-merge') +with uncommitted changes is discouraged: while possible, it leaves you +in a state that is hard to back out of in the case of a conflict. + OPTIONS -------