1 files changed, 67 insertions, 0 deletions
diff --git a/odk/docs/idl/wikilinks.py b/odk/docs/idl/wikilinks.py
new file mode 100644
index 000000000..7854f6450
--- /dev/null
+++ b/odk/docs/idl/wikilinks.py
@@ -0,0 +1,67 @@
+# -*- tab-width: 4; indent-tabs-mode: nil; py-indent-offset: 4 -*-
+#
+# This file is part of the LibreOffice project.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+#
+
+# wikilinks.py:
+# This throwaway program can be used to convert idl_chapter_refs.txt to a
+# "fake" IDL file that can be fed to doxygen to get the DevGuide Wiki links.
+
+import sys
+
+devguidewww = "http://wiki.openoffice.org/wiki/"
+in_topic = False
+link = None
+description = None
+allthings = {}
+allkinds = {}
+
+# unfortunately we need to know what kind of entity to declare...
+# generate this file like so:
+# solver/unxlngx6/bin/regview solver/unxlngx6/bin/types.rdb | grep -A1 "type class:" | awk '/type class:/ { class = $NF } /type name:/ { gsub("/", ".", $NF); gsub("\"", "", $NF); print class, $NF }' > /tmp/kinds
+for line in open("/tmp/kinds") :
+    (kind,_,name) = line.strip().partition(" ")
+    allkinds[name] = kind
+
+for line in sys.stdin :
+    sline = line.strip()
+    if sline.startswith("LINK:") :
+        link = sline.partition('LINK:')[2]
+    elif sline.startswith("DESCR:") :
+        description = sline.partition('DESCR:')[2]
+    elif sline == "TOPIC:" :
+        in_topic = True
+    elif in_topic :
+        if sline == "" :
+            in_topic = False
+        elif sline in allthings :
+            allthings[sline].append((link, description))
+        else:
+            allthings[sline] = [(link, description)]
+
+print("/* this file was generated from idl_chapter_refs.txt by wikilinks.py */")
+
+for key in allthings:
+    kind = allkinds[key]
+    parts = key.split(".")
+    print("\n")
+    for p in parts[0:-1] :
+        print("module", p, "{")
+    # for enums the "{}" trick results in broken/duplicate output
+    if kind == "enum" :
+        print("/// @" + kind, parts[-1])
+    print("/// @par Developers Guide")
+    for item in allthings[key] :
+        print("///      <a href=\"" + devguidewww + item[0] + "\">"
+                + item[1] + "</a><br>")
+    # doxygen does not have tags for e.g. @service but empty definition works
+    if kind != "enum" :
+        print(kind, parts[-1], "{}")
+    for p in parts[0:-1] :
+        print("};")
+
+# vim:set shiftwidth=4 softtabstop=4 expandtab: