git-annex/doc/tips
Joey Hess 234842a347
v7
Install new git hooks in this version.

This does beg the question of what to do if git later gets eg a
post-smudge hook, that could run git-annex smudge --update. I think the
thing to do in that case would be to make git-annex smudge --update
install the new hooks. That way, as the user uses git-annex, the hook
would be created pretty quickly and without needing any extra syscalls
except for when git-annex smudge --update is called.

I considered doing something like that for installation of the
post-checkout and post-merge hooks, which would have avoided the need
for v7. But the only place it was cheap to do it would be in git-annex smudge
which could cheaply notice that smudge.log didn't exist yet and so know
the hooks needed to be installed. But since smudge used to populate pointer
files, it would be quite surprising if a single git checkout/merge failed
to update the work tree, and so that idea didn't work out.

The other reason for v7 is psychological -- users don't need to worry
about whether they might be running an old version of git-annex that
doesn't support their v7 repository very well. And bug reports about
"v6" have gotten a bit of a bad association in my head since they often
hit one of the known limitations and didn't realize it was experimental.

newtyped RepoVersion Int to avoid needing 2 comparisons in
versionSupportsUnlockedPointers etc. Also it's just nicer.

This commit was sponsored by John Pellman on Patreon.
2018-10-25 18:24:23 -04:00
..
a_gui_for_metadata_operations git-annex-metadata-gui yay! 2016-12-07 16:00:12 -04:00
Accessing_files_in_bare_remotes_without_git-annex Added a comment: Updated 2016-01-12 22:47:49 +00:00
assume-unstaged
automatically_adding_metadata Fix metadata hook script to support non-ascii characters 2018-02-26 12:58:37 -04:00
beware_of_SSD_wear_when_doing_fsck_on_large_special_remotes
Building_git-annex_on_Debian_OR___37____164____35____34____164____37____38____34____35___Haskell__33__
Bup_repositories_in_git-annex Added a comment: bup.bloom must be unlocked 2015-07-17 17:45:24 +00:00
centralised_repository__58___starting_from_nothing rename files containing : 2016-03-12 12:57:18 -04:00
centralized_git_repository_tutorial Added a comment: tutorial up to date? 2017-11-03 20:23:12 +00:00
Decentralized_repository_behind_a_Firewall
Decrypting_files_in_special_remotes_without_git-annex Added a comment 2017-06-04 19:26:47 +00:00
Delay_Assistant_Startup_on_Login
downloading_podcasts removed 2018-01-17 18:50:50 +00:00
dumb_metadata_extraction_from_xbmc
Faster_bash_autocompletion_with_big_annex_repos patchneeds to be sent to git 2017-05-11 13:30:15 -04:00
file_manager_integration
finding_duplicate_files Added a comment 2016-01-15 09:34:40 +00:00
flickrannex Added a comment: Dead project, or just working smoothly? Also, which hat color? 2016-10-23 18:23:34 +00:00
fully_encrypted_git_repositories_with_gcrypt Added a comment: Cloning and syncing leads to confusing "gcrypt: Failed to decrypt manifest!" errors. 2018-04-08 00:50:15 +00:00
git-annex_extensions_for_ranger__44___the_file_manager Added a comment: related work 2016-10-11 13:35:08 +00:00
git-annex_on_NFS comment 2016-09-21 15:39:32 -04:00
Git_annex_and_Calibre Added a comment 2016-06-02 18:10:33 +00:00
googledriveannex Added a comment 2017-07-21 23:56:12 +00:00
How_to_retroactively_annex_a_file_already_in_a_git_repo Added a comment: Walkthrough of a prudent retroactive annex. 2016-11-24 11:27:59 +00:00
install_on_Android_in_Termux move comment 2018-10-11 13:35:13 -04:00
Internet_Archive_via_S3
largefiles response 2018-08-09 15:49:36 -04:00
local_caching_of_annexed_files prevent fetch/merge/push to cache 2018-08-03 14:10:05 -04:00
megaannex
metadata_driven_views
offline_archive_drives
owncloudannex Added a comment: asked upstream 2018-10-07 18:07:05 +00:00
peer_to_peer_network_with_tor comment 2017-04-05 11:51:51 -04:00
public_Amazon_S3_remote S3: fix documentation of publicurl 2018-07-02 12:30:39 -04:00
publishing_your_files_to_the_public responses 2017-10-30 12:10:39 -04:00
recover_data_from_lost+found comment 2017-03-14 19:45:28 -04:00
recovering_from_a_corrupt_git_repository
replacing_Sparkleshare_or_dvcs-autosync_with_the_assistant
Repositories_with_large_number_of_files Added a comment: merge with scalability? 2017-04-24 14:10:29 +00:00
semi-synchronized_remotes Added remote.<name>.annex-push and remote.<name>.annex-pull 2017-04-05 13:22:35 -04:00
setup_a_public_repository_on_a_web_site documentation updates for new receive.denyCurrentBranch=updateInstead support 2017-02-17 15:43:16 -04:00
shared_git_annex_directory_between_multiple_users Added a comment 2015-05-27 21:05:24 +00:00
skydriveannex Added a comment 2015-10-03 19:18:24 +00:00
splitting_a_repository comment 2017-05-11 12:35:34 -04:00
Synology_NAS_and_git_annex Added a comment: git-annex on Synology DS216+ (x86-64) 2017-05-28 01:19:17 +00:00
Systemd_unit comment 2017-04-05 11:44:29 -04:00
The_perfect_preferred_content_settings_for_my_android_phone
transmission_integration
unlocked_files Added a comment: workaround to my request 2016-11-05 14:53:36 +00:00
using_Amazon_Glacier response 2015-12-08 11:13:55 -04:00
using_Amazon_S3 comment 2017-09-29 13:46:33 -04:00
using_box.com_as_a_special_remote
using_git_annex_with_no_fixed_hostname_and_optimising_ssh
using_gitolite_with_git-annex Added a comment: Where does gitolite stores the annex objects contents? 2018-04-27 21:06:42 +00:00
using_Google_Cloud_Storage Added a comment: Coldline 2016-11-21 00:49:23 +00:00
using_signed_git_commits comment 2017-03-03 13:59:49 -04:00
using_the_web_as_a_special_remote response 2018-03-21 15:58:27 -04:00
visualizing_repositories_with_gource
what_to_do_when_a_repository_is_corrupted
what_to_do_when_you_lose_a_repository response 2016-05-03 15:17:39 -04:00
yet_another_simple_disk_usage_like_utility
ZSH_completion Added a comment 2017-11-09 17:35:14 +00:00
a_gui_for_metadata_operations.mdwn 2016-12-05 19:34:55 +00:00
Accessing_files_in_bare_remotes_without_git-annex.mdwn 2016-01-12 00:32:31 +00:00
Announcing_recastex_-___40__re__41__podcast__from_your_annex.mdwn 2018-04-06 06:51:36 +00:00
antipatterns.mdwn Support working trees set up by git-worktree. 2018-07-18 14:27:26 -04:00
assume-unstaged.mdwn
automatically_adding_metadata.mdwn The pre-commit-annex hook script that automatically extracts metadata has been updated to also use exiftool. Thanks, Klaus Ethgen. 2016-02-28 11:10:55 -04:00
automatically_getting_files_on_checkout.mdwn
beware_of_SSD_wear_when_doing_fsck_on_large_special_remotes.mdwn
Building_git-annex_on_Debian_OR___37____164____35____34____164____37____38____34____35___Haskell__33__.mdwn
Bup_repositories_in_git-annex.mdwn
centralised_repository__58___starting_from_nothing.mdwn rename files containing : 2016-03-12 12:57:18 -04:00
centralized_git_repository_tutorial.mdwn caps 2015-07-22 18:07:31 -04:00
Crude_Windows_Sync.mdwn
Decentralized_repository_behind_a_Firewall.mdwn
Decrypting_files_in_special_remotes_without_git-annex.mdwn 2016-01-08 07:38:01 +00:00
Delay_Assistant_Startup_on_Login.mdwn
deleting_unwanted_files.mdwn Revert my change, not a typo. 2018-04-11 13:47:42 +00:00
disabling_a_special_remote.mdwn turn my forum question into a tip, thanks joeyh! 2015-05-31 12:26:04 -04:00
downloading_podcasts.mdwn default to not using youtube-dl, for security 2018-06-17 14:51:02 -04:00
dropboxannex.mdwn
dumb_metadata_extraction_from_xbmc.mdwn
emacs_integration.mdwn Fixes markup error 2016-08-31 18:43:43 +00:00
Faster_bash_autocompletion_with_big_annex_repos.mdwn 2017-04-14 22:11:55 +00:00
file_manager_integration.mdwn 2018-03-07 23:17:54 +00:00
finding_duplicate_files.mdwn
flickrannex.mdwn
fully_encrypted_git_repositories_with_gcrypt.mdwn correct spelling mistakes 2017-02-12 17:30:23 -04:00
get_git-annex-shell_into_PATH.mdwn tip for git-annex-shell PATH issues 2015-08-09 18:09:05 -04:00
git-annex_extensions_for_ranger__44___the_file_manager.mdwn added :ga_get and :ga_set 2016-08-11 03:12:04 +00:00
git-annex_on_NFS.mdwn my NFS tricks for git-annex 2015-07-17 22:14:25 +00:00
Git_annex_and_Calibre.mdwn fix typo 2016-08-28 21:19:12 +00:00
googledriveannex.mdwn add pointer to newer special remote 2018-03-21 15:53:34 -04:00
hashdeep_integration.mdwn hashdeep integration 2018-06-18 12:45:32 +00:00
hiding_missing_files.mdwn v7 2018-10-25 18:24:23 -04:00
How_to_retroactively_annex_a_file_already_in_a_git_repo.mdwn
imapannex.mdwn
install_on_Android_in_Termux.mdwn update android docs for termux 2018-10-13 12:11:47 -04:00
Internet_Archive_via_S3.mdwn stop warning about removals from IA 2017-09-12 12:47:43 -04:00
largefiles.mdwn v6: avoid accidental conversion when annex.largefiles is not configured 2018-08-27 14:51:10 -04:00
local_caching_of_annexed_files.mdwn prevent fetch/merge/push to cache 2018-08-03 14:10:05 -04:00
making_a_remote_repo_update_when_changes_are_pushed_to_it.mdwn linkify 2017-02-17 15:58:32 -04:00
mc_menu_integration.mdwn 2017-01-31 16:53:58 +00:00
megaannex.mdwn Typo fixes in doc/tips/*.mdwn 2015-04-17 18:35:23 +02:00
metadata_driven_views.mdwn
migrating_data_to_a_new_backend.mdwn
migrating_two_seperate_disconnected_directories_to_git_annex.mdwn link with brother page 2017-04-24 13:43:16 +00:00
offline_archive_drives.mdwn
owncloudannex.mdwn link to webdav more explicitely 2018-09-06 01:01:04 +00:00
peer_to_peer_network_with_tor.mdwn add docs about p2p --pair being broken in old versions 2018-07-05 11:52:52 -04:00
playlist_fetch.mdwn explain a bit more 2016-03-31 10:55:20 -04:00
powerful_file_matching.mdwn
public_Amazon_S3_remote.mdwn S3: fix documentation of publicurl 2018-07-02 12:30:39 -04:00
publishing_your_files_to_the_public.mdwn caps 2017-09-25 11:32:44 -04:00
recover_data_from_lost+found.mdwn update 2015-11-13 13:46:11 -04:00
recovering_from_a_corrupt_git_repository.mdwn
remote_webapp_setup.mdwn
replacing_Sparkleshare_or_dvcs-autosync_with_the_assistant.mdwn rework largefiles documentation 2016-02-02 16:50:58 -04:00
Repositories_with_large_number_of_files.mdwn add signatures to the various sections 2017-04-24 13:40:59 +00:00
semi-synchronized_remotes.mdwn add annex-sync setting sample 2017-03-27 19:50:43 +00:00
setup_a_public_repository_on_a_web_site.mdwn clarify that git update-server-info needs to be run on the server 2017-06-06 15:19:31 -04:00
Shamir_secret_sharing_and_git-annex.mdwn
shared_git_annex_directory_between_multiple_users.mdwn actually, i screwed up, it's actually the litteral "group" 2015-05-27 20:56:05 +00:00
skydriveannex.mdwn
splitting_a_repository.mdwn put reverse on top of page 2017-04-24 13:44:07 +00:00
Synology_NAS_and_git_annex.mdwn Typo fixes in doc/tips/*.mdwn 2015-04-17 18:35:23 +02:00
Systemd_unit.mdwn prefer per-user, fix ExecStart syntax 2016-11-10 06:34:44 +00:00
The_perfect_preferred_content_settings_for_my_android_phone.mdwn
transmission_integration.mdwn
unlocked_files.mdwn v7 2018-10-25 18:24:23 -04:00
untrusted_repositories.mdwn
using_Amazon_Glacier.mdwn
using_Amazon_S3.mdwn S3: Publically accessible buckets can be used without creds. 2015-06-05 16:23:35 -04:00
using_box.com_as_a_special_remote.mdwn Fix typo 2018-09-22 22:46:20 +00:00
Using_Git-annex_as_a_web_browsing_assistant.mdwn limit url downloads to whitelisted schemes 2018-06-16 11:57:50 -04:00
using_git_annex_with_no_fixed_hostname_and_optimising_ssh.mdwn Its vs it's 2015-05-21 05:32:28 +00:00
using_gitolite_with_git-annex.mdwn Typo fixes in doc/tips/*.mdwn 2015-04-17 18:35:23 +02:00
using_Google_Cloud_Storage.mdwn remove my addition; I missed that bgilbert already said the same in a comment 2015-08-11 12:56:15 -04:00
using_signed_git_commits.mdwn better headings 2017-02-27 16:18:20 -04:00
using_the_web_as_a_special_remote.mdwn default to not using youtube-dl, for security 2018-06-17 14:51:02 -04:00
visualizing_repositories_with_gource.mdwn
what_to_do_when_a_repository_is_corrupted.mdwn
what_to_do_when_you_lose_a_repository.mdwn
yet_another_simple_disk_usage_like_utility.mdwn
ZSH_completion.mdwn