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

Re: Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt

From
Derrick Stolee <derrickstolee@github.com>
Date
Mar 9, 2022, 15:23 UTC
Message-ID
<b5afa73a-d563-eb89-2557-5dcc02df2541@github.com>
In-Reply-To
<a0bb08ba-ef7a-53ec-a3c1-9238f9eb90ce@gmail.com>
On 3/9/2022 7:42 AM, Bagas Sanjaya wrote:
Show 24 quoted lines
> On 09/03/22 14.55, Shaoxuan Yuan wrote:
>> Hi all,
>>
>> I'm wondering if we could add an OPTIONS chunk to
>> Documentation/git-sparse-checkout.txt?
>>
>> Cause when I was skimming through the SYNOPSIS
>> and it says "git sparse-checkout <subcommand> [<options>]"
>> but I didn't quite see the options until I read into the COMMANDS.
>>
>> Perhaps something like this:
>>
>> OPTIONS
>>
>>      --[no-]cone
>>
>>      --[no-]sparse-index
>>
>>      --stdin
>>
>> If this is okay to do then I will try to submit a patch later :)
> 
> OK, but we need to list out subcommands and options in the SYNOPSIS,
> much like in git-worktree(1) and git-submodule(1).

Thank you for showing an interest in improving our docs! Be sure to start from Elijah's recent series [1] that overhauls the docs in a few different ways, just to avoid conflicts.

[1] https://lore.kernel.org/git/pull.1148.git.1646725188.gitgitgadget@gmail.com/

Thanks, -Stolee

Previous: Bagas Sanjaya
Message 3 of 3 in “Add an OPTIONS chunk to Documentation/git-sparse-checkout.txt”
  1. Shaoxuan YuanMar 9, 2022
  2. Bagas SanjayaMar 9, 2022
  3. Derrick StoleeMar 9, 2022

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.