From 0c3985c05fb8628bc03861eca7fb6133114fc976 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Grisez?=
 <francois.grisez@belledonne-communications.com>
Date: Fri, 21 Apr 2017 15:44:17 +0200
Subject: [PATCH] Generate the docstrings for the enums and enum values

---
 wrappers/cpp/enums_header.mustache | 15 +++++++++++++++
 wrappers/cpp/genwrapper.py         | 14 +++++++-------
 2 files changed, 22 insertions(+), 7 deletions(-)

diff --git a/wrappers/cpp/enums_header.mustache b/wrappers/cpp/enums_header.mustache
index 4480d04c1..1eff69b46 100644
--- a/wrappers/cpp/enums_header.mustache
+++ b/wrappers/cpp/enums_header.mustache
@@ -22,8 +22,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 namespace linphone {
 	
 	{{#enums}}
+	{{#doc}}
+	/**
+	{{#lines}}
+	 * {{{line}}}
+	{{/lines}}
+	 * 
+	 */
+	{{/doc}}
 	enum {{name}} {
 		{{#values}}
+		{{#doc}}
+		/**
+		{{#lines}}
+		 * {{{line}}}
+		{{/lines}}
+		 */
+		{{/doc}}
 		{{name}}{{#value}} = {{{value}}}{{/value}}{{#notLast}},{{/notLast}}
 		{{/values}}
 	};
diff --git a/wrappers/cpp/genwrapper.py b/wrappers/cpp/genwrapper.py
index 34ffd641d..2c11f967e 100755
--- a/wrappers/cpp/genwrapper.py
+++ b/wrappers/cpp/genwrapper.py
@@ -35,27 +35,28 @@ class CppTranslator(object):
 	def __init__(self):
 		self.ignore = []
 		self.ambigousTypes = ['LinphonePayloadType']
+		self.docTranslator = metadoc.DoxygenCppTranslator()
 	
 	def is_ambigous_type(self, _type):
 		return _type.name in self.ambigousTypes or (_type.name == 'list' and self.is_ambigous_type(_type.containedTypeDesc))
 	
-	@staticmethod
-	def translate_enum(enum):
+	def translate_enum(self, enum):
 		enumDict = {}
 		enumDict['name'] = enum.name.to_camel_case()
+		enumDict['doc'] = self.docTranslator.translate(enum.briefDescription)
 		enumDict['values'] = []
 		i = 0
 		for enumValue in enum.values:
-			enumValDict = CppTranslator.translate_enum_value(enumValue)
+			enumValDict = self.translate_enum_value(enumValue)
 			enumValDict['notLast'] = (i != len(enum.values)-1)
 			enumDict['values'].append(enumValDict)
 			i += 1
 		return enumDict
 	
-	@staticmethod
-	def translate_enum_value(enumValue):
+	def translate_enum_value(self, enumValue):
 		enumValueDict = {}
 		enumValueDict['name'] = CppTranslator.translate_enum_value_name(enumValue.name)
+		enumValueDict['doc'] = self.docTranslator.translate(enumValue.briefDescription)
 		if type(enumValue.value) is int:
 			enumValueDict['value'] = str(enumValue.value)
 		elif type(enumValue.value) is AbsApi.Flag:
@@ -241,8 +242,7 @@ class CppTranslator(object):
 			methodDict['implPrototype'] = '{implReturn} {longname}({implParams}){const}'.format(**methodElems)
 			methodDict['sourceCode' ] = self._generate_source_code(method, usedNamespace=namespace)
 		
-		t = metadoc.DoxygenCppTranslator()
-		methodDict['doc'] = t.translate(method.briefDescription) if method.briefDescription is not None else None
+		methodDict['doc'] = self.docTranslator.translate(method.briefDescription) if method.briefDescription is not None else None
 		
 		return methodDict