mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

planning

Browse source 
several entangled things
This commit is contained in:
Joey Hess 2019-08-26 12:29:43 -04:00
parent 9bf3a5c405
commit 0c718763fd
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
3 changed files with 36 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

3
doc/design/roadmap.mdwn
View file

@ -17,6 +17,9 @@ Speed improvements, including:
* [[todo/sqlite_database_improvements]] to avoid using String and better * [[todo/sqlite_database_improvements]] to avoid using String and better
encode data stored in sqlite. encode data stored in sqlite.
Default to v7 repositories, and eliminate direct mode.
[[todo/v7_path_toward_default]]
Improvements to tree export support, including supporting export to more Improvements to tree export support, including supporting export to more
external special remotes, more external special remotes, more
efficient renames, and improving support for exporting non-annexed files. efficient renames, and improving support for exporting non-annexed files.

6
doc/todo/sqlite_database_improvements.mdwn
View file

@ -28,6 +28,9 @@ process.
INSERT INTO associated VALUES(4,'SHA256E-s30--7d51d2454391a40e952bea478e45d64cf0d606e1e8c0652bb815a22e0e23419a,'foo.ü'); INSERT INTO associated VALUES(4,'SHA256E-s30--7d51d2454391a40e952bea478e45d64cf0d606e1e8c0652bb815a22e0e23419a,'foo.ü');
INSERT INTO associated VALUES(5,'SHA256E-s30--7d51d2454391a40e952bea478e45d64cf0d606e1e8c0652bb815a22e0e23419a','"foo.\56515\56508"'); INSERT INTO associated VALUES(5,'SHA256E-s30--7d51d2454391a40e952bea478e45d64cf0d606e1e8c0652bb815a22e0e23419a','"foo.\56515\56508"');
See <http://git-annex.branchable.com/bugs/assistant_crashes_in_TransferScanner/>
for an example of how this can happen.
And it seems likely that a query by filename would fail if the filename And it seems likely that a query by filename would fail if the filename
was in the database but with a different encoding. was in the database but with a different encoding.
@ -93,6 +96,9 @@ process.
> Should this instead be a annex.version bump from v7 to v8? > Should this instead be a annex.version bump from v7 to v8?
> But v5 is also affected for ContentIdentifier and Export and Fsck. > But v5 is also affected for ContentIdentifier and Export and Fsck.
> Don't want v5.1. > Don't want v5.1.
>
> > Waiting until v5 is no longer supported and including this in v8
> > seems the only sure way to avoid backwards compatability issues.
---- ----

39
doc/todo/v7_path_toward_default.mdwn
View file

@ -16,23 +16,24 @@ and will need to enable annex.thin and adjusted unlocked branch instead.
Direct mode is very buggy and limited, so it's easy for v7 (with adjusted Direct mode is very buggy and limited, so it's easy for v7 (with adjusted
unlocked branches) to be better than it. unlocked branches) to be better than it.
Need to give it some time for problems to be found though.
Here are some problems that need to be investigated first:
- <http://git-annex.branchable.com/bugs/assistant_crashes_in_TransferScanner/>
- <http://git-annex.branchable.com/bugs/v6_appears_to_not_thin/>
- <http://git-annex.branchable.com/bugs/git-annex-sync_sometimes_fails_in_submodule_in_V6_adjusted_branch/>
Note that direct mode repos with old git-annex interoperate with adjusted Note that direct mode repos with old git-annex interoperate with adjusted
unlocked repos with new git-annex, so there is no need to wait for v7 to be unlocked repos with new git-annex, so there is no need to wait for v7 to be
widely supported. widely supported.
One problem with this is that direct mode stores only a single copy
of a file, but v7 unlocked with annex.thin needs two copies if hard links
are not supported. So some users will experience the repo doubling in size.
Limited mostly to windows, also some FAT media. This seems difficult
to avoid though, see discussion in
<http://git-annex.branchable.com/todo/annex.thin_without_hardlinks/>
## step 4: default for all new repositories ## step 4: default for all new repositories
Could probably happen fairly soon after default in direct mode. Could probably happen fairly soon after switch of direct mode.
This is entirely new repositories that git-annex init is run in for the This is entirely new repositories that git-annex init is run in for the
first time (no sibling git-annex branches). first time (no sibling git-annex branches). Limiting to new repos
avoids the problems discussed in step 5.
## step 5: automatic v5 to v7 upgrades ## step 5: automatic v5 to v7 upgrades
@ -46,11 +47,25 @@ machines, some not supporting v7 and some that do. If one upgrades to v7
and starts using unlocked files, those files won't be accessible on the old and starts using unlocked files, those files won't be accessible on the old
v5 machines. v5 machines.
> v7 is in debian stable now; oldstable (stretch) has v7 available
> as a backport but not by default, and will remain supported
> until 2022.
>
> But workflows involving unlocking and re-locking that work on v5 will
> also work on v7 and keep the repo compatible with v5. Only if some
> users commit unlocked files is v5 compatability lost, and even then
> it's easy to re-lock the file to fix compatabilityagain. So the risk
> of a too early upgrade to v7 is not very big.
Note that [[sqlite_database_improvements]] seems to need a v8 mode,
and so is blocked on v5 auto-upgrading.
## step 6: remove support for direct mode ## step 6: remove support for direct mode
Will simplify a lot of code. Will simplify a lot of code.
## step 7: remove support for v5 ## step 7: remove support for v5
This won't simplify much code, but maybe worth doing eventually. This won't simplify much code, worth doing eventually. Once automatic v5 to
Best not to rush this, maybe in 5 years from when v7 is default? v7 upgrades happen, the remaining v5 specific code is not needed any
longer.