[AMENDMENT 02/05/2003] encourage packagers to systematically prevent

[debian/debian-policy.git] / policy.sgml

diff --git a/policy.sgml b/policy.sgml
index a98b2309e0169dae4add9a24cee89509c7b6df2d..e19382911e8eb4e4f2a8888542806024a87fa731 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -6430,6 +6430,22 @@ endif
          the library compatible with LinuxThreads.
        </p>
 
+                                                                                
+         <p>                                                                    
+          Although not enforced by the build tools, shared libraries           
+          must be linked against all libraries that they use symbols from      
+          in the same way that binaries are.  This ensures the correct         
+          functioning of the <ref id="sharedlibs-shlibdeps">shlibs</ref>       
+          system and guarantees that all libraries can be safely opened        
+          with <tt>dlopen()</tt>.  Packagers may wish to use the gcc           
+          option <tt>-Wl,-z,defs</tt> when building a shared library.          
+          Since this option enforces symbol resolution at build time,          
+          a missing library reference will be caught early as a fatal          
+          build error.                                                         
+        </p>                                                                   
+                                                                               
+
+
        <p>
          All installed shared libraries should be stripped with
          <example compact="compact">