From 940b4d1848e8c70ab7642901a68594e8016caffc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 18:51:28 +0200 Subject: Adding upstream version 1:7.0.4. Signed-off-by: Daniel Baumann --- odk/docs/idl/wikilinks.py | 67 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 odk/docs/idl/wikilinks.py (limited to 'odk/docs/idl/wikilinks.py') 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("/// " + + item[1] + "
") + # 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: -- cgit v1.2.3