summaryrefslogtreecommitdiff
path: root/giscanner/annotationparser.py
diff options
context:
space:
mode:
authorDieter Verfaillie <dieterv@optionexplicit.be>2013-07-18 07:27:14 +0200
committerDieter Verfaillie <dieterv@optionexplicit.be>2013-10-08 20:56:00 +0200
commita769acd93913cac8871b40c90fada1fbc7419c85 (patch)
tree9005bf6339439f2f4c601bb7f08ed8d087211372 /giscanner/annotationparser.py
parent35278b955304eb62565b5578b6848494721847bd (diff)
downloadgobject-introspection-a769acd93913cac8871b40c90fada1fbc7419c85.tar.gz
giscanner: merge _parse_comment_block() into parse_comment_block()
Diffstat (limited to 'giscanner/annotationparser.py')
-rw-r--r--giscanner/annotationparser.py26
1 files changed, 0 insertions, 26 deletions
diff --git a/giscanner/annotationparser.py b/giscanner/annotationparser.py
index 3c377c75..625ffdf8 100644
--- a/giscanner/annotationparser.py
+++ b/giscanner/annotationparser.py
@@ -1175,32 +1175,6 @@ class GtkDocCommentBlockParser(object):
# If we get this far, we must be inside something
# that looks like a GTK-Doc comment block.
- return self._parse_comment_block(comment_lines, filename, lineno)
-
- def _parse_comment_block(self, comment_lines, filename, lineno):
- """
- Parses a single GTK-Doc comment block already stripped from its
- comment start (/**) and comment end (*/) marker lines.
-
- :param comment_lines: list of (line_offset, line) tuples representing a
- GTK-Doc comment block already stripped from it's
- start (/**) and end (*/) marker lines
- :param filename: source file name where the comment block originated from
- :param lineno: line in the source file where the comment block starts
- :returns: a :class:`GtkDocCommentBlock` object or ``None``
-
- .. NOTE:: If you are tempted to refactor this method and split it
- further up (for example into _parse_identifier(), _parse_parameters(),
- _parse_description(), _parse_tags() methods) then please resist the
- urge. It is considered important that this method should be more or
- less easily comparable with gtkdoc-mkdb's `ScanSourceFile()`_ function.
-
- The different parsing steps are marked with a comment surrounded
- by `#` characters in an attempt to make it clear what is going on.
-
- .. _ScanSourceFile():
- http://git.gnome.org/browse/gtk-doc/tree/gtkdoc-mkdb.in#n3722
- """
comment_block = None
identifier_warned = False
part_indent = None