[devhelp] parser: add comment about possible things to do for version 3



commit ad6530676f1cf845ccfe2b49939847e9b9e90460
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Fri May 12 14:31:13 2017 +0200

    parser: add comment about possible things to do for version 3

 src/dh-parser.c |    7 +++++++
 1 files changed, 7 insertions(+), 0 deletions(-)
---
diff --git a/src/dh-parser.c b/src/dh-parser.c
index 618855e..ac2e641 100644
--- a/src/dh-parser.c
+++ b/src/dh-parser.c
@@ -26,6 +26,13 @@
 #include "dh-link.h"
 #include "dh-util.h"
 
+/* Possible things to do for the version 3 of the Devhelp index file format (if
+ * one day there is a strong desire to create a new version):
+ * - Replace <functions> element by <keywords>.
+ * - Maybe have an up-to-date URI for the NAMESPACE (an URI to the git repo?
+ *   probably more stable than the web site).
+ */
+
 /* It's the xmlns attribute. It is currently (well, in 2015 at least) used on
  * developer.gnome.org to look for <keyword> elements attached to that
  * namespace.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]