summaryrefslogtreecommitdiff
path: root/src/lisp.h
diff options
context:
space:
mode:
authorDmitry Antipov <dmantipov@yandex.ru>2014-09-25 14:24:57 +0400
committerDmitry Antipov <dmantipov@yandex.ru>2014-09-25 14:24:57 +0400
commit730c89f90ff94729f7316244d7d0d84a3f8d249f (patch)
treed877943320358c116cbd006ebd1df0840c10e782 /src/lisp.h
parentdb61bdb13915a15896ffb96d1ea3d23e00f4bf54 (diff)
downloademacs-730c89f90ff94729f7316244d7d0d84a3f8d249f.tar.gz
* lisp.h (toplevel): Adjust comment around USE_STACK_LISP_OBJECTS.
Diffstat (limited to 'src/lisp.h')
-rw-r--r--src/lisp.h23
1 files changed, 11 insertions, 12 deletions
diff --git a/src/lisp.h b/src/lisp.h
index f76008e8f5e..82a99fcca34 100644
--- a/src/lisp.h
+++ b/src/lisp.h
@@ -4595,18 +4595,17 @@ lisp_word_count (ptrdiff_t nbytes)
} 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.
-
- 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. */
+/* 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 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. */