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

Re: [PATCH v3] worktree: clarify that --expire only affects missing worktrees

From
Eric Sunshine <sunshine@sunshineco.com>
Date
Jan 30, 2026, 00:29 UTC
Message-ID
<CAPig+cQ+HWZDb5ArGBq8PkXu1X6Dwe79w0sVjX9uRm7PcEwyNQ@mail.gmail.com>
In-Reply-To
<pull.2135.v3.git.git.1769578785381.gitgitgadget@gmail.com>

On Wed, Jan 28, 2026 at 12:39 AM Sam Bostock via GitGitGadget <gitgitgadget@gmail.com> wrote:

Show 19 quoted lines
> The --expire option for "git worktree list" and "git worktree prune"
> only affects worktrees whose working directory path no longer exists.
> The help text did not make this clear, and the documentation
> inconsistently used "unused" for prune but "missing" for list.
>
> Update the help text and documentation to consistently describe these
> as "missing worktrees", and use "prune" instead of "expire" when
> describing the effect on missing worktrees since the terminology is
> clearer.
>
> While at it, expand the description of the "prune" subcommand itself
> to better explain what it does and when to use it, as suggested by
> Junio.
>
> Signed-off-by: Sam Bostock <sam@sambostock.ca>
> ---
>     Changes from v2:
>      * Squash into a single commit
>      * Expand the prune subcommand description per Junio's suggestion

Thanks for re-rolling this patch. I think this version addresses all the review comments from Junio and myself and is ready to be merged to "next".

Previous: Sam Bostock via GitGitGadget
Message 14 of 14 in “worktree: clarify --expire applies to missing worktrees”
  1. worktree: clarify --expire applies to missing worktreesSam Bostock via GitGitGadget, Dec 19, 2025
  2. Eric SunshineDec 19, 2025
  3. Junio C HamanoDec 20, 2025
  4. Eric SunshineDec 20, 2025
  5. Junio C HamanoDec 20, 2025
  6. Eric SunshineDec 20, 2025
  7. 0/2 worktree: clarify --expire applies to missing worktreesSam Bostock via GitGitGadget, Dec 19, 2025
  8. 1/2 worktree: clarify --expire applies to missing worktreesSam Bostock via GitGitGadget, Dec 19, 2025
  9. Junio C HamanoDec 20, 2025
  10. 2/2 worktree: use 'prune' instead of 'expire' in help textSam Bostock via GitGitGadget, Dec 19, 2025
  11. Junio C HamanoDec 20, 2025
  12. Junio C HamanoJan 21, 2026
  13. worktree: clarify that --expire only affects missing worktreesSam Bostock via GitGitGadget, Jan 28, 2026
  14. Eric SunshineJan 30, 2026

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.