path: root/builtin
diff options
authorDerrick Stolee <>2020-10-15 17:22:04 (GMT)
committerJunio C Hamano <>2020-10-16 15:36:42 (GMT)
commit0016b618182f642771dc589cf0090289f9fe1b4f (patch)
treeb91beb5925cd585a0d0c8cd4ba65d7da34786cc6 /builtin
parent61f7a383d3b9a7306f1fd44a8dfa070deacc0752 (diff)
maintenance: add troubleshooting guide to docs
The 'git maintenance run' subcommand takes a lock on the object database to prevent concurrent processes from competing for resources. This is an important safety measure to prevent possible repository corruption and data loss. This feature can lead to confusing behavior if a user is not aware of it. Add a TROUBLESHOOTING section to the 'git maintenance' builtin documentation that discusses these tradeoffs. The short version of this section is that Git will not corrupt your repository, but if the list of scheduled tasks takes longer than an hour then some scheduled tasks may be dropped due to this object database collision. For example, a long-running "daily" task at midnight might prevent an "hourly" task from running at 1AM. The opposite is also possible, but less likely as long as the "hourly" tasks are much faster than the "daily" and "weekly" tasks. Helped-by: Junio C Hamano <> Signed-off-by: Derrick Stolee <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'builtin')
0 files changed, 0 insertions, 0 deletions