From owner-freebsd-doc@FreeBSD.ORG Tue Feb 4 01:25:26 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 11835410 for ; Tue, 4 Feb 2014 01:25:26 +0000 (UTC) Received: from nm23-vm4.access.bullet.mail.gq1.yahoo.com (nm23-vm4.access.bullet.mail.gq1.yahoo.com [216.39.63.111]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C39E51CA9 for ; Tue, 4 Feb 2014 01:25:25 +0000 (UTC) Received: from [216.39.60.174] by nm23.access.bullet.mail.gq1.yahoo.com with NNFMP; 04 Feb 2014 01:25:25 -0000 Received: from [216.39.60.245] by tm10.access.bullet.mail.gq1.yahoo.com with NNFMP; 04 Feb 2014 01:25:25 -0000 Received: from [127.0.0.1] by omp1016.access.mail.gq1.yahoo.com with NNFMP; 04 Feb 2014 01:25:25 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 215661.7093.bm@omp1016.access.mail.gq1.yahoo.com Received: (qmail 43659 invoked by uid 60001); 4 Feb 2014 01:25:25 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s1024; t=1391477125; bh=qpQV7Nd5PF6KqPczfL4BKrZ3RhLdqMY9K46GlnHa9EY=; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:References:Message-ID:Date:From:Reply-To:Subject:To:Cc:In-Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding; b=pp4q/VoKgj3NB3ZFaV2mxJKbDyfHUzafpqV1S6IJjcsJhJG/aqVljAoRtpYz5FcfRhBgCNkhaHfSzpEQcGoYk65VqtsXKMR5PF8U7AOPGHXKm76fSDpVKiUWTaEu+YojdYCuIx1tFN3b9dcloqDTN0vZPkpNpbpLS4PHoH2HHSw= DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=att.net; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:References:Message-ID:Date:From:Reply-To:Subject:To:Cc:In-Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding; b=CbcH6oLMZGOJuUlWFwNHJgBqJxsIKszvzdIA6Piac9Ro80URdYSq8iNpDyQVomOIAu7wKoG/n80xzkCKsvTXuvA/UCAiPZP6KeewbWJtDatxufFlckM0+pc4cIsjkz0tp1TjpElXszjZrpGuPCyY7F3SGQnk/YU6H/0YHO/iGkk=; X-YMail-OSG: 2zHteHQVM1l4gQauJdC2QmUecHp0ji.DXFwIUTqpohpp5bc zpabnZdsZxEvYJ9xnnVmdWiRRDkq5jI1.v0oZ_Gfu1z8k3ZtdgUh87xC6GLs 4KmpAp1Dc8mOFYEWThDU8MQAxNEpzakXmEpibPnZfz..BeTAoZrXjJQQPqZI uWhZct0dF8kBN7qkjTw7rDxuwm7y62n94AFrc2CvdNeN37xi6yXuX7wmuEQj GEJI_NXRHO2RQrD1Q1ENAY6iimFaZM6.BIkJbCeaHke9VjAA3bCOVtxXROjm 8tSzJUkHA9PQ3K8YB5iM7cegGLG_Hv5sKwU0qO0VYN7mpObBkPiq.M8Br2.U dSZAewxnsmQEBwEYVHTpsu7bgvX77zns39544zR09s88oxYoX6_XGG_ZU4xX 3DZONa5wiCw7M9RFHX4ikU4L5k0bJsrZq7Ecjj2XWXFgOEau8gCM7xz93jrl fJ_eQMZgjxXPUoofo6Ul4pK6htDvEcgZpybufjclUxikUUAiq8M8DGX7ImTe lBIheJhG1fdWjCSBB_UuMHiThvpnJuSmH5sRnz0NyeGQ6DpqgSo6PQg46xZZ X Received: from [99.98.83.69] by web184906.mail.gq1.yahoo.com via HTTP; Mon, 03 Feb 2014 17:25:25 PST X-Rocket-MIMEInfo: 002.001, Cgo.PiBDdXJyZW50bHksIHRoZXJlIGFyZSAyIEhhbmRib29rIHNlY3Rpb25zIHRoYXQgZGVhbCB3aXRoIHVwZ3JhZGluZyBwb3J0czoKPj4gCj4.IDUuNi4zLiBVcGdyYWRpbmcgUG9ydHPCoCAod2hpY2ggZGVzY3JpYmVzIHRoZSB1c2Ugb2YgdGhlIHBvcnRtYXN0ZXIgYW5kIHBvcnR1cGdyYWRlIHBvcnRzKQo.PiAKPj4gYW5kCj4.IAo.PiAyMy4zLiBQb3J0c25hcDogYSBQb3J0cyBDb2xsZWN0aW9uIFVwZGF0ZSBUb29sICh3aGljaCBkZXNjcmliZXMgdGhlIGJ1aWx0LWluIHBvcnRzbmFwKQo.PiAKPj4gSSABMAEBAQE- X-Mailer: YahooMailWebService/0.8.174.629 References: <1391476255.71576.YahooMailNeo@web184905.mail.gq1.yahoo.com> <20140204012007.GZ1766@glenbarber.us> Message-ID: <1391477125.13219.YahooMailNeo@web184906.mail.gq1.yahoo.com> Date: Mon, 3 Feb 2014 17:25:25 -0800 (PST) From: Dru Lavigne Subject: Re: updating ports To: Glen Barber In-Reply-To: <20140204012007.GZ1766@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Cc: "freebsd-doc@freebsd.org" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: Dru Lavigne List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 Feb 2014 01:25:26 -0000 =0A=0A>> Currently, there are 2 Handbook sections that deal with upgrading = ports:=0A>> =0A>> 5.6.3. Upgrading Ports=A0 (which describes the use of the= portmaster and portupgrade ports)=0A>> =0A>> and=0A>> =0A>> 23.3. Portsnap= : a Ports Collection Update Tool (which describes the built-in portsnap)=0A= >> =0A>> I would like to combine these into 5.6.3.=0A>> =0A>> Do we want to= encourage the use of third-party utils or just encourage the use of the bu= ilt in one?=0A>> =0A>=0A>I think there are two separate topics here (withou= t having looked at the=0A>Handbook sections yet).=A0 I don't think portmast= er and portupgrade=0A>actually handle updating the ports tree itself, but h= andle=0A>upgrading/rebuilding ports within the ports tree.=0A>=0A>Portsnap,= on the other hand, does not actually touch the software=0A>installed (mean= ing, it does not update the installed third-party=0A>software), but only ha= ndles updating the ports tree sources themselves.=0A>=0A>> If just the buil= t in one, I'll replace 5.6.3 with the contents of 23.3 and reduce portmaste= r/portupgrade to a note that these utils are available in the ports collect= ion.=0A>> =0A>> If we should describe all three, I'll place 23.3 as the fir= st utility to be described in 5.6.3.=0A=0A=0A=0AGood 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.=0A=0ACheers,=0A=0ADru=0A