{"thread":{"id":"55993","subject":"Bug: git-fetch man page does not document --filter","startedAt":"2021-06-23T09:36:57Z","lastAt":"2021-06-23T16:56:38Z","messageCount":2,"participants":["Mike Moreton","Taylor Blau"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"428266","messageId":"DM6PR15MB35943E5232F67765D4FAFFD1BB089@DM6PR15MB3594.namprd15.prod.outlook.com","threadId":"55993","inReplyTo":"DM6PR15MB359467B7277CDA31029A6630BB089@DM6PR15MB3594.namprd15.prod.outlook.com","subject":"Bug: git-fetch man page does not document --filter","fromName":"Mike Moreton","fromEmail":"mmoreton@lifesize.com","sentAt":"2021-06-23T09:36:53Z","receivedAt":"2021-06-23T09:36:57Z","isPatch":false,"sender":{"key":"mmoreton@lifesize.com","avatar":null},"body":"See subject.  Looking at https://git-scm.com/docs/git-fetch\n"},{"id":"428278","messageId":"YNNnwm3xxstHMn1M@nand.local","threadId":"55993","inReplyTo":"DM6PR15MB35943E5232F67765D4FAFFD1BB089@DM6PR15MB3594.namprd15.prod.outlook.com","subject":"Re: Bug: git-fetch man page does not document --filter","fromName":"Taylor Blau","fromEmail":"me@ttaylorr.com","sentAt":"2021-06-23T16:56:34Z","receivedAt":"2021-06-23T16:56:38Z","isPatch":false,"sender":{"key":"me@ttaylorr.com","avatar":"https://avatars.githubusercontent.com/u/301000140?v=4"},"body":"On Wed, Jun 23, 2021 at 09:36:53AM +0000, Mike Moreton wrote:\n> See subject.  Looking at https://git-scm.com/docs/git-fetch\n\nThanks for noticing. It seems like an oversight to me, so I added a\nlittle bit of text in the patch below.\n\n--- >8 ---\n\nSubject: [PATCH] Documentation/git-fetch.txt: add documentation on '--filter'\n\n`git fetch` accepts a `--filter=<spec>` option, but does not document\nit. Make sure that git-fetch(1) mentions that --filter is accepted.\n\nThe documentation itself is just the first and last sentence of what is\nmentioned in git-clone(1), with an additional detail about interacting\nwith non-promisor remotes.\n\nReported-by: Mike Moreton <mmoreton@lifesize.com>\nSigned-off-by: Taylor Blau <me@ttaylorr.com>\n---\n Documentation/fetch-options.txt | 10 ++++++++++\n 1 file changed, 10 insertions(+)\n\ndiff --git a/Documentation/fetch-options.txt b/Documentation/fetch-options.txt\nindex 9e7b4e189c..52755572a9 100644\n--- a/Documentation/fetch-options.txt\n+++ b/Documentation/fetch-options.txt\n@@ -11,6 +11,16 @@\n \tUse an atomic transaction to update local refs. Either all refs are\n \tupdated, or on error, no refs are updated.\n\n+ifndef::git-pull[]\n+--filter=<filter-spec>::\n+\tUse the partial clone feature and request that the server sends\n+\ta subset of reachable objects according to a given object\n+\tfilter. When using a `--filter` while fetching from a\n+\tnon-promisor remote, that remote is registered as a promisor.\n+\tFor more details on filter specifications, see the `--filter`\n+\toption in linkgit:git-rev-list[1].\n+endif::git-pull[]\n+\n --depth=<depth>::\n \tLimit fetching to the specified number of commits from the tip of\n \teach remote branch history. If fetching to a 'shallow' repository\n--\n2.31.1.163.ga65ce7f831\n\n"}]}