turn my forum question into a tip, thanks joeyh!

4 files changed, 35 insertions, 48 deletions

diff --git a/doc/forum/how_to_disable_a_remote_temporarily.mdwn b/doc/forum/how_to_disable_a_remote_temporarily.mdwn
deleted file mode 100644
index 4caa97ad0..000000000
--- a/doc/forum/how_to_disable_a_remote_temporarily.mdwn
+++ /dev/null
@@ -1,9 +0,0 @@
-In our quest to find dumb replacements for [[todo/wishlist: 'get' queue and schedule.]] (and a more complete [[git-annex-schedule]]), we have setup a cronjob that would start and stop the assistant during certain time windows, to ensure that it would not download during prime bandwidth time.
-
-But that isn't exactly what we're looking for: we would like the assistant to continue doing its usual thing of adding and removing files, and even syncing the git branches. Just not get/move files around.
-
-One way I thought of doing this was to disable a remote locally. [[git-annex-dead]] of course comes to mind, but that applies to all repositories, so it's not an option. If the remote was in git, i could just `git remote rm origin` and `git remote add origin` and be done with it, but this is the *web* remote, so it doesn't even show up in `git remote -v`.
-
-So how do i disable a [[special remotes]]?
-
-Thanks! --[[anarcat]]
diff --git a/doc/forum/how_to_disable_a_remote_temporarily/comment_1_22493ac2e1e74a6ef5223630747a029c._comment b/doc/forum/how_to_disable_a_remote_temporarily/comment_1_22493ac2e1e74a6ef5223630747a029c._comment
deleted file mode 100644
index ff2780a61..000000000
--- a/doc/forum/how_to_disable_a_remote_temporarily/comment_1_22493ac2e1e74a6ef5223630747a029c._comment
+++ /dev/null
@@ -1,32 +0,0 @@
-[[!comment format=mdwn
- username="joey"
- subject="""comment 1"""
- date="2015-05-30T15:56:09Z"
- content="""
-I think you should be able to use remote.name.annex-ignore for this.
-
-Let's see:
-
-	joey@darkstar:~/tmp/a>git annex addurl --fast http://localhost
-	addurl localhost ok
-	(recording state in git...)
-	joey@darkstar:~/tmp/a>git config remote.web.annex-ignore true
-	joey@darkstar:~/tmp/a>git annex get localhost
-	get localhost (not available) 
-	  Try making some of these repositories available:
-	  	00000000-0000-0000-0000-000000000001 -- web
-	
-	  (Note that these git remotes have annex-ignore set: web)
-	failed
-	git-annex: get: 1 failed
-	joey@darkstar:~/tmp/a>git config remote.web.annex-ignore false
-	joey@darkstar:~/tmp/a>git annex get localhost
-	get localhost (from web...) 
-	/home/joey/tmp/a/.g 100%[=====================>]      10  --.-KB/s   in 0s     
-	ok
-
-Yay, it worked!
-
-I think the assistant might need a restart to notice git config changes
-like this.
-"""]]
diff --git a/doc/forum/how_to_disable_a_remote_temporarily/comment_2_d6ec2fcac3a4028fc82f3ab0fa050b4f._comment b/doc/forum/how_to_disable_a_remote_temporarily/comment_2_d6ec2fcac3a4028fc82f3ab0fa050b4f._comment
deleted file mode 100644
index e8609a922..000000000
--- a/doc/forum/how_to_disable_a_remote_temporarily/comment_2_d6ec2fcac3a4028fc82f3ab0fa050b4f._comment
+++ /dev/null
@@ -1,7 +0,0 @@
-[[!comment format=mdwn
- username="https://id.koumbit.net/anarcat"
- subject="great!"
- date="2015-05-31T15:47:04Z"
- content="""
-oh that's great, didn't think of the ignore flag... i guess we should rename this into a todo item once i fixup the body above then. :)
-"""]]
diff --git a/doc/tips/disabling_a_special_remote.mdwn b/doc/tips/disabling_a_special_remote.mdwn
new file mode 100644
index 000000000..3b80ef25c
--- /dev/null
+++ b/doc/tips/disabling_a_special_remote.mdwn
@@ -0,0 +1,35 @@
+In our quest to find dumb replacements for [[todo/wishlist: 'get' queue and schedule.]] (and a more complete [[git-annex-schedule]]), we have setup a cronjob that would start and stop the assistant during certain time windows, to ensure that it would not download during prime bandwidth time.
+
+But that isn't exactly what we're looking for: we would like the assistant to continue doing its usual thing of adding and removing files, and even syncing the git branches. Just not get/move files around.
+
+One way I thought of doing this was to disable a remote locally. [[git-annex-dead]] of course comes to mind, but that applies to all repositories, so it's not an option. If the remote was in git, i could just `git remote rm origin` and `git remote add origin` and be done with it, but this is the *web* remote, so it doesn't even show up in `git remote -v`.
+
+But this doesn't work with [[special remotes]]. Another solution is
+simply to use the `remote.name.annex-ignore` configuration documented
+in the main [[git-annex]] manpage. For example, to disable the web
+remote, you would use:
+
+    git config remote.web.annex-ignore false
+
+The result would be:
+
+	joey@darkstar:~/tmp/a>git annex addurl --fast http://localhost
+	addurl localhost ok
+	(recording state in git...)
+	joey@darkstar:~/tmp/a>git config remote.web.annex-ignore true
+	joey@darkstar:~/tmp/a>git annex get localhost
+	get localhost (not available) 
+	  Try making some of these repositories available:
+	  	00000000-0000-0000-0000-000000000001 -- web
+	
+	  (Note that these git remotes have annex-ignore set: web)
+	failed
+	git-annex: get: 1 failed
+	joey@darkstar:~/tmp/a>git config remote.web.annex-ignore false
+	joey@darkstar:~/tmp/a>git annex get localhost
+	get localhost (from web...) 
+	/home/joey/tmp/a/.g 100%[=====================>]      10  --.-KB/s   in 0s     
+	ok
+
+The assistant (probably?) needs to be restarted for those changes to
+take effect.  --[[anarcat]] and [[joeyh]].