summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2015-09-09 17:09:48 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2015-09-09 17:09:48 -0400
commit7c5af228ec0438c9ac40832311fd00ba07374abe (patch)
treeb92f8cf8311e001b05213841ed4691b11604590b /doc
parentefa26b157e79005aee309c77c07974afe199ee75 (diff)
response
Diffstat (limited to 'doc')
-rw-r--r--doc/design/external_special_remote_protocol.mdwn2
-rw-r--r--doc/design/external_special_remote_protocol/comment_19_89d532a5013af24f15a0d003cbfbab25._comment13
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.
+"""]]