diff options
| -rw-r--r-- | doc/design/external_special_remote_protocol.mdwn | 2 | ||||
| -rw-r--r-- | doc/design/external_special_remote_protocol/comment_19_89d532a5013af24f15a0d003cbfbab25._comment | 13 |
2 files changed, 14 insertions, 1 deletions
diff --git a/doc/design/external_special_remote_protocol.mdwn b/doc/design/external_special_remote_protocol.mdwn index 76e57bc69..23fd66eb6 100644 --- a/doc/design/external_special_remote_protocol.mdwn +++ b/doc/design/external_special_remote_protocol.mdwn @@ -134,7 +134,7 @@ replying with `UNSUPPORTED-REQUEST` is acceptable. (without downloading it). The remote replies with one of `CHECKURL-FAILURE`, `CHECKURL-CONTENTS`, or `CHECKURL-MULTI`. * `WHEREIS Key` - Asks the remote to provide any information it can about ways to access + Asks the remote to provide additional information about ways to access the content of a key stored in it, such as eg, public urls. This will be displayed to the user by eg, `git annex whereis`. The remote replies with `WHEREIS-SUCCESS` or `WHEREIS-FAILURE`. diff --git a/doc/design/external_special_remote_protocol/comment_19_89d532a5013af24f15a0d003cbfbab25._comment b/doc/design/external_special_remote_protocol/comment_19_89d532a5013af24f15a0d003cbfbab25._comment new file mode 100644 index 000000000..1a4c180aa --- /dev/null +++ b/doc/design/external_special_remote_protocol/comment_19_89d532a5013af24f15a0d003cbfbab25._comment @@ -0,0 +1,13 @@ +[[!comment format=mdwn + username="joey" + subject="""re: WHEREIS -- is it better to just report failure to avoid duplicates?""" + date="2015-09-09T21:03:13Z" + content=""" +There's no point in implementing WHEREIS if it's going to reply with the +same values that are passed to SETURIPRESENT. + +Some special remotes may not need to use SETURIPRESENT to work at +all, and yet storing data on the remote makes it available from some public +url. This is the kind of situation where it makes sense to implement +WHEREIS. +"""]] |