Clarify the documentation on how multiple symbols at the same address are handled

Author: bdash

binaryninjaapi.h

@@ -6689,16 +6689,20 @@ namespace BinaryNinja {
 
 		/*! Adds a symbol to the internal list of automatically discovered Symbol objects in a given namespace
 
-			\warning If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+			\warning If multiple symbols for the same address are defined, the most recently added symbol
+			with the highest confidence and lowest `BNSymbolType` value will be used.
 
 			\param sym Symbol to define
 		*/
 		void DefineAutoSymbol(Ref<Symbol> sym);
 
 		/*! Defines an "Auto" symbol, and a Variable/Function alongside it
 
+			\warning If multiple symbols for the same address are defined, the most recently added symbol
+			with the highest confidence and lowest `BNSymbolType` value will be used.
+
 			\param platform Platform for the Type being defined
-			\param sym Symbol being definedd
+			\param sym Symbol being defined
 			\param type Type being defined
 			\return The defined symbol
 		*/
@@ -6712,6 +6716,9 @@ namespace BinaryNinja {
 
 		/*! Define a user symbol
 
+			\warning If multiple symbols for the same address are defined, the most recently added symbol
+			with the highest confidence and lowest `BNSymbolType` value will be used.
+
 			\param sym Symbol to define
 		*/
 		void DefineUserSymbol(Ref<Symbol> sym);

python/binaryview.py

@@ -6410,7 +6410,8 @@ def define_auto_symbol(self, sym: '_types.CoreSymbol') -> None:
 		``define_auto_symbol`` adds a symbol to the internal list of automatically discovered Symbol objects in a given
 		namespace.
 
-		.. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+		.. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+		  highest confidence and lowest SymbolType value will ever be used.
 
 		:param sym: the symbol to define
 		:rtype: None
@@ -6423,7 +6424,8 @@ def define_auto_symbol_and_var_or_function(
 		"""
 		``define_auto_symbol_and_var_or_function`` Defines an "Auto" symbol, and a Variable/Function alongside it.
 
-		.. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+		.. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+		  highest confidence and lowest SymbolType value will ever be used.
 
 		:param sym: Symbol to define
 		:param type: Type for the function/variable being defined (can be None)
@@ -6465,7 +6467,8 @@ def define_user_symbol(self, sym: '_types.CoreSymbol') -> None:
 		"""
 		``define_user_symbol`` adds a symbol to the internal list of user added Symbol objects.
 
-		.. warning:: If multiple symbols for the same address are defined, only the most recent symbol will ever be used.
+		.. warning:: If multiple symbols for the same address are defined, only the most recently added symbol with the
+		  highest confidence and lowest SymbolType value will ever be used.
 
 		:param Symbol sym: the symbol to define
 		:rtype: None