Removing documentation (was: [Bug 206922] Handbook: Chapter 4.5+ changes)

[Warren Block]

On Sun, 7 Feb 2016, John Marino wrote:

>> I am not portmgr, but do use portmaster for updating ports on systems
>> running STABLE or HEAD. I still see no tool which provides the features of
>> portmaster. I also realize that this is far from a universal opinion.
>
> Please do an honest "fly-off" between ports-mgmt/portmaster and
> ports-mgmt/synth.  I would love to hear what signficant thing portmaster
> can do that Synth can't.  (honestly)

portmaster's one big feature has always been that it has no 
dependencies.  That was and is important.  One of the motivators for 
portmaster was portupgrade's Ruby and ruby-bdb dependencies, which often 
broke upgrades.

I have not tried Synth due to the Ada dependency, and so do not know if 
it has other portmaster-like abilities, like installing or upgrading a 
port from the command line with just an origin (portmaster devel/git) or 
whether it can build or upgrade a port or group of interdependent ports 
on the host system rather than in a chroot or jail.

> That's not the point.  The point is a sanctioned "official" tool is not
> maintained and my position is that is UNACCEPTABLE.  To be in the
> handbook it must be a hard requirement to be *ADEQUATELY* maintained.  I
> do not believe that requirement is being met today.

I have committed a change to the Handbook that rewords the portmaster 
entry.  It removes "recommended", replacing it with "smallest", and 
clarifies and simplifies some other text.