Hooks

- Updated documentation and style of example hook scripts.

scripts/hooks/on-modify

@@ -3,22 +3,20 @@
 # The on-modify event is triggered separately for each task added or modified
 
 # Input:
-# - A line of JSON for the original task
-# - A line of JSON for the modified task
+# - line of JSON for the original task
+# - line of JSON for the modified task, the diff being the modification
+
+# Output:
+# - all emitted JSON lines are added/modified as tasks, if the exit code is
+#   zero, otherwise ignored.
+# - minimal new task:  {"description":"Buy milk"}
+# - to modify a task include complete JSON
+# - all emitted non-JSON lines are considered feedback messages if the exit
+#   code is zero, otherwise they are considerederrors.
+
 read original_task
 read modified_task
 
-# Processing goes here
-
-# Output:
-# - all emitted JSON lines must be fully-formed tasks
-# - all emitted non-JSON lines are considered feedback messages
-echo on-modify
-
-# Exit:
-#   0 Means:     - all emitted JSON lines are added/modified
-#                - all emitted non-JSON lines become footnote entries
-#   non-0 Means: - all emitted JSON lines are ignored
-#                - all emitted non-JSON lines become error entries
+echo $modified_task
+echo 'on-modify'
 exit 0
-