From 5de4482c1b52ead223bc380b45fcc421e25a80a4 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 26 Oct 2015 14:55:40 -0400 Subject: enableremote: List uuids and descriptions of remotes that can be enabled, and accept either the uuid or the description in leu if the name. --- doc/git-annex-enableremote.mdwn | 5 +++-- ...ment_26_606c1bee71a265f9df3a8cf50fce9a21._comment | 20 ++++++++++++++++++++ 2 files changed, 23 insertions(+), 2 deletions(-) create mode 100644 doc/special_remotes/comment_26_606c1bee71a265f9df3a8cf50fce9a21._comment (limited to 'doc') diff --git a/doc/git-annex-enableremote.mdwn b/doc/git-annex-enableremote.mdwn index 3b543c969..846724715 100644 --- a/doc/git-annex-enableremote.mdwn +++ b/doc/git-annex-enableremote.mdwn @@ -4,7 +4,7 @@ git-annex enableremote - enables use of an existing special remote # SYNOPSIS -git annex enableremote `name [param=value ...]` +git annex enableremote `name|uuid|desc [param=value ...]` # DESCRIPTION @@ -15,7 +15,8 @@ originally created with the initremote command. The name of the remote is the same name used when originally creating that remote with `git annex initremote`. Run `git annex enableremote` without any name to get a list of -special remote names. +special remote names. Or you can specify the uuid or description of the +remote. Some special remotes may need parameters to be specified every time they are enabled. For example, the directory special remote requires a directory= diff --git a/doc/special_remotes/comment_26_606c1bee71a265f9df3a8cf50fce9a21._comment b/doc/special_remotes/comment_26_606c1bee71a265f9df3a8cf50fce9a21._comment new file mode 100644 index 000000000..28a35bd9a --- /dev/null +++ b/doc/special_remotes/comment_26_606c1bee71a265f9df3a8cf50fce9a21._comment @@ -0,0 +1,20 @@ +[[!comment format=mdwn + username="joey" + subject="""comment 26""" + date="2015-10-26T17:36:26Z" + content=""" +@craig, this can be slightly confusing, since `git-annex enableremote` +uses the same name that you used when creating the remote in the first +place, with `git-annex initremote`... which might be different than +the name used for that remote in some repository or other, and from +the description shown in `git annex into`. + +Since every remote listed by `git annex info` is apparently a regular git +repo, not a special remote, with the exception of the glacier one, process +of deduction suggests that the "gitannexpics" special remote is the same as +the glacier one. + +I've made some changes now, so `git annex enableremote` will list the +uuid and description, along with the name used by enableremote, and +will accept any one of those things to specify which remote to enable. +"""]] -- cgit v1.2.3