summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornop <nop>2000-01-09 22:20:14 (GMT)
committernop <nop>2000-01-09 22:20:14 (GMT)
commitb75bd462a8cc8ae2adb49f0a130999d8549b0f97 (patch)
tree3a7e7ae6e86896254cef761a44d806128ca62e5d
parenta72a1ae13e40a03eead06a912d1f92a013286266 (diff)
downloadmoo-cvs-b75bd462a8cc8ae2adb49f0a130999d8549b0f97.zip
moo-cvs-b75bd462a8cc8ae2adb49f0a130999d8549b0f97.tar.gz
moo-cvs-b75bd462a8cc8ae2adb49f0a130999d8549b0f97.tar.bz2
moo-cvs-b75bd462a8cc8ae2adb49f0a130999d8549b0f97.tar.xz
Round one of doc cleanup.
-rw-r--r--ChangeLog.txt4
-rw-r--r--README.rX10
-rw-r--r--options.h21
3 files changed, 30 insertions, 5 deletions
diff --git a/ChangeLog.txt b/ChangeLog.txt
index 50ae2d6..8ef2a2e 100644
--- a/ChangeLog.txt
+++ b/ChangeLog.txt
@@ -2349,7 +2349,9 @@ Version 1.8.0p6
list value in some situations. For example, `l[a] = b' will be
significantly faster for long lists, if `l' is the only reference
to the underlying list. This optimization can only be done outside
- of error-handling expressions and `try' statements.
+ of error-handling expressions and `try' statements. However, see
+ the notes in options.h on BYTECODE_REDUCE_REF for information on
+ the upgrade procedure currently required for safely enabling this.
-- The server now declares some C functions as "static inline". If
your C compiler doesn't understand this gcc-style declaration, add
"-Dinline=" to CFLAGS in the Makefile. (This gross requirement
diff --git a/README.rX b/README.rX
index 7bd7804..b2da19c 100644
--- a/README.rX
+++ b/README.rX
@@ -255,4 +255,12 @@ The default input and output buffer sizes in options.h are now 64k.
From README.r8:
r8 adds more fixes to BYTECODE_REDUCE_REF. It's now safe to turn on.
-[This appears to be true.]
+However, suspended tasks are a problem for switchover. From options.h:
+
+ * This option affects the length of certain bytecode sequences.
+ * Suspended tasks in a database from a server built with this option
+ * are not guaranteed to work with a server built without this option,
+ * and vice versa. It is safe to flip this switch only if there are
+ * no suspended tasks in the database you are loading. (It might work
+ * anyway, but hey, it's your database.) This restriction will be
+ * lifted in a future version of the server software.
diff --git a/options.h b/options.h
index 44dc2ef..3f9f641 100644
--- a/options.h
+++ b/options.h
@@ -215,9 +215,21 @@
* x rather than make a copy and append to that. If it *does* have to copy,
* the next time (if it's in a loop) it will have the only reference to the
* copy and then it can take advantage.
- ******************************************************************************
- */
-#define BYTECODE_REDUCE_REF
+ *
+ * NOTE WELL NOTE WELL NOTE WELL NOTE WELL NOTE WELL
+ *
+ * This option affects the length of certain bytecode sequences.
+ * Suspended tasks in a database from a server built with this option
+ * are not guaranteed to work with a server built without this option,
+ * and vice versa. It is safe to flip this switch only if there are
+ * no suspended tasks in the database you are loading. (It might work
+ * anyway, but hey, it's your database.) This restriction will be
+ * lifted in a future version of the server software.
+ *
+ * NOTE WELL NOTE WELL NOTE WELL NOTE WELL NOTE WELL
+ *
+ ****************************************************************************** */
+/* #define BYTECODE_REDUCE_REF */
/******************************************************************************
* This package comes with a copy of the implementation of malloc() from GNU
@@ -319,6 +331,9 @@
/*
* $Log$
+ * Revision 1.6 2000/01/09 22:20:15 nop
+ * Round one of doc cleanup.
+ *
* Revision 1.5 1999/08/09 04:09:54 nop
* Turn up the buffer sizes a notch. They're still really too small...
*