{"thread":{"id":"48536","subject":"why does \"man git-clean\" not mention files ignored by core.excludesFile?","startedAt":"2018-05-21T16:26:27Z","lastAt":"2018-05-22T02:50:06Z","messageCount":2,"participants":["Robert P. J. Day","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"348216","messageId":"alpine.LFD.2.21.1805211221180.18665@localhost.localdomain","threadId":"48536","inReplyTo":null,"subject":"why does \"man git-clean\" not mention files ignored by core.excludesFile?","fromName":"Robert P. J. Day","fromEmail":"rpjday@crashcourse.ca","sentAt":"2018-05-21T16:24:43Z","receivedAt":"2018-05-21T16:26:27Z","isPatch":false,"sender":{"key":"rpjday@crashcourse.ca","avatar":"https://avatars.githubusercontent.com/u/226084077?v=4"},"body":"\n  sort of related to my previous post, but in \"man git-clean\", one\nreads:\n\n  -e <pattern>, --exclude=<pattern>\n     In addition to those found in .gitignore (per directory)\n     and $GIT_DIR/info/exclude, also consider these patterns to\n     be in the set of the ignore rules in effect.\n\n  -x\n     Don’t use the standard ignore rules read from .gitignore\n     (per directory) and $GIT_DIR/info/exclude, but do still use\n     the ignore rules given with -e options. This allows\n     removing all untracked files, including build products.\n     This can be used (possibly in conjunction with git reset)\n     to create a pristine working directory to test a clean\n     build.\n\n  why is there no mention of files ignored via a user's\ncore.excludesFile configuration? those sections seem sufficiently\ncomprehensive to list all of the other ways to ignore files, is there\na reason that that config setting is not mentioned?\n\nrday"},{"id":"348281","messageId":"xmqq603gz9nq.fsf@gitster-ct.c.googlers.com","threadId":"48536","inReplyTo":"alpine.LFD.2.21.1805211221180.18665@localhost.localdomain","subject":"Re: why does \"man git-clean\" not mention files ignored by core.excludesFile?","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2018-05-22T02:50:01Z","receivedAt":"2018-05-22T02:50:06Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"\"Robert P. J. Day\" <rpjday@crashcourse.ca> writes:\n\n>   why is there no mention of files ignored via a user's\n> core.excludesFile configuration?\n\nIIUC, core.excludesFile is a much much later invention made long\nafter everybody lost interest in updating \"git clean\", let alone its\ndocumentation.  The support for the configuration variable was added\nto the internal API used to access exclude mechanism, so \"clean\",\ntogether with other users of the same API, got it for free when it\nwas added, and nobody bothered to update the documentation of\n\"clean\".\n\nIn other words, a short answer is because you haven't made it to\nmention it ;-).\n\n"}]}