git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [RFC/PATCH 0/2] Documentation: kicking the "reset --hard" habit

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
Oct 31, 2010, 17:25 UTC
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:

Show 10 quoted lines
>> 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.

Previous: Drew NorthupNext: J. Bruce Fields
Message 9 of 10 in “Documentation: kicking the "reset --hard" habit”
  1. 0/2 Documentation: kicking the "reset --hard" habitJonathan Nieder, Oct 29, 2010
  2. 1/2 Documentation: suggest "reset --merge" more oftenJonathan Nieder, Oct 29, 2010
  3. Stephen BoydNov 3, 2010
  4. 2/2 Documentation: suggest "reset --keep" more oftenJonathan Nieder, Oct 29, 2010
  5. Matthieu MoyOct 30, 2010
  6. Junio C HamanoOct 31, 2010
  7. Matthieu MoyOct 31, 2010
  8. Oldest Currently Distributed Git {Re: [RFC/PATCH 0/2] Documentation: kicking the "reset --hard" habit}Drew Northup, Nov 5, 2010
  9. Ævar Arnfjörð BjarmasonOct 31, 2010
  10. J. Bruce FieldsNov 1, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.