diff options
| author | Dmitry Antipov | 2014-09-25 14:24:57 +0400 |
|---|---|---|
| committer | Dmitry Antipov | 2014-09-25 14:24:57 +0400 |
| commit | 730c89f90ff94729f7316244d7d0d84a3f8d249f (patch) | |
| tree | d877943320358c116cbd006ebd1df0840c10e782 /src | |
| parent | db61bdb13915a15896ffb96d1ea3d23e00f4bf54 (diff) | |
| download | emacs-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.h | 23 |
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. */ |