From owner-svn-doc-all@FreeBSD.ORG  Sun Oct 14 15:48:06 2012
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id 75965C17;
 Sun, 14 Oct 2012 15:48:06 +0000 (UTC)
 (envelope-from wblock@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
 by mx1.freebsd.org (Postfix) with ESMTP id 459B78FC18;
 Sun, 14 Oct 2012 15:48:06 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
 by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q9EFm6l3094041;
 Sun, 14 Oct 2012 15:48:06 GMT (envelope-from wblock@svn.freebsd.org)
Received: (from wblock@localhost)
 by svn.freebsd.org (8.14.4/8.14.4/Submit) id q9EFm6AB094039;
 Sun, 14 Oct 2012 15:48:06 GMT (envelope-from wblock@svn.freebsd.org)
Message-Id: <201210141548.q9EFm6AB094039@svn.freebsd.org>
From: Warren Block <wblock@FreeBSD.org>
Date: Sun, 14 Oct 2012 15:48:06 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r39749 - head/en_US.ISO8859-1/books/handbook/cutting-edge
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 14 Oct 2012 15:48:06 -0000

Author: wblock
Date: Sun Oct 14 15:48:05 2012
New Revision: 39749
URL: http://svn.freebsd.org/changeset/doc/39749

Log:
  The typical user will experience only negative benefits from setting
  CFLAGS on modern versions of FreeBSD.

Modified:
  head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml	Sun Oct 14 14:43:42 2012	(r39748)
+++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml	Sun Oct 14 15:48:05 2012	(r39749)
@@ -2034,15 +2034,14 @@ Fetching 133 new ports or files... done.
 	used every time you run <command>make</command>, so it is a good
 	idea to set them to something sensible for your system.</para>
 
-      <para>A typical user will probably want to copy the
-	<makevar>CFLAGS</makevar> and
-	<makevar>NO_PROFILE</makevar> lines found in
+      <para>A typical user will probably want to copy and uncomment
+	the <makevar>NO_PROFILE</makevar> line found in
 	<filename>/usr/share/examples/etc/make.conf</filename>
-	to <filename>/etc/make.conf</filename> and uncomment them.</para>
+	to <filename>/etc/make.conf</filename>.</para>
 
-      <para>Examine the other definitions (<makevar>COPTFLAGS</makevar>,
-	<makevar>NOPORTDOCS</makevar> and so
-	on) and decide if they are relevant to you.</para>
+      <para>Examine the other definitions, like
+	<makevar>NOPORTDOCS</makevar>,
+	and decide if they are relevant to you.</para>
     </sect2>
 
     <sect2 id="updating-etc">
@@ -2865,17 +2864,6 @@ Building everything..
 	      </listitem>
 
 	      <listitem>
-		<para>Also in <filename>/etc/make.conf</filename>, set
-		  <makevar>CFLAGS</makevar> to something like <option>-O
-		    -pipe</option>.  The optimization <option>-O2</option>
-		  is much slower, and the optimization difference between
-		  <option>-O</option> and <option>-O2</option> is normally
-		  negligible.  <option>-pipe</option> lets the compiler use
-		  pipes rather than temporary files for communication, which
-		  saves disk access (at the expense of memory).</para>
-	      </listitem>
-
-	      <listitem>
 		<para>Pass the
 		  <option>-j<replaceable>n</replaceable></option> option to
 		  &man.make.1; to run multiple processes in parallel.  This