From zach@pabst.bendnet.com  Wed Jun 14 17:10:59 2000
Return-Path: <zach@pabst.bendnet.com>
Received: from pabst.bendnet.com (pabst.bendnet.com [199.2.205.10])
	by hub.freebsd.org (Postfix) with ESMTP id 10B9737B87A
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 14 Jun 2000 17:10:50 -0700 (PDT)
	(envelope-from zach@pabst.bendnet.com)
Received: (from zach@localhost)
	by pabst.bendnet.com (8.9.3/8.9.3) id RAA92276;
	Wed, 14 Jun 2000 17:19:35 GMT
	(envelope-from zach)
Message-Id: <200006141719.RAA92276@pabst.bendnet.com>
Date: Wed, 14 Jun 2000 17:19:35 GMT
From: zach@pabst.bendnet.com
Reply-To: zach@pabst.bendnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: Change to Respect CLFAGS portion of Porters Handbook
X-Send-Pr-Version: 3.2

>Number:         19278
>Category:       docs
>Synopsis:       Change to Respect CLFAGS portion of Porters Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 14 17:20:00 PDT 2000
>Closed-Date:    Thu Jun 15 17:04:45 PDT 2000
>Last-Modified:  Thu Jun 15 17:05:04 PDT 2000
>Originator:     Zach Zurflu
>Release:        FreeBSD 3.4-STABLE i386
>Organization:
>Environment:

	

>Description:

The portion of the Porters Handbook titled Respect CFLAGS is too
brief. The unexperienced user can not understand what it means.

>How-To-Repeat:

	

>Fix:

--- x1663.html.orig	Wed Jun 14 14:40:59 2000
+++ x1663.html	Wed Jun 14 16:39:23 2000
@@ -45,6 +45,28 @@
       CFLAGS</tt> variable. If it does not, please add <tt class= 
       "LITERAL">NO_PACKAGE=ignores cflags</tt> to the <tt class= 
       "FILENAME">Makefile</tt>.</p>
+
+      <p>An example of a Makefile respecting the
+      <tt class="MAKEVAR">CFLAGS</tt> variable <B>(note the 
+      <tt class="MAKEVAR">+=</tt></B>):</p>
+
+<pre class="PROGRAMLISTING">
+    CFLAGS += -Wall -Werror
+</pre>
+
+      <p>An example of a Makefile which does not respect the
+      <tt class="MAKEVAR">CFLAGS</tt> variable:</p>
+
+<pre class="PROGRAMLISTING">
+    CFLAGS = -Wall -Werror
+</pre>
+
+      <p>The <tt class="MAKEVAR">CFLAGS</tt> variable is defined on
+      FreeBSD systems in /etc/make.conf. The first example appends
+      additional flags to the <tt class="MAKEVAR">CFLAGS</tt> 
+      variable, preserving any system wide definitions. The second 
+      example clobbers anything previously defined.</p>
+
     </div>
 
     <div class="NAVFOOTER">

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Thu Jun 15 17:04:45 PDT 2000 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=19278 
>Unformatted:
