This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

PATCH RFC: Mention -fno-toplevel-reorder in the 4.2 changes file


This patch adds a mention of the new -fno-toplevel-reorder option in
the 4.2 changes file.  This option is intended to replace
-fno-unit-at-a-time, and I hope will make it possible to remove
non-unit-at-a-time mode, simplifying the compiler.

I will commit this patch in a few days unless somebody has any
objections.

Ian


Index: gcc-4.2/changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.2/changes.html,v
retrieving revision 1.27
diff -u -r1.27 changes.html
--- gcc-4.2/changes.html	24 Mar 2007 00:30:32 -0000	1.27
+++ gcc-4.2/changes.html	24 Mar 2007 00:40:32 -0000
@@ -26,9 +26,7 @@
 <ul>
     <li><a href="../projects/gomp/">OpenMP</a> is now
         supported for the C, C++ and Fortran compilers.</li>
-</ul>
 
-<ul>
     <li>New command line options <code>-fstrict-overflow</code> and
     <code>-Wstrict-overflow</code> have been added.
     <code>-fstrict-overflow</code> tells the compiler that it may
@@ -52,6 +50,22 @@
     <a href="http://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html";>
     documentation</a> for details.  <code>-Wstrict-overflow=1</code>
     is enabled by <code>-Wall</code>.</li>
+
+    <li>The new command line option <code>-fno-toplevel-reorder</code>
+    directs GCC to emit top-level functions, variables, and
+    <code>asm</code> statements in the same order that they appear in
+    the input file.  This is intended to support existing code which
+    relies on a particular ordering (for example, code which uses
+    top-level <code>asm</code> statements to switch sections).  For
+    new code, it is generally better to use function and variable
+    attributes.  The <code>-fno-toplevel-reorder</code> option may be
+    used for most cases which currently use
+    <code>-fno-unit-at-a-time</code>.  The
+    <code>-fno-unit-at-a-time</code> option will be removed in some
+    future version of GCC; if you know of a case which requires
+    <code>-fno-unit-at-a-time</code> which is not fixed by
+    <code>-fno-toplevel-reorder</code>, please let us know.</li>
+
 </ul>
 
 <h3>C family</h3>


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]