ports/145629: lang/php5-5.3.2 : information in /usr/ports/UPDATING misleading for upgrade

[Jesco Freund]

>Number:         145629
>Category:       ports
>Synopsis:       lang/php5-5.3.2 : information in /usr/ports/UPDATING misleading for upgrade
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Apr 11 15:50:01 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Jesco Freund
>Release:        FreeBSD 8.0-RELEASE-p2
>Organization:
>Environment:
FreeBSD atuan.my-universe.com 8.0-RELEASE-p2 FreeBSD 8.0-RELEASE-p2 #0: Thu Jan  7 10:59:36 CET 2010     root at atuan.my-universe.com:/usr/obj/usr/src/sys/EARTHSEA  amd64
>Description:
/usr/ports/UPDATING states to delete deprecated packages (namely php5-dbase, php5-ncurses, php5-pcre, php5-spl, php5-ming, php5-mhash) and then to "Rebuild php5 and all ports depending on it."

This looks as if one could just delete the specified packages and then proceed using portmaster or portupgrade. However, this results repeatedly in a mess with missing header files (namely php_pcre.h).
>How-To-Repeat:

>Fix:
I suggest to make that second point a bit more clear by pointing out that lang/php5 has to be upgraded before any other php5 stuff. I say this because port utilities like portmaster do not properly stick to that order, resulting in missing header files now moved to lang/php5 which are required for building extensions like security/php5-filter or similar.

>Release-Note:
>Audit-Trail:
>Unformatted: