[devhelp] parser: add FIXME comment related to what gtk-doc generates

[Sébastien Wilmet <swilmet src gnome org>]

commit 0fdfb47a372ad5193486984187591e2fda3fcb09
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Fri May 12 15:01:11 2017 +0200

    parser: add FIXME comment related to what gtk-doc generates

 src/dh-parser.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/src/dh-parser.c b/src/dh-parser.c
index ac2e641..cb3fc95 100644
--- a/src/dh-parser.c
+++ b/src/dh-parser.c
@@ -373,6 +373,11 @@ parser_start_node_keyword (DhParser             *parser,
 
         /* Strip out trailing "() (handling variants with space or non-breaking
          * space before the parentheses).
+         *
+         * FIXME: gtk-doc still adds those parentheses. I thought that the code
+         * was needed to support the format version 1. Maybe gtk-doc should no
+         * longer add those trailing parentheses, since with the format version
+         * 2 we already know the link type.
          */
         if (g_str_has_suffix (name, "\xc2\xa0()")) {
                 name_to_free = g_strndup (name, strlen (name) - 4);