updates for web remote and removing URL backend

This commit is contained in:
Joey Hess 2011-07-01 15:39:30 -04:00
parent 3efba481b5
commit 6ba866ca73
8 changed files with 9 additions and 42 deletions

1
debian/control vendored
View file

@ -10,6 +10,7 @@ Build-Depends:
libghc-sha-dev, libghc-sha-dev,
libghc-dataenc-dev, libghc-dataenc-dev,
libghc-utf8-string-dev, libghc-utf8-string-dev,
libghc-curl-dev,
libghc-hs3-dev (>= 0.5.6), libghc-hs3-dev (>= 0.5.6),
libghc-testpack-dev [any-i386 any-amd64], libghc-testpack-dev [any-i386 any-amd64],
ikiwiki, ikiwiki,

View file

@ -27,10 +27,6 @@ these backends.
part of the key. Useful for archival tasks where the filename extension part of the key. Useful for archival tasks where the filename extension
contains metadata that should be preserved. contains metadata that should be preserved.
These backends store file contents in other key/value stores.
* `URL` -- This backend downloads the file's content from an external URL.
The `annex.backends` git-config setting can be used to list the backends The `annex.backends` git-config setting can be used to list the backends
git-annex should use. The first one listed will be used by default when git-annex should use. The first one listed will be used by default when
new files are added. new files are added.

View file

@ -5,7 +5,6 @@ A suppliment to the [[walkthrough]].
[[!inline feeds=no show=0 template=walkthrough pagenames=""" [[!inline feeds=no show=0 template=walkthrough pagenames="""
walkthrough/using_Amazon_S3 walkthrough/using_Amazon_S3
walkthrough/using_bup walkthrough/using_bup
walkthrough/using_the_URL_backend
walkthrough/using_the_SHA1_backend walkthrough/using_the_SHA1_backend
walkthrough/migrating_data_to_a_new_backend walkthrough/migrating_data_to_a_new_backend
walkthrough/untrusted_repositories walkthrough/untrusted_repositories

View file

@ -277,13 +277,8 @@ Many git-annex commands will stage changes for later `git commit` by you.
* fromkey file * fromkey file
This can be used to manually set up a file to link to a specified key This plumbing-level command can be used to manually set up a file
in the key-value backend. How you determine an existing key in the backend to link to a specified key in the key-value backend.
varies. For the URL backend, the key is based on an URL to the content.
Example:
git annex fromkey --key=URL--http://www.archive.org/somefile somefile
* dropkey [key ...] * dropkey [key ...]
@ -299,8 +294,8 @@ Many git-annex commands will stage changes for later `git commit` by you.
* setkey file * setkey file
This plumbing-level command sets the annexed data for a key to the content of This plumbing-level command sets the annexed data for a key to the
the specified file, and then removes the file. content of the specified file, and then removes the file.
Example: Example:
@ -402,7 +397,6 @@ Here are all the supported configuration settings.
Space-separated list of names of the key-value backends to use. Space-separated list of names of the key-value backends to use.
The first listed is used to store new files by default. The first listed is used to store new files by default.
(default: "WORM SHA1 URL")
* `remote.<name>.annex-cost` * `remote.<name>.annex-cost`

View file

@ -19,6 +19,7 @@ To build and use git-annex, you will need:
* [dataenc](http://hackage.haskell.org/package/dataenc) * [dataenc](http://hackage.haskell.org/package/dataenc)
* [TestPack](http://hackage.haskell.org/cgi-bin/hackage-scripts/package/testpack) * [TestPack](http://hackage.haskell.org/cgi-bin/hackage-scripts/package/testpack)
* [QuickCheck 2](http://hackage.haskell.org/package/QuickCheck) * [QuickCheck 2](http://hackage.haskell.org/package/QuickCheck)
* [curl](http://hackage.haskell.org/package/curl)
* [hS3](http://hackage.haskell.org/package/hS3) (optional, but recommended) * [hS3](http://hackage.haskell.org/package/hS3) (optional, but recommended)
* Shell commands * Shell commands
* [git](http://git-scm.com/) * [git](http://git-scm.com/)

View file

@ -1,4 +1,4 @@
Another handy alternative to the default [[backend|backends]] is the A handy alternative to the default [[backend|backends]] is the
SHA1 backend. This backend provides more git-style assurance that your data SHA1 backend. This backend provides more git-style assurance that your data
has not been damaged. And the checksum means that when you add the same has not been damaged. And the checksum means that when you add the same
content to the annex twice, only one copy need be stored in the backend. content to the annex twice, only one copy need be stored in the backend.

View file

@ -1,24 +0,0 @@
git-annex has multiple key-value [[backends]]. So far you have been using
the default, WORM (Write Once, Read Many) backend.
Another handy backend is the URL backend, which can fetch file's content
from remote URLs. Here's how to set up some files in your repository
that use this backend:
# git annex fromkey --key=URL--http://www.archive.org/somefile somefile
fromkey somefile ok
# git commit -m "added a file from the Internet Archive"
Now you if you ask git-annex to get that file, it will download it,
and cache it locally.
# git annex get somefile
get somefile (downloading)
#########################################################################100.0%
ok
You can always drop files downloaded by the URL backend. It is assumed
that the URL is stable; no local backup is kept.
# git annex drop somefile
drop somefile (ok)

View file

@ -29,14 +29,14 @@ Executable git-annex
Main-Is: git-annex.hs Main-Is: git-annex.hs
Build-Depends: haskell98, MissingH, hslogger, directory, filepath, Build-Depends: haskell98, MissingH, hslogger, directory, filepath,
unix, containers, utf8-string, network, mtl, bytestring, old-locale, time, unix, containers, utf8-string, network, mtl, bytestring, old-locale, time,
pcre-light, extensible-exceptions, dataenc, SHA, process, hS3, pcre-light, extensible-exceptions, dataenc, SHA, process, hS3, curl,
base < 5 base < 5
Executable git-annex-shell Executable git-annex-shell
Main-Is: git-annex-shell.hs Main-Is: git-annex-shell.hs
Build-Depends: haskell98, MissingH, hslogger, directory, filepath, Build-Depends: haskell98, MissingH, hslogger, directory, filepath,
unix, containers, utf8-string, network, mtl, bytestring, old-locale, time, unix, containers, utf8-string, network, mtl, bytestring, old-locale, time,
pcre-light, extensible-exceptions, dataenc, SHA, process, hS3, pcre-light, extensible-exceptions, dataenc, SHA, process, hS3, curl,
base < 5 base < 5
Executable git-union-merge Executable git-union-merge