* Cleaned up memory error signalling.
[bpt/guile.git] / libguile / __scm.h
index 7ca2241..13eaa82 100644 (file)
@@ -63,9 +63,6 @@
 /* Old async mechanism */
 /* #define GUILE_OLD_ASYNC_CLICK */
 
-/* New scheme for garbage collection */
-#define GUILE_NEW_GC_SCHEME
-
 /* #define GUILE_DEBUG_FREELIST */
 
 /* If the compile FLAG `SCM_CAUTIOUS' is #defined then the number of
  */
 #define BIGNUMS
 
-/* GC should relinquish empty cons-pair arenas. 
- */
-#ifndef GUILE_NEW_GC_SCHEME
-#define GC_FREE_SEGMENTS
-#endif
+/* GC should relinquish empty cons-pair arenas. */
+/* cmm:FIXME look at this after done mangling the GC */
+/* #define GC_FREE_SEGMENTS */
 
 /* Provide a scheme-accessible count-down timer that
  * generates a pseudo-interrupt.
 #undef NO_CEVAL_STACK_CHECKING
 
 \f
+
 /* What did the configure script discover about the outside world?  */
 #include "libguile/scmconfig.h"
 
+\f
+
+/* {Debugging Options}
+ *
+ * These compile time options determine whether to include code that is only
+ * useful for debugging guile itself or C level extensions to guile.  The
+ * common prefix for all option macros of this kind is "SCM_DEBUG_".  It is
+ * guaranteed that a macro named SCM_DEBUG_XXX is defined to be either 0 or 1,
+ * i. e. there is no need to test for the undefined case.  This allows to use
+ * these definitions comfortably in macro code, as in the following example:
+ *   #define FOO do { if (SCM_DEBUG_XXX) bar(); else baz(); } while (0)
+ * Any sane compiler will remove the unused branch without any performance
+ * penalty for the resulting code.
+ *
+ * Note:  Some SCM_DEBUG_XXX options are not settable at configure time.
+ * To change the value of such options you will have to edit this header
+ * file or give suitable options to make, like:
+ *   make all CFLAGS="-DSCM_DEBUG_XXX=1 ..."
+ */
+
+
+/* The value of SCM_DEBUG determines the default for most of the not yet
+ * defined debugging options.  This allows, for example, to enable most of the
+ * debugging options by simply defining SCM_DEBUG as 1.
+ */
+#ifndef SCM_DEBUG
+#define SCM_DEBUG 0
+#endif
+
+/* If SCM_DEBUG_CELL_ACCESSES is set to 1, cell accesses will perform
+ * exhaustive parameter checking:  It will be verified that cell parameters
+ * actually point to a valid heap cell.  Note:  If this option is enabled,
+ * guile will run about ten times slower than normally.
+ */
+#ifndef SCM_DEBUG_CELL_ACCESSES
+#define SCM_DEBUG_CELL_ACCESSES SCM_DEBUG
+#endif
+
+/* If SCM_DEBUG_DEPRECATED is set to 1, deprecated code is not compiled.  This
+ * can be used by developers to get rid of references to deprecated code.
+ */
+#ifndef SCM_DEBUG_DEPRECATED
+#define SCM_DEBUG_DEPRECATED SCM_DEBUG
+#endif
+
+/* If SCM_DEBUG_REST_ARGUMENT is set to 1, functions that take rest arguments
+ * will check whether the rest arguments are actually passed as a proper list.
+ * Otherwise, if SCM_DEBUG_REST_ARGUMENT is 0, functions that take rest
+ * arguments will take it for granted that these are passed as a proper list.
+ */
+#ifndef SCM_DEBUG_REST_ARGUMENT
+#define SCM_DEBUG_REST_ARGUMENT SCM_DEBUG
+#endif
+
+/* Use this for _compile time_ type checking only, since the compiled result
+ * will be quite inefficient.  The right way to make use of this option is to
+ * do a 'make clean; make CFLAGS=-DSCM_DEBUG_TYPING_STRICTNESS=1', fix your
+ * errors, and then do 'make clean; make'.
+ */
+#ifndef SCM_DEBUG_TYPING_STRICTNESS
+#define SCM_DEBUG_TYPING_STRICTNESS 0
+#endif
+
+\f
+
 #ifdef HAVE_LONG_LONGS
 
 /* Some auto-generated .h files contain unused prototypes
@@ -489,54 +550,14 @@ extern SCM scm_apply_generic (SCM gf, SCM args);
 #define SCM_ARG5               5
 #define SCM_ARG6               6
 #define SCM_ARG7               7 
-     /* #define SCM_ARGERR(X)          ((X) < SCM_WNA \
-                                ? (char *)(X) \
-                                : "wrong type argument")
-                                */
 
-/* Following must match entry indexes in scm_errmsgs[].
- * Also, SCM_WNA must follow the last SCM_ARGn in sequence.
+/* SCM_WNA must follow the last SCM_ARGn in sequence.
  */
 #define SCM_WNA                8
-     /* #define SCM_OVSCM_FLOW                 9 */
 #define SCM_OUTOFRANGE                 10
-#define SCM_NALLOC             11
-     /* #define SCM_STACK_OVFLOW       12 */
-     /* #define SCM_EXIT               13 */
 
 #endif /* SCM_MAGIC_SNARFER */
 
-/* (...still matching scm_errmsgs)  These
- * are signals.  Signals may become errors
- * but are distinguished because they first
- * try to invoke a handler that can resume
- * the interrupted routine.
- */
-#define SCM_HUP_SIGNAL                 14
-#define SCM_INT_SIGNAL                 15
-#define SCM_FPE_SIGNAL                 16
-#define SCM_BUS_SIGNAL                 17
-#define SCM_SEGV_SIGNAL        18
-#define SCM_ALRM_SIGNAL        19
-#define SCM_GC_SIGNAL          20
-#define SCM_TICK_SIGNAL                21
-
-#define SCM_SIG_ORD(X)         ((X) - SCM_HUP_SIGNAL)
-#define SCM_ORD_SIG(X)         ((X) + SCM_HUP_SIGNAL)
-#define SCM_NUM_SIGS           (SCM_SIG_ORD (SCM_TICK_SIGNAL) + 1)
-
-#if 0
-struct errdesc
-{
-  char *msg;
-  char *s_response;
-  short parent_err;
-};
-
-
-extern struct errdesc scm_errmsgs[];
-#endif
-
 \f
 
 /* SCM_EXIT_SUCCESS is the default code to return from SCM if no errors
@@ -560,8 +581,6 @@ extern struct errdesc scm_errmsgs[];
 #endif /* def vms */
 #endif /* ndef SCM_EXIT_FAILURE */
 
-
-
 \f
 
 #endif  /* __SCMH */