git-annex/doc
Joey Hess 503abb6d54
remove warning about git gc for annex.alwayscommit=false
I doubt that warning has ever been right, but I'm sure it is not right
now.

For there to be a risk of git gc deleting objects that are in the annex
index, journal files would have to be staged into it, and deleted, but
the index not committed to the git-annex branch. And AFAICS, there is no
code path where that actually happens. I considered adding one recently,
but didn't.

The way it actually works is, as long as the user has annex.alwayscommit=false
the data lives in the journal, where it's safe from git gc. Then when
git-annex is run w/o that config, the journal is staged into the index,
which is immediately committed to the branch. There's no window where
git gc could delete the objects, because git gc only deletes objects
after some time (2 weeks by default).

Now, if git-annex gets suspended at just the wrong time, or interrupted,
then yes, it's possible. But doesn't matter whether that config was ever
set or not. And many uses of git-annex also recover from that situation
by committing to the git-annex branch.
2020-04-15 14:25:33 -04:00
..
Android
android
assistant
automatic_conflict_resolution
backends Added a comment: backends vs special remotes 2020-02-20 19:23:07 +00:00
bare_repositories
bugs Merge branch 'master' of ssh://git-annex.branchable.com 2020-04-15 14:20:06 -04:00
chunking
coding_style
contribute Added a comment: Thanks 2020-02-17 17:52:22 +00:00
copies
design Fix typo remotes.log -> remote.log 2020-03-28 13:36:45 +00:00
devblog devblog 2020-03-25 13:26:25 -04:00
direct_mode
download
encryption
footer
forum 2020-04-15 13:06:14 +00:00
future_proofing
git-annex-addurl
git-annex-adjust Added a comment: Thank you 2020-01-23 19:52:50 +00:00
git-annex-checkpresentkey
git-annex-config
git-annex-copy
git-annex-direct
git-annex-drop
git-annex-enableremote
git-annex-find
git-annex-importfeed
git-annex-lookupkey
git-annex-metadata
git-annex-move
git-annex-p2p
git-annex-preferred-content
git-annex-reinject
git-annex-rmurl
git-annex-setpresentkey
git-annex-sync response 2020-02-20 15:31:42 -04:00
git-annex-test
git-annex-unannex
git-annex-undo
git-annex-uninit
git-annex-unlock update comments to point to conversion docs 2020-01-01 14:38:40 -04:00
git-annex-unused comments 2020-01-01 15:03:01 -04:00
git-annex-whereis
how_it_works
install Added a comment 2020-03-11 19:30:32 +00:00
internals response 2020-02-20 16:26:52 -04:00
license
links
metadata
news Added a comment: automatic repository upgrades 2020-03-30 23:24:51 +00:00
not
polls
preferred_content improve documentation 2020-04-13 12:33:35 -04:00
profiling wrap up 2019-12-18 15:19:19 -04:00
projects fix directive 2020-01-30 12:15:41 -04:00
required_content
scalability
security Added a comment 2020-02-21 00:07:56 +00:00
special_remotes remove amazon cloud drive, since amazon banned rclone 2020-03-04 22:48:42 -04:00
stickers
sync
templates styling 2020-01-29 11:35:40 -04:00
testimonials
thanks update 2020-04-05 18:35:34 -04:00
tips removed 2020-04-02 00:06:54 +00:00
todo cache annex index filename for 1.5% speedup to queries 2020-04-10 13:37:04 -04:00
trust
tuning
upgrades remove obsolete comments 2020-02-19 15:02:09 -04:00
use_case
users 2020-03-31 06:43:39 +00:00
videos
walkthrough
workflow
Android.mdwn
assistant.mdwn
automatic_conflict_resolution.mdwn
backends.mdwn added a hyperlink to key_format 2019-11-30 17:00:58 +00:00
bare_repositories.mdwn
bugs.mdwn add priority tags 2020-03-25 13:05:09 -04:00
builds.mdwn remove old dead link 2020-04-01 15:44:15 -04:00
chunking.mdwn
coding_style.mdwn
comments.mdwn
contact.mdwn
contribute.mdwn Fix double around Annex` 2020-01-29 16:52:22 +00:00
copies.mdwn
design.mdwn
devblog.mdwn
direct_mode.mdwn
distributed_version_control.mdwn
download.mdwn
encryption.mdwn
favicon.ico
forum.mdwn bad edit 2020-04-13 09:16:39 +00:00
future_proofing.mdwn
git-annex-add.mdwn remove confusing sentence 2020-03-09 19:27:05 -04:00
git-annex-addunused.mdwn
git-annex-addurl.mdwn mention special remotes 2019-11-11 13:15:01 -04:00
git-annex-adjust.mdwn
git-annex-assistant.mdwn
git-annex-benchmark.mdwn improve hints about squelching output 2019-11-22 17:26:13 -04:00
git-annex-calckey.mdwn
git-annex-checkpresentkey.mdwn
git-annex-config.mdwn Merge branch 'master' into v8 2020-02-19 14:32:11 -04:00
git-annex-contentlocation.mdwn
git-annex-copy.mdwn --auto doc wording 2020-04-13 16:12:48 -04:00
git-annex-dead.mdwn
git-annex-describe.mdwn
git-annex-diffdriver.mdwn
git-annex-direct.mdwn
git-annex-drop.mdwn --auto doc wording 2020-04-13 16:12:48 -04:00
git-annex-dropkey.mdwn
git-annex-dropunused.mdwn
git-annex-edit.mdwn
git-annex-enable-tor.mdwn
git-annex-enableremote.mdwn clean up some very confusing language about non-special remotes 2020-02-19 13:01:20 -04:00
git-annex-examinekey.mdwn
git-annex-expire.mdwn
git-annex-export.mdwn
git-annex-find.mdwn
git-annex-findref.mdwn
git-annex-fix.mdwn
git-annex-forget.mdwn
git-annex-fromkey.mdwn
git-annex-fsck.mdwn
git-annex-fuzztest.mdwn
git-annex-get.mdwn --auto doc wording 2020-04-13 16:12:48 -04:00
git-annex-group.mdwn
git-annex-groupwanted.mdwn
git-annex-import.mdwn encourage use of import from directory special remote rather than legacy interface 2019-11-19 13:30:27 -04:00
git-annex-importfeed.mdwn
git-annex-indirect.mdwn
git-annex-info.mdwn
git-annex-init.mdwn jump right to v8, don't stop part way 2020-02-24 13:21:00 -04:00
git-annex-initremote.mdwn --whatelse is a better name than --describe-other-params 2020-01-20 17:04:45 -04:00
git-annex-inprogress.mdwn inprogress: Support --key 2019-12-18 14:14:16 -04:00
git-annex-list.mdwn
git-annex-lock.mdwn
git-annex-log.mdwn
git-annex-lookupkey.mdwn
git-annex-map.mdwn
git-annex-matchexpression.mdwn annex.addunlocked expressions 2019-12-20 15:56:25 -04:00
git-annex-matching-expression.mdwn annex.dotfiles 2019-12-26 16:33:39 -04:00
git-annex-matching-options.mdwn
git-annex-merge.mdwn
git-annex-metadata.mdwn
git-annex-migrate.mdwn
git-annex-mirror.mdwn
git-annex-move.mdwn improve documentation 2020-04-13 12:33:35 -04:00
git-annex-multicast.mdwn
git-annex-numcopies.mdwn
git-annex-p2p.mdwn
git-annex-post-receive.mdwn
git-annex-pre-commit.mdwn
git-annex-preferred-content.mdwn improve documentation 2020-04-13 12:33:35 -04:00
git-annex-proxy.mdwn
git-annex-readpresentkey.mdwn
git-annex-registerurl.mdwn
git-annex-reinit.mdwn
git-annex-reinject.mdwn mention limitation of --known 2020-01-30 12:54:15 -04:00
git-annex-rekey.mdwn
git-annex-remotedaemon.mdwn
git-annex-renameremote.mdwn
git-annex-repair.mdwn
git-annex-required.mdwn
git-annex-resolvemerge.mdwn
git-annex-rmurl.mdwn
git-annex-schedule.mdwn
git-annex-semitrust.mdwn
git-annex-setkey.mdwn
git-annex-setpresentkey.mdwn
git-annex-shell.mdwn
git-annex-smudge.mdwn documentation for making git add only annex when configured by annex.largefiles 2019-10-24 14:01:54 -04:00
git-annex-status.mdwn
git-annex-sync.mdwn improve documentation 2020-04-13 12:33:35 -04:00
git-annex-test.mdwn
git-annex-testremote.mdwn
git-annex-transferkey.mdwn
git-annex-transferkeys.mdwn
git-annex-trust.mdwn
git-annex-unannex.mdwn
git-annex-undo.mdwn
git-annex-ungroup.mdwn
git-annex-uninit.mdwn
git-annex-unlock.mdwn
git-annex-untrust.mdwn
git-annex-unused.mdwn
git-annex-upgrade.mdwn fix problems with upgrade of local remotes 2020-03-09 16:49:28 -04:00
git-annex-vadd.mdwn
git-annex-vcycle.mdwn
git-annex-version.mdwn
git-annex-vfilter.mdwn
git-annex-vicfg.mdwn
git-annex-view.mdwn
git-annex-vpop.mdwn
git-annex-wanted.mdwn
git-annex-watch.mdwn
git-annex-webapp.mdwn
git-annex-whereis.mdwn
git-annex.mdwn remove warning about git gc for annex.alwayscommit=false 2020-04-15 14:25:33 -04:00
git-remote-tor-annex.mdwn
git-union-merge.mdwn
how_it_works.mdwn
index.mdwn Revert malicious removal of index page 2019-11-19 12:36:48 -04:00
install.mdwn added a note about historical builds 2020-03-09 16:50:13 +00:00
internals.mdwn generalize docs so they will also work when git uses SHA256 2020-01-07 16:10:57 -04:00
license.mdwn
location_tracking.mdwn
logo-old-bw.svg
logo-old.png
logo-old.svg
logo-old_small.png
logo.mdwn
logo.svg
logo_16x16.png
logo_32x32.png
logo_small.png
meta.mdwn
metadata.mdwn
news.mdwn
not.mdwn
polls.mdwn
preferred_content.mdwn
privacy.mdwn
profiling.mdwn
projects.mdwn
publicrepos.mdwn
related_software.mdwn fix markup 2020-02-24 14:25:13 +00:00
repomap.png
required_content.mdwn
scalability.mdwn added a hyperlink from scalability page to scalability tips page 2020-01-30 15:52:53 +00:00
security.mdwn
shortcuts.mdwn
sidebar.mdwn
sitemap.mdwn
special_remotes.mdwn 2020-03-31 23:40:12 +00:00
stickers.mdwn
submodules.mdwn
summary.mdwn
sync.mdwn
testimonials.mdwn
thanks.mdwn
tips.mdwn
todo.mdwn add priority tags 2020-03-25 13:05:09 -04:00
transferring_data.mdwn
trust.mdwn
tuning.mdwn
upgrades.mdwn remove instructions for v0 upgrade 2020-02-19 15:10:58 -04:00
users.mdwn
videos.mdwn
Void.mdwn
walkthrough.mdwn
workflow.mdwn