docs/95644: Document variable NO_FILTER_SHLIBS in the porter's handbook

[Jean-Baptiste Quenot]

>Number:         95644
>Category:       docs
>Synopsis:       Document variable NO_FILTER_SHLIBS in the porter's handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 12 10:10:16 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Jean-Baptiste Quenot
>Release:        FreeBSD 5.5-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD vision.anyware 5.5-PRERELEASE FreeBSD 5.5-PRERELEASE #1: Thu Mar 9 19:20:53 CET 2006 jbq at vision.anyware:/usr/obj/usr/src/sys/VISION i386
>Description:
There is no description of NO_FILTER_SHLIBS in the porter's handbook located at
doc/en_US.ISO8859-1/books/porters-handbook/book.sgml.  The explanation below was
provided by Joerg Pulz <Joerg.Pulz at frm2.tum.de>.  Thanks in advance!
>How-To-Repeat:
>Fix:
--- book.sgml.orig	Wed Apr 12 11:47:20 2006
+++ book.sgml	Wed Apr 12 11:56:24 2006
@@ -3993,6 +3993,14 @@
 	  library should have their <makevar>PORTREVISION</makevar> incremented,
 	  to force recompilation with the new library version.</para>
 
+  <note>
+    <para>In FreeBSD, all libraries normally have only a major version number.
+      If your port installs shared libraries with long names (e.g.
+      lib<name>.so.<major>.<minor>.<patchlevel>), it may be
+      desirable to set <literal>NO_FILTER_SHLIBS=yes</literal> to prevent any
+      shared library name modification (e.g.  minor number removal) by the ports
+      infrastructure.</para>
+  </note>
       </sect1>
 
     <sect1 id="porting-restrictions">
>Release-Note:
>Audit-Trail:
>Unformatted: