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

notes on ImportableContents history not being used for retrieval

Browse source
This commit is contained in:
Joey Hess 2020-12-22 11:23:00 -04:00
parent bcd55b365c
commit c2d6f335a6
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
2 changed files with 9 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Types/Import.hs
View file

@ -59,6 +59,12 @@ data ImportableContents info = ImportableContents
-- ^ Used by remotes that support importing historical versions of -- ^ Used by remotes that support importing historical versions of
-- files that are stored in them. This is equivilant to a git -- files that are stored in them. This is equivilant to a git
-- commit history. -- commit history.
--
-- When retrieving a historical version of a file,
-- old ImportLocations from importableHistory are not used;
-- the content is no longer expected to be present at those
-- locations. So, if a remote does not support Key/Value access,
-- it should not populate the importableHistory.
} }
deriving (Show, Generic) deriving (Show, Generic)

4
doc/design/external_special_remote_protocol/export_and_import_appendix.mdwn
View file

@ -167,7 +167,9 @@ support a request, it can reply with `UNSUPPORTED-REQUEST`.
this can be used to list those versions. It opens a new this can be used to list those versions. It opens a new
block of responses. This can be repeated any number of times block of responses. This can be repeated any number of times
(indicating a branching history), and histories can also (indicating a branching history), and histories can also
be nested multiple levels deep. be nested multiple levels deep.
This should only be used when the remote supports using
"TRANSFER RECEIVE Key" to retrieve historical versions of files.
* `END` * `END`
Indicates the end of a block of responses. Indicates the end of a block of responses.
* `LOCATION Name` * `LOCATION Name`