git-annex/doc/git-annex-rmurl.mdwn
Joey Hess 98a3ba0ea5
restore old registerurl location tracking behavior
registerurl: When an url is claimed by a special remote other than the web,
update location tracking for that special remote.

registerurl's behavior was changed in commit
451171b7c1, apparently accidentially to not
update location tracking except for the web.

This makes registerurl followed by unregisterurl not be a no-op, when the
url happens to be claimed by a remote other than the web. It is a noop when
the url is unclaimed except by the web. I don't like the inconsistency,
and wish that registerurl and unregisterurl never updated location
tracking, which would be more in keeping with them being plumbing.

But there is the fact that it used to behave this way, and also it was
inconsistent that it updated location tracking for the web but not for
other remotes, unlike addurl. And there's an argument that the user might
not know what remote to expect to claim an url, so would be considerably in
the dark when using registerurl. (Although they have to know what content
gets downloaded, since they specify a key..)

Sponsored-By: the NIH-funded NICEMAN (ReproNim TR&D3) project
2023-04-05 17:06:44 -04:00

43 lines
971 B
Markdown

# NAME
git-annex rmurl - record file is not available at url
# SYNOPSIS
git annex rmurl `[file url ..]`
# DESCRIPTION
Record that the file is no longer available at the url.
Removing the last web url will make git-annex no longer treat content as being
present in the web special remote. If some other special remote
claims the url, unregistering the url will not update presence information
for it, because the content may still be present on the remote.
# OPTIONS
* `--batch`
Enables batch mode, in which lines are read from stdin.
Each line should contain the file, and the url to remove from that file,
separated by a single space.
* `-z`
Makes the `--batch` input be delimited by nulls instead of the usual
newlines.
* Also the [[git-annex-common-options]](1) can be used.
# SEE ALSO
[[git-annex]](1)
[[git-annex-addurl]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.