diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index ad646ece5e..9878324c28 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -3993,6 +3993,12 @@ LDCONFIG_DIRS=  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
 	  library should have their <makevar>PORTREVISION</makevar> incremented,
 	  to force recompilation with the new library version.</para>
 
+	<para>If the port installs shared libraries with long version numbers,
+	  e.g. <filename>libfoo.so.0.2.9</filename>, the ports infrastructure
+	  will try to rename the files.  Define
+	  <makevar>NO_FILTER_SHLIBS</makevar> to disable this
+	  functionality.</para>
+
       </sect1>
 
     <sect1 id="porting-restrictions">