[gtk-doc/actions] fixup! mkdb: Generate sections for actions

[Matthias Clasen <matthiasc src gnome org>]

commit 446a615679df167cedaf4738c5cccb8ed8a0c09a
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jun 24 14:01:00 2019 +0000

    fixup! mkdb: Generate sections for actions
    
    Add a comment explaining why . was added to the regexp
    for identifying symbols in doc comments.

 gtkdoc/mkdb.py | 9 +++++++++
 1 file changed, 9 insertions(+)
---
diff --git a/gtkdoc/mkdb.py b/gtkdoc/mkdb.py
index 8a9e6e3..f3bdf81 100644
--- a/gtkdoc/mkdb.py
+++ b/gtkdoc/mkdb.py
@@ -3899,6 +3899,15 @@ def SegmentCommentBlock(lines, line_number=0, ifile=''):
         logging.info("scanning[%s] :%s", in_part, line.strip())
 
         # If we haven't found the symbol name yet, look for it.
+        # We need to allow for the following cases:
+        # function:
+        # Class::signal:
+        # Class:property:
+        # Class|action:
+        # Signal and property names can contain dashes, action names
+        # can contain period.
+        # In all cases, there might be annotations in parentheses
+        # following the symbol name.
         if not symbol:
             m1 = re.search(r'^\s*((SECTION|PROGRAM):\s*\S+)', line)
             m2 = re.search(r'^\s*([\w:.|-]*\w)\s*:?\s*(\(.+?\)\s*)*$', line)