From 6293afcb4e10997838f94c38430feba9742bea75 Mon Sep 17 00:00:00 2001 From: Mark Rowe Date: Wed, 20 Aug 2025 11:51:43 -0400 Subject: Clarify the documentation on how multiple symbols at the same address are handled --- python/binaryview.py | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'python/binaryview.py') diff --git a/python/binaryview.py b/python/binaryview.py index e0c6cf10..d516c054 100644 --- a/python/binaryview.py +++ b/python/binaryview.py @@ -6410,7 +6410,8 @@ class BinaryView: ``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 @@ class BinaryView: """ ``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 @@ class BinaryView: """ ``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 -- cgit v1.3.1