rename http special remote to httpalso

"http" was too generic and easy to confuse with web. The new name makes
clear it's used in addition to some other remote. And other protocols
can use the same naming scheme.
This commit is contained in:
Joey Hess 2020-09-02 10:41:27 -04:00
parent a47787934a
commit 8656afd3e1
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
10 changed files with 33 additions and 32 deletions

View file

@ -1,5 +1,5 @@
This special remote allows downloading annexed objects from other remotes
that expose their content by http. Not to be confused with the [[web]]
that also publish their content by http. Not to be confused with the [[web]]
special remote, this one is only useful in combination with some other
special remote.
@ -7,14 +7,14 @@ Suppose, for example, that you have a [[directory]] special remote. And the
directory happens to be published by a web server. (Or it could be a
[[rsync]] special remote, or many other kinds.) To let git-annex know that
the content of this special remote can also be accessed over http, set up
a http special remote.
a httpalso special remote.
git annex initremote --sameas=foo foo-http type=http url=http://example.com/foo
git annex initremote --sameas=foo foo-http type=httpalso url=http://example.com/foo
The --sameas parameter tells git-annex what other special remote this http
The --sameas parameter tells git-annex what other special remote this httpalso
remote is accessing. (See [[tips/multiple_remotes_accessing_the_same_data_store]].)
Since the http remote is read-only, it can only be used to download content
that is stored in that other remote.
Since the httpalso remote is read-only, it can only be used to download
content that is stored in that other remote.
This special remote is compatible with many, but not all, other special
remotes. If the special remote does something unusual with the name

View file

@ -10,4 +10,4 @@ it cannot upload to it or remove content.
This special remote uses urls on the web as the source for content.
There are several other ways http can be used to download annexed objects,
including a git remote accessible by http, S3 with a `publicurl` configured,
and the [[http]] special remote.
and the [[httpalso]] special remote.