comment, improve docs

diff --git a/doc/special_remotes/git.mdwn b/doc/special_remotes/git.mdwn
index 0f729ae4cf86c0c6aff319210e2fbefba685eb55..0a7558d5d10a1bb2cb052dc987256f3dd4d2bd60 100644 (file)
--- a/doc/special_remotes/git.mdwn
+++ b/doc/special_remotes/git.mdwn
@@ -28,3 +28,8 @@ enable the special remote:
 
        git remote remove tmpremote
        git annex enableremote myremote
+
+This only works for git repositories that have a git-annex uuid set,
+because git-annex thinks about special remotes in terms of their uuid. So
+it cannot be used with a git remote hosted somewhere that does not have
+git-annex installed.

diff --git a/doc/special_remotes/git/comment_2_12c53dbbdb77f98f337ad60c67171337._comment b/doc/special_remotes/git/comment_2_12c53dbbdb77f98f337ad60c67171337._comment
new file mode 100644 (file)
index 0000000..fa47a6c
--- /dev/null
+++ b/doc/special_remotes/git/comment_2_12c53dbbdb77f98f337ad60c67171337._comment
@@ -0,0 +1,12 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 2"""
+ date="2021-08-24T16:42:27Z"
+ content="""
+This can only be used for git remotes that have an annex-uuid set. All
+special remotes have to have a uuid. git remotes that are hosted on a
+system with git-annex installed get the annex-uuid set up automatically,
+but it won't happen if your special remote is on github or something like
+that. You could `git config remote.foo.annex-uuid $(uuid)` to generate and 
+set a new uuid, I suppose.
+"""]]