[MacPorts] #48909: Updating the documentation and guide to make clear that port upgrade outdated is the recommended method.

[MacPorts]

#48909: Updating the documentation and guide to make clear that port upgrade
outdated is the recommended method.
-------------------------+--------------------------------
 Reporter:  aszostak@…   |      Owner:  macports-tickets@…
     Type:  enhancement  |     Status:  new
 Priority:  Normal       |  Milestone:
Component:  contrib      |    Version:  2.3.99
 Keywords:               |       Port:
-------------------------+--------------------------------
 Currently the documentation in the manpages and guide give a false
 impression to inexperienced users that upgrading a single port is always a
 safe operation. After a discussion on the mailing list it has become
 apparent that this is not the case. The only really safe and recommended
 upgrade method is "port upgrade outdated" and should be used by most
 users.

 The attached patch contains suggested modifications to the documentation
 code base that would make this explicit to inexperienced users reading the
 manpage or online guide.

-- 
Ticket URL: <https://trac.macports.org/ticket/48909>
MacPorts <https://www.macports.org/>
Ports system for OS X