[Emacs-diffs] trunk r117946: * lisp.h (toplevel): Adjust comment around USE_STACK_LISP_OBJECTS.

[Dmitry Antipov]

------------------------------------------------------------
revno: 117946
revision-id: address@hidden
parent: address@hidden
committer: Dmitry Antipov <address@hidden>
branch nick: trunk
timestamp: Thu 2014-09-25 14:24:57 +0400
message:
  * lisp.h (toplevel): Adjust comment around USE_STACK_LISP_OBJECTS.
modified:
  src/lisp.h                     lisp.h-20091113204419-o5vbwnq5f7feedwu-253

=== modified file 'src/lisp.h'
--- a/src/lisp.h        2014-09-25 09:34:53 +0000
+++ b/src/lisp.h        2014-09-25 10:24:57 +0000
@@ -4595,18 +4595,17 @@
   } while (false)
 
 
-/* If USE_STACK_LISP_OBJECTS, define macros that and functions that
-   allocate block-scoped conses and function-scoped vectors and
-   strings.  These objects are not managed by the garbage collector,
-   so they are dangerous: passing them out of their scope (e.g., to
-   user code) results in undefined behavior.  Conversely, they have
-   better performance because GC is not involved.
+/* If USE_STACK_LISP_OBJECTS, define macros that and functions that allocate
+   block-scoped conses and function-scoped vectors and strings.  These objects
+   are not managed by the garbage collector, so they are dangerous: passing
+   them out of their scope (e.g., to user code) results in undefined behavior.
+   Conversely, they have better performance because GC is not involved.
 
-   This feature is experimental and requires careful debugging.
-   It's enabled by default on GNU/Linux with GCC.  On other systems,
-   brave users can compile with CPPFLAGS='-DUSE_STACK_LISP_OBJECTS'
-   to get into the game.  Also note that this feature requires
-   GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS.  */
+   This feature is experimental and requires careful debugging.  It's enabled
+   by default if GCC or a compiler that mimics GCC well (like Intel C/C++) is
+   used, except clang (see notice above).  For other compilers, brave users can
+   compile with CPPFLAGS='-DUSE_STACK_LISP_OBJECTS' to get into the game.
+   Note that this feature requires GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS.  */
 
 /* A struct Lisp_Cons inside a union that is no larger and may be
    better-aligned.  */