From owner-freebsd-doc  Wed Jun 14 17:20: 6 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id B89A637BB78
	for <freebsd-doc@freebsd.org>; Wed, 14 Jun 2000 17:20:00 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id RAA72530;
	Wed, 14 Jun 2000 17:20:00 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
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
X-Send-Pr-Version: 3.2
Subject: docs/19278: Change to Respect CLFAGS portion of Porters Handbook
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         19278
>Category:       docs
>Synopsis:       Change to Respect CLFAGS portion of Porters Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 14 17:20:00 PDT 2000
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message