Date: Fri, 13 Sep 2013 10:24:40 +0700 From: Alexey Dokuchaev <danfe@nsu.ru> To: doc@freebsd.org Subject: augment USE_GCC description in the porter's handbook Message-ID: <20130913032440.GA68665@regency.nsu.ru>
next in thread | raw e-mail | index | archive | help
--pWyiEgJYm5f9v55/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline hi, cooked something up, so people would get less confused about proper USE_GCC usage. diff attached. ./danfe --pWyiEgJYm5f9v55/ Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="use_gcc.diff" Index: book.xml =================================================================== --- book.xml (revision 42655) +++ book.xml (working copy) @@ -3822,10 +3822,11 @@ <filename>/etc/make.conf</filename>. For instance, setting</para> - <programlisting>USE_GCC=3.4</programlisting> + <programlisting>USE_GCC=X.Y</programlisting> - <para>would add a dependency on gcc34 for every port, - including gcc34 itself!</para> + <para>(where X.Y is version number) would add a dependency on + gccXY for every port, including <literal>lang/gccXY</literal> + itself!</para> </note> <table frame="none"> @@ -3856,17 +3857,23 @@ <row> <entry><makevar>USE_GCC</makevar></entry> - <entry>The port requires a specific version of - <command>gcc</command> to build. The exact version - can be specified with value such as - <literal>3.4</literal>. The minimal required - version can be specified as <literal>3.4+</literal>. - The <command>gcc</command> from the base system is - used when it satisfies the requested version, - otherwise an appropriate <command>gcc</command> is - compiled from ports and the <makevar>CC</makevar> - and <makevar>CXX</makevar> variables are - adjusted.</entry> + <entry>The port requires GCC (<command>gcc</command> or + <command>g++</command>) to build. Some ports need any + GCC version, some require modern, recent versions. It + is typically set to <literal>any</literal> (in this + case, GCC from base would be used on versions of &os; + that still have it, or <literal>lang/gcc</literal> port + would be installed when default C/C++ compiler is Clang); + or <literal>yes</literal> (means always use stable, modern + GCC from <literal>lang/gcc</literal> port). The exact + version can be also specified, with a value such as + <literal>4.7</literal>. The minimal required + version can be specified as <literal>4.6+</literal>. + The GCC from the base system is used when it satisfies + the requested version, otherwise an appropriate compiler + in built from the port, and the <makevar>CC</makevar> + and <makevar>CXX</makevar> variables are adjusted + accordingly.</entry> </row> </tbody> </tgroup> --pWyiEgJYm5f9v55/--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130913032440.GA68665>