From fb98a4f19da972709ac56b89a1184624e23bc224 Mon Sep 17 00:00:00 2001
From: Tomeu Vizoso <tomeu.vizoso@collabora.com>
Date: Mon, 20 Feb 2012 12:21:41 +0100
Subject: g-ir-doc-tool: Show how to construct instances in the Class page

---
 giscanner/mallard-Python-class.tmpl                    | 18 +++++++++++++-----
 giscanner/mallardwriter.py                             |  4 ++++
 .../GIRepository.Repository.page                       |  8 +++-----
 3 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/giscanner/mallard-Python-class.tmpl b/giscanner/mallard-Python-class.tmpl
index 1dd8644d..d45b0ab6 100644
--- a/giscanner/mallard-Python-class.tmpl
+++ b/giscanner/mallard-Python-class.tmpl
@@ -21,11 +21,19 @@ ${formatter.format(node.doc)}
       </item>
     </tree>
   </synopsis>
-  <links type="topic" ui:expanded="yes"
-         api:type="function" api:mime="text/x-python"
-         groups="constructor" style="linklist">
-    <title>Constructors</title>
-  </links>
+  <p>Constructor</p>
+  <synopsis><code mime="text/x-python">
+${formatter.to_underscores(node.name).lower()} = ${node.name}(\
+% for property_, ix in zip(node.properties, range(len(node.properties))):
+% if property_.construct or property_.construct_only or property_.writable:
+${property_.name.replace('-', '_')}=value\
+% if ix != len(node.properties) - 1:
+, \
+% endif
+% endif
+% endfor
+)\
+  </code></synopsis>
   <links type="topic" ui:expanded="yes"
          api:type="function" api:mime="text/x-python"
          groups="method" style="linklist">
diff --git a/giscanner/mallardwriter.py b/giscanner/mallardwriter.py
index fcfd2368..351a8c1f 100644
--- a/giscanner/mallardwriter.py
+++ b/giscanner/mallardwriter.py
@@ -30,6 +30,7 @@ from mako.template import Template
 from mako.runtime import supports_caller
 
 from . import ast
+from .utils import to_underscores
 
 class MallardFormatter(object):
     def __init__(self, namespace):
@@ -90,6 +91,9 @@ class MallardFormatter(object):
 
         return " / ".join(flags)
 
+    def to_underscores(self, string):
+        return to_underscores(string)
+
 class MallardFormatterC(MallardFormatter):
 
     def format_type(self, type_):
diff --git a/tests/doctool/GIRepository-2.0-Python-expected/GIRepository.Repository.page b/tests/doctool/GIRepository-2.0-Python-expected/GIRepository.Repository.page
index b194a079..eb466270 100644
--- a/tests/doctool/GIRepository-2.0-Python-expected/GIRepository.Repository.page
+++ b/tests/doctool/GIRepository-2.0-Python-expected/GIRepository.Repository.page
@@ -18,11 +18,9 @@
       </item>
     </tree>
   </synopsis>
-  <links type="topic" ui:expanded="yes"
-         api:type="function" api:mime="text/x-python"
-         groups="constructor" style="linklist">
-    <title>Constructors</title>
-  </links>
+  <p>Constructor</p>
+  <synopsis><code mime="text/x-python">
+repository = Repository()  </code></synopsis>
   <links type="topic" ui:expanded="yes"
          api:type="function" api:mime="text/x-python"
          groups="method" style="linklist">
-- 
cgit v1.2.1