From: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date: Sun, 31 Oct 2010 17:25:20 GMT
Subject: Re: [RFC/PATCH 0/2] Documentation: kicking the "reset --hard" habit
Message-ID: <AANLkTiknyZBeWY8Z14EF+uq_2feJxJniVBwpwjUHgdEF@mail.gmail.com>
In-Reply-To: <vpqzktwv3yx.fsf@bauges.imag.fr>

On Sat, Oct 30, 2010 at 01:55, Matthieu Moy
<Matthieu.Moy@grenoble-inp.fr> wrote:

>> Sadly, at least the user manual change suggested below is probably
>> not suitable, since reset --keep and --merge have not been around
>> since git 1.5.3 days.  Ideas for working around that and other
>> comments would be welcome.
>
> Do we really want to keep the user manual compatible with 1.5.3
> forever? It's nice to keep the user manual usable by slightly outdated
> Gits, but 1.5.3 starts being really old, and older docs are still
> available on the web (like
> http://www.kernel.org/pub/software/scm/git/docs/v1.5.3.8/git.html ).

I didn't know we even did this with our user manual. When I read
manuals for version X (e.g. PostgreSQL, Emacs or libc versions) I
fully expect the features described to only work on the documented
version unless otherwise noted.