From: Matthieu Moy Date: Tue, 27 Sep 2011 16:53:25 GMT Subject: Re: [PATCH v2] Docs: git checkout --orphan: `root commit' and `branch head' Message-ID: In-Reply-To: Michael Witten writes: > I think that the last paragraph provides enough context to understand > its usefulness. The last paragraph tells the user how to commit something different from what is already here, which is pretty much the opposite. IOW, I see two uses for --orphan: 1) Publish the same tree without its history 2) Start a different project, but for some reason you wanted it to leave in the same repository and you didn't want a "git init". The next paragraph documents 2), but your removed paragraph was documenting 1). Reading the new version, it feels like the user is encourraged to modify the index, while it's just an option. -- Matthieu Moy http://www-verimag.imag.fr/~moy/