From cbd62b792a2afbb705b14f9f30a8f9c400645507 Mon Sep 17 00:00:00 2001
From: Vaclav Petras <wenzeslaus@gmail.com>
Date: Thu, 6 Feb 2025 22:35:36 -0500
Subject: [PATCH] doc: Hide only general and misc keywords in index (#5056)

When a tool links raster or vector as a standard keyword, the link to keyword page does not go anywhere because first keyword (aka class or family) is hidden in the keywords index (overview).

This enables most of the keywords with the exception of general and misc which I assume will not be used by non-general tools as keywords.

Fixes #5049.

In addition, this changes the variable names for better documentation.
---
 man/build_keywords.py | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/man/build_keywords.py b/man/build_keywords.py
index 63173c3f254..9b9fe398eeb 100644
--- a/man/build_keywords.py
+++ b/man/build_keywords.py
@@ -22,17 +22,9 @@
 import sys
 import glob
 
-blacklist = [
-    "Display",
-    "Database",
+keywords_to_hide_in_overview = [
     "General",
-    "Imagery",
     "Misc",
-    "Postscript",
-    "Raster",
-    "Raster3D",
-    "Temporal",
-    "Vector",
 ]
 
 addons_path = None
@@ -114,12 +106,12 @@ def build_keywords(ext):
             elif fname not in keywords[key]:
                 keywords[key].append(fname)
 
-    for black in blacklist:
+    for keyword in keywords_to_hide_in_overview:
         try:
-            del keywords[black]
+            del keywords[keyword]
         except Exception:
             try:
-                del keywords[black.lower()]
+                del keywords[keyword.lower()]
             except Exception:
                 continue