From b7472a1d79025473b9f15b4cf27e56113aae3eb1 Mon Sep 17 00:00:00 2001 From: Victor Toso Date: Fri, 22 Apr 2022 21:23:41 +0200 Subject: [PATCH] scripts: apibuild: parse 'Since' for macros This patch adds 'version' parameter to the generated XML API for macros It'll require, for new additions, to add a comment with the version that the macro was added. An example bellow of code diff and the change in the generated XML. Note that the Since tag is removed from the comment as there is a proper field for it in the XML. Signed-off-by: Victor Toso Reviewed-by: Andrea Bolognani --- scripts/apibuild.py | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/scripts/apibuild.py b/scripts/apibuild.py index 116ea9fe5f..c6d63ecff8 100755 --- a/scripts/apibuild.py +++ b/scripts/apibuild.py @@ -2266,11 +2266,15 @@ class docBuilder: output.write(" string='%s'" % strValue) else: output.write(" raw='%s'" % escape(rawValue)) + + (since, comment) = self.retrieve_comment_tags(name, desc) + if len(since) > 0: + output.write(" version='%s'" % escape(since)) output.write(">\n") - if desc is not None and desc != "": - output.write(" \n" % (desc)) - self.indexString(name, desc) + if comment is not None and comment != "": + output.write(" \n" % (comment)) + self.indexString(name, comment) for arg in args: (name, desc) = arg if desc is not None and desc != "":