git-annex/doc/tips
Joey Hess 4acbb40112
git-annex config annex.largefiles
annex.largefiles can be configured by git-annex config, to more easily set
a default that will also be used by clones, without needing to shoehorn the
expression into the gitattributes file. The git config and gitattributes
override that.

Whenever something is added to git-annex config, we have to consider what
happens if a user puts a purposfully bad value in there. Or, if a new
git-annex adds some new value that an old git-annex can't parse.
In this case, a global annex.largefiles that can't be parsed currently
makes an error be thrown. That might not be ideal, but the gitattribute
behaves the same, and is almost equally repo-global.

Performance notes:

git-annex add and addurl construct a matcher once
and uses it for every file, so the added time penalty for reading the global
config log is minor. If the gitattributes annex.largefiles were deprecated,
git-annex add would get around 2% faster (excluding hashing), because
looking that up for each file is not fast. So this new way of setting
it is progress toward speeding up add.

git-annex smudge does need to load the log every time. As well as checking
the git attribute. Not ideal. Setting annex.gitaddtoannex=false avoids
both overheads.
2019-12-20 13:01:41 -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
android_sync_with_adb Added a comment: Does android adb special remote support MTP? 2019-12-10 21:23:31 +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: git config remote.origin.annex-ignore true 2018-12-26 20:33:36 +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 fix typo: datbase -> databae 2015-02-19 15:31:27 +00:00
Faster_bash_autocompletion_with_big_annex_repos patchneeds to be sent to git 2017-05-11 13:30:15 -04:00
file_manager_integration Added a comment 2014-10-01 02:02:40 +00:00
finding_duplicate_files Added a comment 2019-02-19 14:13:48 +00:00
finding_which_file_matches_a_key Added a comment: right! forgot about log -S 2019-10-23 20:16:26 +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
hiding_missing_files fix wrong option, followup 2019-03-22 09:51:42 -04: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 documentation for making git add only annex when configured by annex.largefiles 2019-10-24 14:01:54 -04:00
local_caching_of_annexed_files Added a comment: FTR: a dedicated issue on CoW across subvolumes 2019-07-08 19:05:45 +00:00
megaannex Added a comment 2014-09-07 21:16:09 +00:00
metadata_driven_views Added a comment: git annex view */=podcast 2014-08-19 06:11:50 +00:00
offline_archive_drives
owncloudannex Added a comment: asked upstream 2018-10-07 18:07:05 +00:00
peer_to_peer_network_with_tor Added a comment: Issue on openSUSE with Tor's requirement for Python 2.7 2019-09-29 16:41:15 +00: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 Added a comment: indeed a useful use case 2019-04-19 13:26:05 +00:00
Synology_NAS_and_git_annex removed 2019-07-23 18:01:46 +00:00
Systemd_unit comment 2017-04-05 11:44:29 -04:00
The_perfect_preferred_content_settings_for_my_android_phone
transmission_integration split docs and script 2015-01-05 16:12:07 -04:00
unlocked_files documentation for making git add only annex when configured by annex.largefiles 2019-10-24 14:01:54 -04: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 Added a comment: Download either video and audio 2019-09-23 09:14:29 +00: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 change a few last v6 references to v7 2019-07-17 11:44:57 -04:00
android_sync_with_adb.mdwn git-annex merge branch 2019-08-09 13:21:15 -04: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 2014-08-05 20:14:25 +00:00
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 Automatically convert direct mode repositories to v7 with adjusted unlocked branches 2019-08-26 15:05:25 -04: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 rename annex.security.allowed-http-addresses 2019-05-30 12:43:40 -04:00
dropboxannex.mdwn
dumb_metadata_extraction_from_xbmc.mdwn typo 2014-10-04 23:30:40 +00:00
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 Automatically convert direct mode repositories to v7 with adjusted unlocked branches 2019-08-26 15:05:25 -04:00
finding_duplicate_files.mdwn
finding_which_file_matches_a_key.mdwn update from comments 2019-10-23 20:15:40 +00:00
flickrannex.mdwn
fully_encrypted_git_repositories_with_gcrypt.mdwn support using gcrypt with git-lfs special remote 2019-08-05 13:43:45 -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 Automatically convert direct mode repositories to v7 with adjusted unlocked branches 2019-08-26 15:05:25 -04: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 fix wrong option, followup 2019-03-22 09:51:42 -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 upload to the test collection, giving users an idea of how to change collections as well as forcing people to think before they upload 2018-11-05 16:02:23 +00:00
largefiles.mdwn git-annex config annex.largefiles 2019-12-20 13:01:41 -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 typo 2014-07-31 05:09:33 +00:00
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
multiple_remotes_accessing_the_same_data_store.mdwn sameas documentation 2019-10-11 14:04:58 -04: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 Fix typo and incorrect references to "git annex peer" 2019-09-29 23:34:25 +00: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 update for deprecation of --tracking option 2019-03-11 14:27:01 -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
storing_data_in_git-lfs.mdwn git-lfs: remember urls, and autoenable remotes using known urls 2019-11-18 16:09:09 -04: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 split docs and script 2015-01-05 16:12:07 -04:00
unlocked_files.mdwn documentation for making git add only annex when configured by annex.largefiles 2019-10-24 14:01:54 -04:00
untrusted_repositories.mdwn
using_Amazon_Glacier.mdwn
using_Amazon_S3.mdwn reorder 2019-04-23 14:45:34 -04:00
using_box.com_as_a_special_remote.mdwn 2019-02-04 14:40:03 +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-worktree_with_annex.mdwn 2018-11-28 09:02:12 +00: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 rename annex.security.allowed-http-addresses 2019-05-30 12:43:40 -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