From 1485dd0a3ff86c95dcf4760d3cd1038a3bb2e00a Mon Sep 17 00:00:00 2001 From: Scott Main Date: Fri, 20 Oct 2023 17:29:45 -0700 Subject: [PATCH] Insert signature name into node attribute for use as short headings If it's a function, add parentheses to the name. --- breathe/renderer/sphinxrenderer.py | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/breathe/renderer/sphinxrenderer.py b/breathe/renderer/sphinxrenderer.py index dff0c982..edc35f62 100644 --- a/breathe/renderer/sphinxrenderer.py +++ b/breathe/renderer/sphinxrenderer.py @@ -686,6 +686,14 @@ def content(contentnode): assert len(desc) >= 1 sig = desc[0] assert isinstance(sig, addnodes.desc_signature) + + # Insert the member name for use in Sphinx-generated table of contents. + member_name = node.get_name() + if obj_type == "function": + member_name += "()" + sig.attributes["_toc_name"] = member_name + sig.attributes["_toc_parts"] = member_name + # if may or may not be a multiline signature isMultiline = sig.get("is_multiline", False) declarator: Optional[Declarator] = None