From: Matthieu Moy Date: Tue, 27 Sep 2011 16:01:31 GMT Subject: Re: [PATCH v2] Docs: git checkout --orphan: `root commit' and `branch head' Message-ID: In-Reply-To: <69d6fb3199bc4f74b25dae7992a9f132-mfwitten@gmail.com> Michael Witten writes: > -This can be useful when you want to publish the tree from a commit > -without exposing its full history. You might want to do this to publish > -an open source branch of a project whose current tree is "clean", but > -whose full history contains proprietary or otherwise encumbered bits of > -code. This part used to be just this in v1: -This can be useful when you want to publish the tree from a commit -without exposing its full history. You might want to do this to publish +This can be useful when you want to publish a tree without exposing its +full history; for instance, you might want to do this to publish an open source branch of a project whose current tree is "clean", but whose full history contains proprietary or otherwise encumbered bits of code. is it intentionnal that you discarded completely the paragraph? If so, then I disagree, the paragraph was one of the main motivation for someone to use --orphan, without it, someone may understand _what_ it does, but not _why_ it is useful. -- Matthieu Moy http://www-verimag.imag.fr/~moy/