aboutsummaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorDmitry Antipov2014-09-25 14:24:57 +0400
committerDmitry Antipov2014-09-25 14:24:57 +0400
commit730c89f90ff94729f7316244d7d0d84a3f8d249f (patch)
treed877943320358c116cbd006ebd1df0840c10e782 /src
parentdb61bdb13915a15896ffb96d1ea3d23e00f4bf54 (diff)
downloademacs-730c89f90ff94729f7316244d7d0d84a3f8d249f.tar.gz
emacs-730c89f90ff94729f7316244d7d0d84a3f8d249f.zip
* lisp.h (toplevel): Adjust comment around USE_STACK_LISP_OBJECTS.
Diffstat (limited to 'src')
-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)
4595 } while (false) 4595 } while (false)
4596 4596
4597 4597
4598/* If USE_STACK_LISP_OBJECTS, define macros that and functions that 4598/* If USE_STACK_LISP_OBJECTS, define macros that and functions that allocate
4599 allocate block-scoped conses and function-scoped vectors and 4599 block-scoped conses and function-scoped vectors and strings. These objects
4600 strings. These objects are not managed by the garbage collector, 4600 are not managed by the garbage collector, so they are dangerous: passing
4601 so they are dangerous: passing them out of their scope (e.g., to 4601 them out of their scope (e.g., to user code) results in undefined behavior.
4602 user code) results in undefined behavior. Conversely, they have 4602 Conversely, they have better performance because GC is not involved.
4603 better performance because GC is not involved. 4603
4604 4604 This feature is experimental and requires careful debugging. It's enabled
4605 This feature is experimental and requires careful debugging. 4605 by default if GCC or a compiler that mimics GCC well (like Intel C/C++) is
4606 It's enabled by default on GNU/Linux with GCC. On other systems, 4606 used, except clang (see notice above). For other compilers, brave users can
4607 brave users can compile with CPPFLAGS='-DUSE_STACK_LISP_OBJECTS' 4607 compile with CPPFLAGS='-DUSE_STACK_LISP_OBJECTS' to get into the game.
4608 to get into the game. Also note that this feature requires 4608 Note that this feature requires GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS. */
4609 GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS. */
4610 4609
4611/* A struct Lisp_Cons inside a union that is no larger and may be 4610/* A struct Lisp_Cons inside a union that is no larger and may be
4612 better-aligned. */ 4611 better-aligned. */