Document the rule for keeping static and shared archs in sync

1 files changed, 8 insertions, 0 deletions

diff --git a/lib/libc/Symbols.list b/lib/libc/Symbols.list
index c74a51b4d17..8b964f0f0d0 100644
--- a/lib/libc/Symbols.list
+++ b/lib/libc/Symbols.list
@@ -1,3 +1,11 @@
+/*
+ * In order to guarantee that static and shared archs see the same "public"
+ * symbols, this file should always include all the non-static symbols that
+ * are in the application namespace.  So, if a symbol starts with a letter,
+ * don't delete it from here without either making it static or renaming it
+ * to have a leading underbar.
+ */
+
 /* symbols that no one should be using currently */
 _init
 _fini