On Mon, 13 Nov 2017, Eric Sunshine wrote: > On Mon, Nov 13, 2017 at 9:48 AM, Robert P. J. Day <rpjday@xxxxxxxxxxxxxx> wrote: ... snip ... > > finally, the prune "--expire" option is truly confusing: > > > > --expire <time> > > With prune, only expire unused working trees older than <time>. > > > > suddenly, we encounter the verb "expire", which means ... what? > > how does "expiring" a worktree differ from "pruning" a worktree? > > and what makes a worktree "unused"? the normal meaning of "unused" > > is that you haven't, you know, *used* it lately. in this context, > > though, does it mean deleted? and if it means deleted, what does > > it mean for it to be older than some time if it's already gone? > > This dates back to the original behavior of automatically pruning > administrative information for deleted worktrees. As discussed > elsewhere in the document, a worktree may be placed on some > removable device (USB drive, memory stick, etc.) or network share > which isn't always mounted. The "expire time" provides such > not-necessarily-mounted worktrees a grace period before being pruned > automatically. how is this "expire time" measured? relative to what? i've looked under .git/worktrees/<wtname>, and i see a bunch of files defining that worktree, but it's not clear how a worktree stores the relevant time to be used for the determination of when a worktree "expires". oh, and is it fair to assume that if a worktree is temporaily missing, and is subsequently restored, the expire time counter is reset? otherwise, it would get kind of weird. rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ========================================================================