[MERGE] Fix reconfiguring standalone tree to lightweight checkout

Ian Clatworthy ian.clatworthy at internode.on.net
Fri Dec 14 07:40:59 GMT 2007


Aaron Bentley wrote:
> Ian Clatworthy wrote:
> 
>> The help for reconfigure needs to be expanded to explain when this
>> particular transformation will work and when it won't.
> 
> I guess I'm a bit lost.  You mean specifically converting from a tree
> into a lightweight checkout?  (But not, say, converting from a branch or
> a checkout?)  Or converting into a lightweight checkout from anything?

I meant anything to a lightweight checkout. On second thoughts, the
current help is probably good enough for now ...

<mini-rant>
Perhaps I'm being overly pedantic but I think we need to do more in our
documentation to differentiate between normal checkouts and lightweight
ones. I always imagined the latter were just a special type of the
former because "normal checkouts" sometimes get referred to as
"heavyweight checkouts". When history horizons arrive, a normal checkout
may well be very shallow (no history pulled down) but it won't be
semantically the same as "lightweight" - local commits will still be
possible.

Unless you disagree, I think we ought to black-ban the term "heavyweight
checkout" as well. We should consciously say either lightweight or
normal, where the latter might be deep (now) or might be shallow (soon).
</mini-rant>

That's a long way of saying that, if you did wish to edit the text, I'd
make the lightweight checkout information a completely separate
paragraph to the normal checkout one.

Ian C.



More information about the bazaar mailing list