]> git.cworth.org Git - notmuch/commitdiff
doc/emacs: split index category from label
authorDavid Bremner <david@tethera.net>
Sun, 31 Jul 2022 11:33:20 +0000 (08:33 -0300)
committerDavid Bremner <david@tethera.net>
Thu, 11 Aug 2022 10:43:17 +0000 (07:43 -0300)
A more verbose category is needed for the index, but not the
description in the manual.

doc/elisp.py

index b8b4931bf53a2a8e2e8e669b841e0b10eb05f67d..1b0392e6528c71f29de10f9e9883c6075ec0012b 100644 (file)
@@ -110,6 +110,13 @@ class EmacsLispSymbol(ObjectDescription):
         'defface': 'face'
     }
 
+    category_for_objtype = {
+        'defcustom': 'Emacs variable (customizable)',
+        'defconst': 'Emacs constant',
+        'defvar': 'Emacs variable',
+        'defface': 'Emacs face'
+    }
+
     @property
     def cell(self):
         """The cell in which to store symbol metadata."""
@@ -120,6 +127,11 @@ class EmacsLispSymbol(ObjectDescription):
         """The label for the documented object type."""
         return self.objtype
 
+    @property
+    def category(self):
+        """Index category"""
+        return self.category_for_objtype[self.objtype]
+
     def handle_signature(self, signature, signode):
         """Create nodes in ``signode`` for the ``signature``.
 
@@ -137,7 +149,7 @@ class EmacsLispSymbol(ObjectDescription):
 
     def _add_index(self, name, target):
         index_text = '{name}; {label}'.format(
-            name=name, label=self.label)
+            name=name, label=self.category)
         self.indexnode['entries'].append(
             ('pair', index_text, target, '', None))