updating ports

[Dru Lavigne]

>> Currently, there are 2 Handbook sections that deal with upgrading ports:
>> 
>> 5.6.3. Upgrading Ports  (which describes the use of the portmaster and portupgrade ports)
>> 
>> and
>> 
>> 23.3. Portsnap: a Ports Collection Update Tool (which describes the built-in portsnap)
>> 
>> I would like to combine these into 5.6.3.
>> 
>> Do we want to encourage the use of third-party utils or just encourage the use of the built in one?
>> 
>
>I think there are two separate topics here (without having looked at the
>Handbook sections yet).  I don't think portmaster and portupgrade
>actually handle updating the ports tree itself, but handle
>upgrading/rebuilding ports within the ports tree.
>
>Portsnap, on the other hand, does not actually touch the software
>installed (meaning, it does not update the installed third-party
>software), but only handles updating the ports tree sources themselves.
>
>> If just the built in one, I'll replace 5.6.3 with the contents of 23.3 and reduce portmaster/portupgrade to a note that these utils are available in the ports collection.
>> 
>> If we should describe all three, I'll place 23.3 as the first utility to be described in 5.6.3.



Good catch...and I see that portsnap is already covered in Procedure 5.1 of section 5.6. I'll submit a patch some time this week.

Cheers,

Dru