From: Peter Shenkin <shenkin@gmail.com>
Date: Sat, 01 Oct 2011 05:51:12 GMT
Subject: Re: [PATCH] Clarify that '--tags' fetches tags only
Message-ID: <loom.20111001T074143-595@post.gmane.org>
In-Reply-To: <7vwrcpoozk.fsf@alter.siamese.dyndns.org>

Junio C Hamano <gitster <at> pobox.com> writes:
> I think in general our documentation aims to spell out _all_ that happens,
...
 
> I am wondering if there is a systemic failure...
> ,,,If so are there things that we could
> do better without going through individual description?


Yes, I would say that there is one obvious 
systemic failure. 

Nowhere is it documented (as far as I am aware) that
this is the  way the git documentation should be read.

Since, in this regard, it differs from most software
documentation, it ought itself to be documented,
perhaps on the top-level git man page.

-P.