docs/129464: using packages system

[guillaume]

>Number:         129464
>Category:       docs
>Synopsis:       using packages system
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Dec 06 15:30:07 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     guillaume
>Release:        7.0
>Organization:
>Environment:
FreeBSD ordi1.guigui.net 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008     root at logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
in the FreeBSD handbook, 4.4 (Using the Packages System), pkg_add and pkg_delete are obsolete commands to manage packages. it's quasi-impossible to control requirements packages with these commands.
when a beginner read the handbook, he lost a lot of hours before he understand that (if, by miracle, he doesn't give up FreeBSD).
>How-To-Repeat:
see above.
>Fix:
the good commands are portupgrade and pkg_deinstall.
the portupgrade tool must be natively integrated in FreeBSD.

example of procedure:

1) it's better to have PACKAGESITE to the last stable branch by default, no?
2) install port collection with csup
3) clean database with pkgdb -aF (is it necessary after the port collection install?)
4) to install the xfce package: portinstall -RPP xfce
5) to upgrade the xfce package: portupgrade -RPP xfce
6) to delete the xfce package: pkg_deinstall -r xfce



PS: it's not convenient to install the port collection if one only use packages. a solution to this will be good for the future...

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