summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2020-12-02 11:12:42 +0100
committerSebastian Huber <sebastian.huber@embedded-brains.de>2020-12-02 11:13:36 +0100
commitcb4eca2bdd6fcaf243be009e0e6ef50b0deec5c0 (patch)
tree21fd6cc1b87de2b61f8e7d3f06e9a895cf5d2d2b
parentspec: Clarify invalid identifier descriptions (diff)
downloadrtems-central-cb4eca2bdd6fcaf243be009e0e6ef50b0deec5c0.tar.bz2
interfacedoc: Fix format of parameter names
-rw-r--r--rtemsspec/interfacedoc.py15
1 files changed, 10 insertions, 5 deletions
diff --git a/rtemsspec/interfacedoc.py b/rtemsspec/interfacedoc.py
index 5e7e3106..caeb4cb3 100644
--- a/rtemsspec/interfacedoc.py
+++ b/rtemsspec/interfacedoc.py
@@ -40,6 +40,10 @@ ItemMap = Dict[str, Item]
INTERFACE = "Interface"
+def _sanitize_name(name: str) -> str:
+ return name.lstrip("_")
+
+
def _forward_declaration(item: Item) -> str:
target = item.parent("interface-target")
return f"{target['interface-type']} {target['name']}"
@@ -65,7 +69,7 @@ def _get_value_function(ctx: ItemGetValueContext) -> Any:
def _get_param(ctx: ItemGetValueContext) -> Any:
- return f"``{ctx.value[ctx.key].lstrip('_')}``"
+ return f"``{_sanitize_name(ctx.value[ctx.key])}``"
class _Mapper(SphinxMapper):
@@ -115,7 +119,9 @@ def _add_function_definition(content: CContent, mapper: ItemMapper, item: Item,
value: Dict[str, Any]) -> None:
ret = mapper.substitute(value["return"])
name = item["name"]
- params = [mapper.substitute(param) for param in value["params"]]
+ params = [
+ mapper.substitute(_sanitize_name(param)) for param in value["params"]
+ ]
content.declare_function(ret, name, params)
@@ -123,7 +129,7 @@ def _add_macro_definition(content: CContent, _mapper: ItemMapper, item: Item,
_value: Dict[str, Any]) -> None:
ret = "#define"
name = item["name"]
- params = [param["name"] for param in item["params"]]
+ params = [_sanitize_name(param["name"]) for param in item["params"]]
content.call_function(ret, name, params, semicolon="")
@@ -173,9 +179,8 @@ def _generate_directive(content: SphinxContent, mapper: _Mapper,
if item["params"]:
content.add(".. rubric:: PARAMETERS:")
for param in item["params"]:
- param_name = mapper.substitute(param["name"])
content.add_definition_item(
- f"``{param_name}``",
+ f"``{_sanitize_name(param['name'])}``",
mapper.substitute(f"This parameter {param['description']}"),
wrap=True)
if item["description"]: