binman: Add missing comments toentry
authorSimon Glass <sjg@chromium.org>
Mon, 8 Jul 2019 19:18:30 +0000 (13:18 -0600)
committerSimon Glass <sjg@chromium.org>
Wed, 24 Jul 2019 03:27:57 +0000 (20:27 -0700)
At present GetOffsets() lacks a function comment. Add one.

Signed-off-by: Simon Glass <sjg@chromium.org>
tools/binman/entry.py

index d842d89dd665ffc27710cdf273065413ad6f2963..e8d0adec1e97f762ca1c3559dc13c2e0b8153f61 100644 (file)
@@ -355,6 +355,21 @@ class Entry(object):
         return self.data
 
     def GetOffsets(self):
+        """Get the offsets for siblings
+
+        Some entry types can contain information about the position or size of
+        other entries. An example of this is the Intel Flash Descriptor, which
+        knows where the Intel Management Engine section should go.
+
+        If this entry knows about the position of other entries, it can specify
+        this by returning values here
+
+        Returns:
+            Dict:
+                key: Entry type
+                value: List containing position and size of the given entry
+                    type.
+        """
         return {}
 
     def SetOffsetSize(self, pos, size):