clarify that combined hook program is deprecated, not entire hook special remote
authorJoey Hess <joeyh@joeyh.name>
Thu, 11 Jan 2024 15:04:07 +0000 (11:04 -0400)
committerJoey Hess <joeyh@joeyh.name>
Thu, 11 Jan 2024 15:04:07 +0000 (11:04 -0400)
doc/special_remotes/hook.mdwn

index 0bb76d98a0939d9670ed8e0114d846bd59cd5b34..1878aba70425475fa3520e99d3440b313b71e00a 100644 (file)
@@ -73,17 +73,18 @@ The settings to use in git config for the hook commands are as follows:
 
 ## combined hook program
 
-This interface is deprecated -- it's better, and not much harder,
-to write an [[external_special_remote|external]]!
-
 Rather than setting all of the above hooks, you can write a single
 program that handles everything, and set a single hook to make it be used.
 
        # git config annex.demo-hook /usr/local/bin/annexdemo
        # git annex initremote mydemorepo type=hook hooktype=demo encryption=none
 
-The program just needs to look at the `ANNEX_ACTION` environment variable
-to see what it's being asked to do. For example:
+But, doing that is deprecated -- it's better, and not much harder,
+to write an [[external_special_remote|external]]!
+
+If you still want to do this, the program just needs to look at the
+`ANNEX_ACTION` environment variable to see what it's being asked to do.
+For example:
 
 [[!format sh """
 #!/bin/sh