From e208b81763c13ae8520c9e33d90fa9b75e0daf32 Mon Sep 17 00:00:00 2001
From: Emmanuel Lepage Vallee <elv1313@gmail.com>
Date: Sun, 1 Dec 2019 01:48:58 -0500
Subject: [PATCH] doc: Add a @request tag to document the request:: contexts.

---
 docs/config.ld | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/config.ld b/docs/config.ld
index 5e835e64..35faea83 100644
--- a/docs/config.ld
+++ b/docs/config.ld
@@ -402,6 +402,20 @@ add_custom_tag {
     },
 }
 
+add_custom_tag {
+    name   = "request",
+    title  = "Requested actions or permissions",
+    params = {
+        { name = "class"   },
+        { name = "type"    },
+        { name = "context" },
+        { name = "default" },
+    },
+    table  = {
+        "Class", "Permission", "Context", "Default", "Description"
+    },
+}
+
 -- More fitting section names
 kind_names={topic='Documentation', module='Libraries', script='Sample files'}
 
@@ -507,12 +521,14 @@ local summarize = {
     emits         = {index = 1, title = "signals"        },
     propemits     = {index = 2, title = "signals"        },
     usebeautiful  = {index = 3, title = "theme variables"},
-    propbeautiful = {index = 4, title = "theme variables"}
+    propbeautiful = {index = 4, title = "theme variables"},
+    request       = {index = 5, title = "permissions"    },
 }
 
 local delimiter_for_tag = {
     usebeautiful  = { "table class='widget_list' border=1", "table", "tr", "tr", {"Theme variable", "Usage"}},
     propbeautiful = { "table class='widget_list' border=1", "table", "tr", "tr", {"Theme variable", "Usage"}},
+    request       = { "table class='widget_list' border=1", "table", "tr", "tr", {"Class", "Permission", "Context", "Default", "Description"}},
 }
 
 -- Use the first word of the subtag content to map it to its tag.