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

Re: [PATCH 2/2] Documentation: git-clean: make description more readable

From
Stephen Boyd <bebarino@gmail.com>
Date
Apr 26, 2009, 08:04 UTC
Message-ID
<49F41580.3080004@gmail.com>
In-Reply-To
<200904251923.46448.wjl@icecavern.net>
Wesley J. Landaker wrote:
Show 5 quoted lines
> The main reason I took that out in my patch was because I think the second 
> sentence more says the same thing, except more clearly, and the exact 
> semantics of "files unknown to git" versus "ignored files", etc seem to not have 
> good definitions anyway, so I left that for the second paragraph that talks 
> about how '-x' changes things.
If you want to keep it, maybe change it to be more active. Something like:
    Cleans the working tree by removing files that are not under version
control.
> So I might edit yours to say:
>
> Specifying the '-x' option will also remove ignored files. This is useful to 
> remove, for example, generated files that are normally ignored.

The "for example" just comes sticking out again. Could you put it at the beginning of the sentence?

Show 5 quoted lines
> I left the part about '-x' there mostly because it was already in there, so I 
> figured someone at some point thought it was special enough. I didn't want to 
> undo any good decisions that had already been made. =) That said, both -x and 
> -X are somewhat special because they change the behavior a LOT compared to, 
> say, -d.
So maybe -X should be described as well?
Previous: Wesley J. LandakerNext: Junio C Hamano
Message 6 of 8 in “Documentation: git-clean: description updates”
  1. 0/2 Documentation: git-clean: description updatesWesley J. Landaker, Apr 25, 2009
  2. 1/2 Documentation: git-clean: fix minor grammatical errorsWesley J. Landaker, Apr 25, 2009
  3. 2/2 Documentation: git-clean: make description more readableWesley J. Landaker, Apr 25, 2009
  4. Stephen BoydApr 25, 2009
  5. Wesley J. LandakerApr 26, 2009
  6. Stephen BoydApr 26, 2009
  7. Junio C HamanoApr 26, 2009
  8. Wesley J. LandakerApr 26, 2009

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.