Re: [PATCH] Documentation: Clarify which paths git-clean will affect

Junio C Hamano wrote:

Thomas Rast [off-list ref] writes:

quoted

-If any optional `<path>...` arguments are given, only those paths
-are affected.
+If any optional `<path>...` arguments are given, those paths are
+affected.  Otherwise, the cleaning starts at the current directory.

With or without path limiters, clean does not look outside the current
directory; I think the "otherwise" makes things worse than the original.

I'd suggest not touching this paragraph at all, but instead say something
like this at the beginning:

quoted

-This allows cleaning the working tree by removing files that are not

    Cleans the working tree by recursively removing files that are not
    under version control, starting from the current directory.

Indeed, yours is better.

-- 
Thomas Rast
trast@{inf,student}.ethz.ch