Date: Mon, 17 Feb 2003 16:29:59 +0200 From: Peter Pentchev <roam@ringlet.net> 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>
next in thread | raw e-mail | index | archive | help
--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 @@ <listitem> <para>The FreeBSD Ports Collection.</para> =20 + <important id=3D"cvsup-collec-pbase-warn"> + <para>If you do not want to update the whole of + <literal>ports-all</literal> (the whole ports tree), + but use one of the subcollections listed below, + make sure that you <emphasis>always</emphasis> update + the <literal>ports-base</literal> subcollection! + Whenever something changes in the ports build + infrastructure represented by + <literal>ports-base</literal>, it is virtually certain + that those changes will be used by <quote>real</quote> + ports real soon. Thus, if you only update the + <quote>real</quote> 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 + <emphasis>very first</emphasis> thing to do in this + case is to make sure that your + <literal>ports-base</literal> subcollection is up to + date.</para> + </important> + =20 <variablelist> <varlistentry> <term><literal>ports-archivers @@ -2559,8 +2579,20 @@ release=3Dcvs</literal></term> =20 <listitem> - <para>Miscellaneous files at the top of - /usr/ports.</para> + <para>The Ports Collection build infrastructure - + various files located in the + <filename>Mk/</filename> and + <filename>Tools/</filename> subdirectories of + <filename>/usr/ports</filename>.</para> + + <note> + <para>Please see the <link + linkend=3D"cvsup-collec-pbase-warn">important + warning above</link>: you should + <emphasis>always</emphasis> update this + subcollection, whenever you update any part of + the FreeBSD Ports Collection!</para> + </note> </listitem> </varlistentry> =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.</para> </answer> </qandaentry> + + <qandaentry> + <question id=3D"ports-base-update"> + <para>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?</para> + </question> + + <answer> + <para>If you only update parts of the Ports Collection, using + one of its CVSup subcollections and not the + <literal>ports-all</literal> CVSup collection, you should + <emphasis>always</emphasis> update the + <literal>ports-base</literal> subcollection too! The reasons + are described <ulink + url=3D"../handbook/cvsup.html#CVSUP-COLLEC-PBASE-WARN">in the + Handbook</ulink>.</para> + </answer> + </qandaentry> </qandaset> </chapter> =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-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030217142959.GL377>