From owner-freebsd-ports Mon Feb 17 6:31:27 2003 Delivered-To: freebsd-ports@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1CF0837B401 for ; Mon, 17 Feb 2003 06:31:24 -0800 (PST) Received: from straylight.ringlet.net (office.sbnd.net [217.75.140.130]) by mx1.FreeBSD.org (Postfix) with SMTP id EABC343FA3 for ; Mon, 17 Feb 2003 06:31:17 -0800 (PST) (envelope-from roam@ringlet.net) Received: (qmail 59725 invoked by uid 1000); 17 Feb 2003 14:29:59 -0000 Date: Mon, 17 Feb 2003 16:29:59 +0200 From: Peter Pentchev To: doc@FreeBSD.org Cc: ports@FreeBSD.org Subject: [CFR] Add a warning about the ports-base CVSup subcollection Message-ID: <20030217142959.GL377@straylight.oblivion.bg> Mail-Followup-To: doc@FreeBSD.org, ports@FreeBSD.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ai3I8gwHc37+ASRI" Content-Disposition: inline User-Agent: Mutt/1.5.3i Sender: owner-freebsd-ports@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --ai3I8gwHc37+ASRI Content-Type: text/plain; charset=windows-1251 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, This is something that has popped up every so often on the mailing lists, and a blurb has been added to the ports-supfile example in the source tree. However, there are still people who do not realize the full importance of updating the ports-base subcollection; here is a patch to the Handbook and the FAQ that will hopefully bring their number down even more. As usual, any comments, suggestions, and flames are welcome. G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@sbnd.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 If I had finished this sentence, Index: doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgm= l,v retrieving revision 1.270 diff -u -r1.270 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml 17 Feb 2003 11:= 26:45 -0000 1.270 +++ doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml 17 Feb 2003 14:= 19:32 -0000 @@ -2526,6 +2526,26 @@ The FreeBSD Ports Collection. =20 + + If you do not want to update the whole of + ports-all (the whole ports tree), + but use one of the subcollections listed below, + make sure that you always update + the ports-base subcollection! + Whenever something changes in the ports build + infrastructure represented by + ports-base, it is virtually certain + that those changes will be used by real + ports real soon. Thus, if you only update the + real ports and they use some of the new + features, there is a very high chance that their build + will fail with some mysterious error message. The + very first thing to do in this + case is to make sure that your + ports-base subcollection is up to + date. + + =20 ports-archivers @@ -2559,8 +2579,20 @@ release=3Dcvs =20 - Miscellaneous files at the top of - /usr/ports. + The Ports Collection build infrastructure - + various files located in the + Mk/ and + Tools/ subdirectories of + /usr/ports. + + + Please see the important + warning above: you should + always update this + subcollection, whenever you update any part of + the FreeBSD Ports Collection! + =20 Index: doc/en_US.ISO8859-1/books/faq/book.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v retrieving revision 1.510 diff -u -r1.510 book.sgml --- doc/en_US.ISO8859-1/books/faq/book.sgml 24 Jan 2003 22:16:02 -0000 1.510 +++ doc/en_US.ISO8859-1/books/faq/book.sgml 17 Feb 2003 14:19:44 -0000 @@ -5178,6 +5178,26 @@ connection. + + + + I updated parts of the Ports Collection using CVSup, and + now many ports fail to build with mysterious error messages! + What happened? Is the Ports Collection broken in some major + way? + + + + If you only update parts of the Ports Collection, using + one of its CVSup subcollections and not the + ports-all CVSup collection, you should + always update the + ports-base subcollection too! The reasons + are described in the + Handbook. + + =20 --ai3I8gwHc37+ASRI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+UPHm7Ri2jRYZRVMRAmbjAJ9tPmO0AKBDarUGBlMd+LiqPve55QCfbVrB T+E55hIs/8IS7zIQ4Qc8Qpg= =s0ZH -----END PGP SIGNATURE----- --ai3I8gwHc37+ASRI-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-ports" in the body of the message