diff -r 9d8a5b2c7049 js/macrolib/enchantments.js
--- a/js/macrolib/enchantments.js	Tue Nov 24 00:15:10 2015 +1000
+++ b/js/macrolib/enchantments.js	Tue Nov 24 16:30:44 2015 +1000
@@ -341,8 +341,21 @@
 		target to be interacted with and then performing the deferred rendering.
 	*/
 	const interactionTypes = [
-		// (click:)
-		// Reveal the enclosed hook only when the scope is clicked.
+		/*d:
+			(click: [Hook or String]) -> Command
+
+			Produces a command which, when attached to a hook, hides it and enchants the specified target, such that
+			it visually resembles a link, and that clicking it causes the attached hook to be revealed.
+
+			Example usage:
+			`There is a small dish of water. (click: "dish")[Your finger gets wet.]` causes "dish" to become a link that, when clicked,
+			reveals "Your finger gets wet." at the specified location.
+			`[Fie and fuggaboo!]<shout| (click: ?shout)[Blast and damnation!]` does roughly the same to the `<shout|` hook.
+
+			Rationale:
+
+			
+		*/
 		{
 			name: "click",
 			enchantDesc: {