git-annex/doc/design
Joey Hess b4cf22a388 pushed checkPresent exception handling out of Remote implementations
I tend to prefer moving toward explicit exception handling, not away from
it, but in this case, I think there are good reasons to let checkPresent
throw exceptions:

1. They can all be caught in one place (Remote.hasKey), and we know
   every possible exception is caught there now, which we didn't before.
2. It simplified the code of the Remotes. I think it makes sense for
   Remotes to be able to be implemented without needing to worry about
   catching exceptions inside them. (Mostly.)
3. Types.StoreRetrieve.Preparer can only work on things that return a
   Bool, which all the other relevant remote methods already did.
   I do not see a good way to generalize that type; my previous attempts
   failed miserably.
2014-08-06 13:45:19 -04:00
..
assistant pushed checkPresent exception handling out of Remote implementations 2014-08-06 13:45:19 -04:00
encryption Added a comment 2012-08-15 19:16:10 +00:00
external_special_remote_protocol Added a comment 2014-02-11 13:44:10 +00:00
git-remote-daemon Added a comment: Rolling hash chunking 2014-04-04 14:16:25 +00:00
metadata Added a comment: Why not automatically add the whole date? 2014-04-30 20:41:21 +00:00
requests_routing keep track of satisfied requests, and summarize 2014-05-09 16:41:05 -03:00
assistant.mdwn clarify that this is mostly done (i think?) 2014-04-07 04:41:56 +00:00
caching_database.mdwn link to another place this could be used, perhaps 2014-03-18 15:53:06 -04:00
encryption.mdwn clarify 2013-08-29 14:32:25 -04:00
external_special_remote_protocol.mdwn make explicit the implicit requirement that CHECKPRESENT not say a key is present until it's all done being stored 2014-07-28 14:37:22 -04:00
gcrypt.mdwn automatically derive an annex-uuid from a gcrypt-uuids 2013-09-05 16:02:39 -04:00
git-remote-daemon.mdwn fix typos. 2014-04-16 10:41:07 +02:00
metadata.mdwn pre-commit-annex hook script to automatically extract metadata from lots of types of files 2014-03-02 20:11:58 -04:00
preferred_content.mdwn preferred content stability analysis 2014-01-22 15:55:44 -04:00
requests_routing.mdwn keep track of satisfied requests, and summarize 2014-05-09 16:41:05 -03:00
roadmap.mdwn update roadmap 2014-08-01 18:22:13 -04:00