docwriter: Define a new formatter method for getting params

This will let us gracefully skip over parameters that aren't exposed
by specific language bindings.

It also fixes a bug in the C/Python documentation where we weren't
iterating over the right parameters.

1 files changed, 12 insertions, 0 deletions

diff --git a/giscanner/docwriter.py b/giscanner/docwriter.py
index 2b9cb0fc..be4d74ff 100644
--- a/giscanner/docwriter.py
+++ b/giscanner/docwriter.py
@@ -289,6 +289,9 @@ class DocFormatter(object):
 
         return dispatch[kind](node, match, props)
 
+    def get_parameters(self, node):
+        raise NotImplementedError
+
     def format_inline(self, node, para):
         tokens = self._scanner.scan(para)
         words = [self._process_token(node, tok) for tok in tokens]
@@ -374,6 +377,9 @@ class DocFormatterC(DocFormatter):
         else:
             return func.name
 
+    def get_parameters(self, node):
+        return node.all_parameters
+
 class DocFormatterPython(DocFormatter):
     language = "Python"
     mime_type = "text/python"
@@ -450,6 +456,9 @@ class DocFormatterPython(DocFormatter):
         else:
             return func.name
 
+    def get_parameters(self, node):
+        return node.all_parameters
+
 class DocFormatterGjs(DocFormatter):
     language = "Gjs"
     mime_type = "text/x-gjs"
@@ -520,6 +529,9 @@ class DocFormatterGjs(DocFormatter):
         else:
             return func.name
 
+    def get_parameters(self, node):
+        return node.parameters
+
 LANGUAGES = {
     "c": DocFormatterC,
     "python": DocFormatterPython,