diff options
author | Tomeu Vizoso <tomeu.vizoso@collabora.co.uk> | 2011-08-12 17:16:35 +0200 |
---|---|---|
committer | Tomeu Vizoso <tomeu.vizoso@collabora.co.uk> | 2011-08-12 17:16:35 +0200 |
commit | 62d306b024921e6bfb48562a34a4e21b1f497bde (patch) | |
tree | a3dbc46735bddafc603eebc9a7f66b267e5a4842 /giscanner | |
parent | f2e5ba882e22f5fe7b1db408da7da419391d7965 (diff) | |
download | gobject-introspection-62d306b024921e6bfb48562a34a4e21b1f497bde.tar.gz |
g-ir-doctool: Add annotations (some)
Diffstat (limited to 'giscanner')
-rw-r--r-- | giscanner/docbookwriter.py | 38 |
1 files changed, 34 insertions, 4 deletions
diff --git a/giscanner/docbookwriter.py b/giscanner/docbookwriter.py index 222942fa..d3910765 100644 --- a/giscanner/docbookwriter.py +++ b/giscanner/docbookwriter.py @@ -147,15 +147,34 @@ class DocBookFormatter(object): self._render_parameters(method, method.parameters) self._writer.enable_whitespace() + def _get_annotations(self, argument): + annotations = {} + + if hasattr(argument.type, 'element_type') and \ + argument.type.element_type is not None: + annotations['element-type'] = argument.type.element_type + + if argument.transfer is not None and argument.transfer != 'none': + annotations['transfer'] = argument.transfer + + if hasattr(argument, 'allow_none') and argument.allow_none: + annotations['allow-none'] = None + + return annotations + def render_param_list(self, entity): method = entity.get_ast() - self._render_param(method.parent_class.name.lower(), 'instance') + self._render_param(method.parent_class.name.lower(), 'instance', []) + for param in method.parameters: - self._render_param(param.argname, param.doc) - self._render_param('Returns', method.retval.doc) + self._render_param(param.argname, param.doc, + self._get_annotations(param)) + + self._render_param('Returns', method.retval.doc, + self._get_annotations(method.retval)) - def _render_param(self, argname, doc): + def _render_param(self, argname, doc, annotations): with self._writer.tagcontext('varlistentry'): with self._writer.tagcontext('term'): self._writer.disable_whitespace() @@ -170,6 +189,17 @@ class DocBookFormatter(object): with self._writer.tagcontext('listitem'): with self._writer.tagcontext('simpara'): self._writer.write_line(doc) + if annotations: + with self._writer.tagcontext('emphasis', [('role', 'annotation')]): + for key, value in annotations.iteritems(): + self._writer.disable_whitespace() + try: + self._writer.write_line('[%s' % key) + if value is not None: + self._writer.write_line(' %s' % value) + self._writer.write_line(']') + finally: + self._writer.enable_whitespace() def render_property(self, entity, link=False): prop = entity.get_ast() |