pkg/29570: pkgsrc.txt's instructions about shared libs and PLISTs need a reality check

[bad%bsd.de@localhost]

>Number:         29570
>Category:       pkg
>Synopsis:       the documentation about what entries to place into the PLIST 
>for shared libraries ist just plain wrong.
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Mar 01 22:30:00 +0000 2005
>Originator:     Christoph Badura
>Release:        pkgsrc-current as of 2005-02-28
>Organization:
>Environment:
>Description:
Section 12.3.1 contains the following lines:

    In the PLIST, include all of the .a, .la, and .so, .so.major and .so.major.
    minor files.

 7. In your PLIST, include all of the .a, .la, and .so, .so.CURRENT and
    .so.CURRENT.REVISION files (this is a change from the previous behaviour).

Doing so is bad advice. It leads to complaints from pkg_create about
.so.major, .so.major.minor etc. files being overwritten in the binary
package. It also leads to complaints from pkg_delete about said files
"not really existing" because they are removed twice.

>How-To-Repeat:
        
>Fix:
Replace with documentation that does't come from a parallel universe.