[hooks] Updated and reformatted documentation for everything in hooks, including README

1 files changed, 13 insertions, 4 deletions

diff --git a/generate-hooks/create-flags.awk b/generate-hooks/create-flags.awk
index ad8e1b2..252bdcb 100644
--- a/generate-hooks/create-flags.awk
+++ b/generate-hooks/create-flags.awk
@@ -1,8 +1,17 @@
-# Adds a way to more simply insert flags into text
-# Each flag is represented with an ftag (text that is preceded by &&)
+#
+# == About ==
+#
+# A collection of ftags that generate an image HTML tag, containing the specified
+# flag. This is done, because these tags need to have the unzoomable class, which
+# you can't specify in Markdown.
 
-# Available flags:
-# Great Britain - &&gb
+# == ftags ==
+#
+# &&gb    Great Britain flag
+#
+# -- Placement/Flow --
+#
+# They can reside absolutely anywhere in text.
 
 BEGIN {
 	flag[1] = "gb"