From 7c2ec44f81e001e67d82fa1fc5f21206fa9fc8f0 Mon Sep 17 00:00:00 2001
From: Jim Mock <jim@FreeBSD.org>
Date: Fri, 16 Jun 2000 00:04:01 +0000
Subject: [PATCH] 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>
---
 .../books/porters-handbook/book.sgml          | 20 ++++++++++++++++++-
 .../books/porters-handbook/book.sgml          | 20 ++++++++++++++++++-
 2 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 7442a95d3f..9ee4cefd18 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -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>
diff --git a/en_US.ISO_8859-1/books/porters-handbook/book.sgml b/en_US.ISO_8859-1/books/porters-handbook/book.sgml
index 7442a95d3f..9ee4cefd18 100644
--- a/en_US.ISO_8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO_8859-1/books/porters-handbook/book.sgml
@@ -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>