{"thread":{"id":"57523","subject":"Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt","startedAt":"2022-03-09T07:58:00Z","lastAt":"2022-03-09T15:23:12Z","messageCount":3,"participants":["Shaoxuan Yuan","Bagas Sanjaya","Derrick Stolee"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"450819","messageId":"CAJyCBOTKq3t=QtynBMrHvP5__FfNpoeUJ7t8xMv-3zTbv4yU7Q@mail.gmail.com","threadId":"57523","inReplyTo":null,"subject":"Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt","fromName":"Shaoxuan Yuan","fromEmail":"shaoxuan.yuan02@gmail.com","sentAt":"2022-03-09T07:55:44Z","receivedAt":"2022-03-09T07:58:00Z","isPatch":false,"sender":{"key":"shaoxuan.yuan02@gmail.com","avatar":"https://avatars.githubusercontent.com/u/46557895?v=4"},"body":"Hi all,\n\nI'm wondering if we could add an OPTIONS chunk to\nDocumentation/git-sparse-checkout.txt?\n\nCause when I was skimming through the SYNOPSIS\nand it says \"git sparse-checkout <subcommand> [<options>]\"\nbut I didn't quite see the options until I read into the COMMANDS.\n\nPerhaps something like this:\n\nOPTIONS\n\n    --[no-]cone\n\n    --[no-]sparse-index\n\n    --stdin\n\nIf this is okay to do then I will try to submit a patch later :)\n-- \nThanks & Regards,\nShaoxuan\n"},{"id":"450836","messageId":"a0bb08ba-ef7a-53ec-a3c1-9238f9eb90ce@gmail.com","threadId":"57523","inReplyTo":"CAJyCBOTKq3t=QtynBMrHvP5__FfNpoeUJ7t8xMv-3zTbv4yU7Q@mail.gmail.com","subject":"Re: Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt","fromName":"Bagas Sanjaya","fromEmail":"bagasdotme@gmail.com","sentAt":"2022-03-09T12:42:16Z","receivedAt":"2022-03-09T12:42:23Z","isPatch":false,"sender":{"key":"bagasdotme@gmail.com","avatar":"https://avatars.githubusercontent.com/u/40219486?v=4"},"body":"On 09/03/22 14.55, Shaoxuan Yuan wrote:\n> Hi all,\n> \n> I'm wondering if we could add an OPTIONS chunk to\n> Documentation/git-sparse-checkout.txt?\n> \n> Cause when I was skimming through the SYNOPSIS\n> and it says \"git sparse-checkout <subcommand> [<options>]\"\n> but I didn't quite see the options until I read into the COMMANDS.\n> \n> Perhaps something like this:\n> \n> OPTIONS\n> \n>      --[no-]cone\n> \n>      --[no-]sparse-index\n> \n>      --stdin\n> \n> If this is okay to do then I will try to submit a patch later :)\n\nOK, but we need to list out subcommands and options in the SYNOPSIS,\nmuch like in git-worktree(1) and git-submodule(1).\n\n-- \nAn old man doll... just what I always wanted! - Clara\n"},{"id":"450875","messageId":"b5afa73a-d563-eb89-2557-5dcc02df2541@github.com","threadId":"57523","inReplyTo":"a0bb08ba-ef7a-53ec-a3c1-9238f9eb90ce@gmail.com","subject":"Re: Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt","fromName":"Derrick Stolee","fromEmail":"derrickstolee@github.com","sentAt":"2022-03-09T15:23:02Z","receivedAt":"2022-03-09T15:23:12Z","isPatch":false,"sender":{"key":"stolee@gmail.com","avatar":"https://avatars.githubusercontent.com/u/570044?v=4"},"body":"On 3/9/2022 7:42 AM, Bagas Sanjaya wrote:\n> On 09/03/22 14.55, Shaoxuan Yuan wrote:\n>> Hi all,\n>>\n>> I'm wondering if we could add an OPTIONS chunk to\n>> Documentation/git-sparse-checkout.txt?\n>>\n>> Cause when I was skimming through the SYNOPSIS\n>> and it says \"git sparse-checkout <subcommand> [<options>]\"\n>> but I didn't quite see the options until I read into the COMMANDS.\n>>\n>> Perhaps something like this:\n>>\n>> OPTIONS\n>>\n>>      --[no-]cone\n>>\n>>      --[no-]sparse-index\n>>\n>>      --stdin\n>>\n>> If this is okay to do then I will try to submit a patch later :)\n> \n> OK, but we need to list out subcommands and options in the SYNOPSIS,\n> much like in git-worktree(1) and git-submodule(1).\n\nThank you for showing an interest in improving our docs! Be sure\nto start from Elijah's recent series [1] that overhauls the docs in\na few different ways, just to avoid conflicts.\n\n[1] https://lore.kernel.org/git/pull.1148.git.1646725188.gitgitgadget@gmail.com/\n\nThanks,\n-Stolee\n"}]}