Explain CFLAGS in a bit more detail. The previous mention was too brief

and could cause new users to not understand what is meant by respecting
CFLAGS.

PR:		19278
Submitted by:	Zach Zurflu <zach@pabst.bendnet.com>
This commit is contained in:
Jim Mock 2000-06-16 00:04:01 +00:00
parent 73c0ec61a4
commit 7c2ec44f81
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=7382
2 changed files with 38 additions and 2 deletions

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.105 2000/06/09 18:02:23 nik Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.106 2000/06/10 21:05:53 asmodai Exp $
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
@ -3092,6 +3092,24 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>The port should respect the <makevar>CFLAGS</makevar> variable.
If it does not, please add <literal>NO_PACKAGE=ignores
cflags</literal> to the <filename>Makefile</filename>.</para>
<para>An example of a <filename>Makefile</filename> respecting
the <makevar>CFLAGS</makevar> variable follows. Note the
<makevar>+=</makevar>:</para>
<programlisting>CFLAGS += -Wall -Werror</programlisting>
<para>Here is an example which does not respect the
<makevar>CFLAGS</makevar> variable:</para>
<programlisting>CFLAGS = -Wall -Werror</programlisting>
<para>The <makevar>CFLAGS</makevar> variable is defined on
FreeBSD systems in <filename>/etc/make.conf</filename>. The
first example appends additional flags to the
<makevar>CFLAGS</makevar> variable, preserving any system-wide
definitions. The second example clobbers anything previously
defined.</para>
</sect1>
<sect1>

View file

@ -1,7 +1,7 @@
<!--
The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.105 2000/06/09 18:02:23 nik Exp $
$FreeBSD: doc/en_US.ISO_8859-1/books/porters-handbook/book.sgml,v 1.106 2000/06/10 21:05:53 asmodai Exp $
-->
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN" [
@ -3092,6 +3092,24 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin</programlisting>
<para>The port should respect the <makevar>CFLAGS</makevar> variable.
If it does not, please add <literal>NO_PACKAGE=ignores
cflags</literal> to the <filename>Makefile</filename>.</para>
<para>An example of a <filename>Makefile</filename> respecting
the <makevar>CFLAGS</makevar> variable follows. Note the
<makevar>+=</makevar>:</para>
<programlisting>CFLAGS += -Wall -Werror</programlisting>
<para>Here is an example which does not respect the
<makevar>CFLAGS</makevar> variable:</para>
<programlisting>CFLAGS = -Wall -Werror</programlisting>
<para>The <makevar>CFLAGS</makevar> variable is defined on
FreeBSD systems in <filename>/etc/make.conf</filename>. The
first example appends additional flags to the
<makevar>CFLAGS</makevar> variable, preserving any system-wide
definitions. The second example clobbers anything previously
defined.</para>
</sect1>
<sect1>