diff --git a/src/Makefile.shlib b/src/Makefile.shlib
index b8d25927b96b474d592fd9d1cfa505a10e3a47ed..2b2cd6b77bb3718c503f5e7d1e81503b3c5ec40e 100644
--- a/src/Makefile.shlib
+++ b/src/Makefile.shlib
@@ -6,7 +6,7 @@
 # Copyright (c) 1998, Regents of the University of California
 #
 # IDENTIFICATION
-#    $Header: /cvsroot/pgsql/src/Makefile.shlib,v 1.42 2001/02/10 17:17:39 momjian Exp $
+#    $Header: /cvsroot/pgsql/src/Makefile.shlib,v 1.43 2001/02/10 17:36:57 momjian Exp $
 #
 #-------------------------------------------------------------------------
 
@@ -109,6 +109,12 @@ ifeq ($(PORTNAME), darwin)
   LINK.shared		= $(COMPILER) $(CFLAGS_SL)
 endif
 
+# While the linker allows creation of most shared libraries,
+# -Bsymbolic requires resolution of all symbols, making the
+# compiler a better choice for shared library creation on BSD platforms.
+# With the linker, -Bsymbolic requires the crt1.o startup object file.
+# bjm 2001-02-10
+
 ifeq ($(PORTNAME), openbsd)
   shlib			:= lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION).$(SO_MINOR_VERSION)
   ifdef ELF_SYSTEM