Suggestion for Git docummntation Book, Chapter "7.7 Git Tools - Reset Demystified"

Suggestion for Git docummntation Book, Chapter "7.7 Git Tools - Reset Demystified"

[Peter Hunkeler]

Hi,

I appreciate all the work that has been done to give us Git users good
documentation.

As a rather-newbie I have to lookup the commands I need for rarely used,
specific tasks. <git reset ...> being one of them. If find chapter "7.7
Git Tools - Reset Demystified" very helpful. There is however one point
that newbies might not (yet) clearly understand: The git reset does
*not* do anything to new, untracked files that might exist in the
working tree. To cleanup, the advice from various places on the internet
is to issue a "git clean -f -d" after the reset.

Maybe it would be helpful if said chapter had a short discussion about
non tracked files, how to clean with "git clean -f -d"

Thanks
Peter

Re: Suggestion for Git docummntation Book, Chapter "7.7 Git Tools - Reset Demystified"

[Jeff King]

On Thu, Jan 18, 2024 at 07:42:52PM +0100, Peter Hunkeler wrote:

> I appreciate all the work that has been done to give us Git users good
> documentation.
> 
> As a rather-newbie I have to lookup the commands I need for rarely used,
> specific tasks. <git reset ...> being one of them. If find chapter "7.7
> Git Tools - Reset Demystified" very helpful. There is however one point
> that newbies might not (yet) clearly understand: The git reset does
> *not* do anything to new, untracked files that might exist in the
> working tree. To cleanup, the advice from various places on the internet
> is to issue a "git clean -f -d" after the reset.
> 
> Maybe it would be helpful if said chapter had a short discussion about
> non tracked files, how to clean with "git clean -f -d"

I don't think the folks who work on the book content tend to hang out on
the development mailing list. You might get more response opening an
issue in their GitHub repo:

  https://github.com/progit/progit2

-Peff