Merge branch 'duk-config-cleanups'

Cleanups to genconfig.py, config metadata, and config related internal
documentation and website.

config/architectures.yaml

@@ -0,0 +1,34 @@
+# Architecture metadata
+
+required_defines:
+  - DUK_USE_ARCH_STRING
+#  - DUK_USE_INTEGER_LE
+#  - DUK_USE_DOUBLE_LE
+  - DUK_USE_ALIGN_BY
+  - DUK_USE_UNALIGNED_ACCESSES_POSSIBLE
+  - DUK_USE_HASHBYTES_UNALIGNED_U32_ACCESS
+  - DUK_USE_PACKED_TVAL
+  - DUK_USE_PACKED_TVAL_POSSIBLE  # FIXME
+
+autodetect:
+  -
+    name: x86
+    check: DUK_F_X86
+    include: architecture_x86.h.in
+  -
+    name: x64
+    check: DUK_F_X64
+    include: architecture_x64.h.in
+# FIXME
+#  -
+#    name: x32
+#    check: DUK_F_X32
+#    include: architecture_x32.h.in
+#  -
+#    name: arm
+#    check: DUK_F_ARM
+#    include: architecture_arm.h.in
+  -
+    name: generic
+    check: null
+    include: architecture_generic.h.in

config/compilers.yaml

@@ -0,0 +1,21 @@
+# Compiler metadata
+
+required_defines:
+  # FIXME
+  - DUK_USE_COMPILER_STRING
+
+# FIXME
+autodetect:
+  -
+    name: gcc
+    check: DUK_F_GCC
+    include: compiler_gcc.h.in
+# FIXME
+#  -
+#    name: clang
+#    check: DUK_F_CLANG
+#    include: compiler_clang.h.in
+  -
+    name: generic
+    check: null
+    include: compiler_generic.h.in

config/config-options/DUK_USE_ALIGN_BY.yaml

@@ -1,4 +1,13 @@
 define: DUK_USE_ALIGN_BY
+# FIXME: resolve wrapper
+feature_snippet: |
+  #if !defined(DUK_USE_ALIGN_BY)
+  #if defined(DUK_OPT_FORCE_ALIGN)
+  #define DUK_USE_ALIGN_BY DUK_OPT_FORCE_ALIGN
+  #else
+  #define DUK_USE_ALIGN_BY 8
+  #endif
+  #endif
 introduced: 1.3.0
 default: 8
 tags:

config/config-options/DUK_USE_ASSERTIONS.yaml

@@ -1,6 +1,7 @@
 define: DUK_USE_ASSERTIONS
 related_feature_defines:
   - DUK_OPT_ASSERTIONS
+feature_enables: DUK_OPT_ASSERTIONS
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_AUGMENT_ERROR_CREATE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_AUGMENT_ERROR_CREATE
+feature_enables: DUK_OPT_AUGMENT_ERRORS
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_AUGMENT_ERROR_THROW.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_AUGMENT_ERROR_THROW
+feature_enables: DUK_OPT_AUGMENT_ERRORS
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_BROWSER_LIKE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_BROWSER_LIKE
+feature_enables: DUK_OPT_BROWSER_LIKE
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_BUFFEROBJECT_SUPPORT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_BUFFEROBJECT_SUPPORT
+feature_enables: DUK_OPT_BUFFEROBJECT_SUPPORT
 introduced: 1.3.0
 default: true
 tags:

config/config-options/DUK_USE_BUFLEN16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_BUFLEN16
+feature_enables: DUK_OPT_BUFLEN16
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_BYTECODE_DUMP_SUPPORT.yaml

@@ -1,6 +1,7 @@
 define: DUK_USE_BYTECODE_DUMP_SUPPORT
 related_feature_defines:
   - DUK_OPT_NO_BYTECODE_DUMP_SUPPORT
+feature_enables: DUK_OPT_BYTECODE_DUMP_SUPPORT
 introduced: 1.3.0
 default: true
 tags:

config/config-options/DUK_USE_BYTEORDER_FORCED.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_BYTEORDER_FORCED
+feature_enables: DUK_OPT_FORCE_BYTEORDER
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_COMMONJS_MODULES.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_COMMONJS_MODULES
+feature_enables: DUK_OPT_COMMONJS_MODULES
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_DATAPTR16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DATAPTR16
+feature_enables: DUK_OPT_DATAPTR16
 introduced: 1.1.0
 related:
   - DUK_USE_DATAPTR_ENC16

config/config-options/DUK_USE_DATAPTR_DEC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_DATAPTR_DEC16
+feature_snippet: |
+  #if defined(DUK_OPT_DATAPTR_DEC16)
+  #define DUK_USE_DATAPTR_DEC16(udata,ptr) DUK_OPT_DATAPTR_DEC16((udata),(ptr))
+  #else
+  #undef DUK_USE_DATAPTR_DEC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_DATAPTR16

config/config-options/DUK_USE_DATAPTR_ENC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_DATAPTR_ENC16
+feature_snippet: |
+  #if defined(DUK_OPT_DATAPTR_ENC16)
+  #define DUK_USE_DATAPTR_ENC16(udata,ptr) DUK_OPT_DATAPTR_ENC16((udata),(ptr))
+  #else
+  #undef DUK_USE_DATAPTR_ENC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_DATAPTR16

config/config-options/DUK_USE_DDDPRINT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DDDPRINT
+feature_enables: DUK_OPT_DDDPRINT
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_DDPRINT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DDPRINT
+feature_enables: DUK_OPT_DDPRINT
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_DEBUG.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUG
+feature_enables: DUK_OPT_DEBUG
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_DEBUGGER_DUMPHEAP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUGGER_DUMPHEAP
+feature_enables: DUK_OPT_DEBUGGER_DUMPHEAP
 introduced: 1.2.0
 requires:
   - DUK_USE_DEBUGGER_SUPPORT

config/config-options/DUK_USE_DEBUGGER_FWD_LOGGING.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUGGER_FWD_LOGGING
+feature_enables: DUK_OPT_DEBUGGER_FWD_LOGGING
 introduced: 1.2.0
 requires:
   - DUK_USE_DEBUGGER_SUPPORT

config/config-options/DUK_USE_DEBUGGER_FWD_PRINTALERT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUGGER_FWD_PRINTALERT
+feature_enables: DUK_OPT_DEBUGGER_FWD_PRINTALERT
 introduced: 1.2.0
 requires:
   - DUK_USE_DEBUGGER_SUPPORT

config/config-options/DUK_USE_DEBUGGER_SUPPORT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUGGER_SUPPORT
+feature_enables: DUK_OPT_DEBUGGER_SUPPORT
 introduced: 1.2.0
 requires:
   - DUK_USE_INTERRUPT_COUNTER

config/config-options/DUK_USE_DEBUGGER_TRANSPORT_TORTURE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEBUGGER_TRANSPORT_TORTURE
+feature_enables: DUK_OPT_DEBUGGER_TRANSPORT_TORTURE
 introduced: 1.2.0
 requires:
   - DUK_USE_DEBUGGER_SUPPORT

config/config-options/DUK_USE_DEBUG_BUFSIZE.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_DEBUG_BUFSIZE
+feature_snippet: |
+  #if defined(DUK_OPT_DEBUG_BUFSIZE)
+  #define DUK_USE_DEBUG_BUFSIZE DUK_OPT_DEBUG_BUFSIZE
+  #else
+  #define DUK_USE_DEBUG_BUFSIZE 65536L
+  #endif
 introduced: 1.0.0
 related:  # not strictly required, value is defined even when DUK_USE_DEBUG not defined
   - DUK_USE_DEBUG

config/config-options/DUK_USE_DEEP_C_STACK.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DEEP_C_STACK
+feature_enables: DUK_OPT_DEEP_C_STACK
 introduced: 1.0.0
 removed: 1.3.0
 default: true

config/config-options/DUK_USE_DOUBLE_BE.yaml

@@ -1,4 +1,18 @@
 define: DUK_USE_DOUBLE_BE
+feature_snippet: |
+  #if defined(DUK_OPT_FORCE_BYTEORDER)
+  #if (DUK_OPT_FORCE_BYTEORDER == 1)
+  #undef DUK_USE_DOUBLE_BE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 2)
+  #undef DUK_USE_DOUBLE_BE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 3)
+  #define DUK_USE_DOUBLE_BE
+  #else
+  #error invalid DUK_OPT_FORCE_BYTEORDER
+  #endif
+  #else
+  #undef DUK_USE_DOUBLE_BE
+  #endif
 introduced: 1.0.0
 default: false
 conflicts:

config/config-options/DUK_USE_DOUBLE_LE.yaml

@@ -1,4 +1,18 @@
 define: DUK_USE_DOUBLE_LE
+feature_snippet: |
+  #if defined(DUK_OPT_FORCE_BYTEORDER)
+  #if (DUK_OPT_FORCE_BYTEORDER == 1)
+  #define DUK_USE_DOUBLE_LE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 2)
+  #undef DUK_USE_DOUBLE_LE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 3)
+  #undef DUK_USE_DOUBLE_LE
+  #else
+  #error invalid DUK_OPT_FORCE_BYTEORDER
+  #endif
+  #else
+  #define DUK_USE_DOUBLE_LE
+  #endif
 introduced: 1.0.0
 default: true
 conflicts:

config/config-options/DUK_USE_DOUBLE_LINKED_HEAP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DOUBLE_LINKED_HEAP
+feature_enables: DUK_OPT_REFERENCE_COUNTING
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_DOUBLE_ME.yaml

@@ -1,4 +1,18 @@
 define: DUK_USE_DOUBLE_ME
+feature_snippet: |
+  #if defined(DUK_OPT_FORCE_BYTEORDER)
+  #if (DUK_OPT_FORCE_BYTEORDER == 1)
+  #undef DUK_USE_DOUBLE_ME
+  #elif (DUK_OPT_FORCE_BYTEORDER == 2)
+  #define DUK_USE_DOUBLE_ME
+  #elif (DUK_OPT_FORCE_BYTEORDER == 3)
+  #undef DUK_USE_DOUBLE_ME
+  #else
+  #error invalid DUK_OPT_FORCE_BYTEORDER
+  #endif
+  #else
+  #undef DUK_USE_DOUBLE_ME
+  #endif
 introduced: 1.0.0
 default: false
 conflicts:

config/config-options/DUK_USE_DPRINT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DPRINT
+feature_enables: DUK_OPT_DPRINT
 introduced: 1.0.0
 requires:
   - DUK_USE_DEBUG

config/config-options/DUK_USE_DPRINT_COLORS.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DPRINT_COLORS
+feature_enables: DUK_OPT_DPRINT_COLORS
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_DPRINT_RDTSC.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_DPRINT_RDTSC
+feature_enables: DUK_OPT_DPRINT_RDTSC
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_ERRCREATE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_ERRCREATE
+feature_enables: DUK_OPT_AUGMENT_ERRORS
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_ERRTHROW.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_ERRTHROW
+feature_enables: DUK_OPT_AUGMENT_ERRORS
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_ES6_OBJECT_PROTO_PROPERTY.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_ES6_OBJECT_PROTO_PROPERTY
+feature_enables: DUK_OPT_ES6_OBJECT_PROTO_PROPERTY
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_ES6_OBJECT_SETPROTOTYPEOF.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_ES6_OBJECT_SETPROTOTYPEOF
+feature_enables: DUK_OPT_ES6_OBJECT_SETPROTOTYPEOF
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_ES6_PROXY.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_ES6_PROXY
+feature_enables: DUK_OPT_ES6_PROXY
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_EXAMPLE.yaml

@@ -13,6 +13,23 @@ define: DUK_USE_OBJSIZES16
 related_feature_defines:
   - DUK_OPT_OBJSIZES16
 
+# Feature define (DUK_OPT_xxx) enables config define (DUK_USE_xxx), and
+# negative feature define (DUK_OPT_NO_xxx) disables config define.  If
+# neither present, use default.
+#feature_enables: DUK_OPT_OBJSIZES16
+
+# Feature define disables config define, and vice versa.
+#feature_disables: DUK_OPT_OBJSIZES16
+
+# Feature detection snippet given explicitly.
+#feature_snippet: |
+#   #if defined(DUK_OPT_OBJSIZES16)
+#   #define DUK_USE_OBJSIZES16
+#   #if defined(XYZ)
+#   #error DUK_OPT_OBJSIZES16 conflicts with XYZ
+#   #endif
+#   #endif
+
 # Duktape version number where this option was first introduced.
 introduced: 1.1.0
 

config/config-options/DUK_USE_EXEC_INDIRECT_BOUND_CHECK.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_EXEC_INDIRECT_BOUND_CHECK
+feature_snippet: |
+  #undef DUK_USE_EXEC_INDIRECT_BOUND_CHECK
+  #if defined(DUK_OPT_DEBUG) || defined(DUK_OPT_ASSERTIONS)
+  /* Enabled with debug/assertions just so that any issues can be caught. */
+  #define DUK_USE_EXEC_INDIRECT_BOUND_CHECK
+  #endif
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_EXEC_TIMEOUT_CHECK.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_EXEC_TIMEOUT_CHECK
+feature_snippet: |
+  #undef DUK_USE_EXEC_TIMEOUT_CHECK
+  #if defined(DUK_OPT_EXEC_TIMEOUT_CHECK)
+  #define DUK_USE_EXEC_TIMEOUT_CHECK(udata)  DUK_OPT_EXEC_TIMEOUT_CHECK((udata))
+  #endif
 introduced: 1.2.0
 requires:
   - DUK_USE_INTERRUPT_COUNTER

config/config-options/DUK_USE_EXPLICIT_NULL_INIT.yaml

@@ -9,4 +9,4 @@ description: >
   only be necessary when a NULL pointer is not represented by zero bytes in
   memory.
 
-# FIXME: condition in Duktape 1.2 seems wrong, and is linked to packed tval?
+  # NOTE: Condition in Duktape 1.2 seems wrong, and is linked to packed tval.

config/config-options/DUK_USE_EXTSTR_FREE.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_EXTSTR_FREE
+feature_snippet: |
+  #undef DUK_USE_EXTSTR_FREE
+  #if defined(DUK_OPT_EXTERNAL_STRINGS) && defined(DUK_OPT_EXTSTR_FREE)
+  #define DUK_USE_EXTSTR_FREE(udata,ptr) DUK_OPT_EXTSTR_FREE((udata), (ptr))
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_HSTRING_EXTDATA

config/config-options/DUK_USE_EXTSTR_INTERN_CHECK.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_EXTSTR_INTERN_CHECK
+feature_snippet: |
+  #undef DUK_USE_EXTSTR_INTERN_CHECK
+  #if defined(DUK_OPT_EXTERNAL_STRINGS) && defined(DUK_OPT_EXTSTR_INTERN_CHECK)
+  #define DUK_USE_EXTSTR_INTERN_CHECK(udata,ptr,len) DUK_OPT_EXTSTR_INTERN_CHECK((udata), (ptr), (len))
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_HSTRING_EXTDATA

config/config-options/DUK_USE_FASTINT.yaml

@@ -1,4 +1,13 @@
 define: DUK_USE_FASTINT
+feature_snippet: |
+  /* Support for 48-bit signed integer duk_tval with transparent semantics. */
+  #undef DUK_USE_FASTINT
+  #if defined(DUK_OPT_FASTINT)
+  #if !defined(DUK_F_HAVE_64BIT)
+  #error DUK_OPT_FASTINT requires 64-bit integer type support at the moment
+  #endif
+  #define DUK_USE_FASTINT
+  #endif
 related_feature_defines:
   - DUK_OPT_FASTINT
 introduced: 1.2.0

config/config-options/DUK_USE_FILE_IO.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_FILE_IO
+feature_enables: DUK_OPT_FILE_IO
 related_feature_defines:
   - DUK_OPT_NO_FILE_IO
 introduced: 1.0.0

config/config-options/DUK_USE_FUNCPTR16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_FUNCPTR16
+feature_enables: DUK_OPT_FUNCPTR16
 introduced: 1.1.0
 related:
   - DUK_USE_FUNCPTR_ENC16

config/config-options/DUK_USE_FUNCPTR_DEC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_FUNCPTR_DEC16
+feature_snippet: |
+  #if defined(DUK_OPT_FUNCPTR_DEC16)
+  #define DUK_USE_FUNCPTR_DEC16(udata,ptr) DUK_OPT_FUNCPTR_DEC16((udata),(ptr))
+  #else
+  #undef DUK_USE_FUNCPTR_DEC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_FUNCPTR16

config/config-options/DUK_USE_FUNCPTR_ENC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_FUNCPTR_ENC16
+feature_snippet: |
+  #if defined(DUK_OPT_FUNCPTR_ENC16)
+  #define DUK_USE_FUNCPTR_ENC16(udata,ptr) DUK_OPT_FUNCPTR_ENC16((udata),(ptr))
+  #else
+  #undef DUK_USE_FUNCPTR_ENC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_FUNCPTR16

config/config-options/DUK_USE_GC_TORTURE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_GC_TORTURE
+feature_enables: DUK_OPT_GC_TORTURE
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_HEAPPTR16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_HEAPPTR16
+feature_enables: DUK_OPT_HEAPPTR16
 introduced: 1.1.0
 conflicts:
   - DUK_USE_DEBUG

config/config-options/DUK_USE_HEAPPTR_DEC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_HEAPPTR_DEC16
+feature_snippet: |
+  #if defined(DUK_OPT_HEAPPTR_DEC16)
+  #define DUK_USE_HEAPPTR_DEC16(udata,ptr) DUK_OPT_HEAPPTR_DEC16((udata),(ptr))
+  #else
+  #undef DUK_USE_HEAPPTR_DEC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_HEAPPTR16

config/config-options/DUK_USE_HEAPPTR_ENC16.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_HEAPPTR_ENC16
+feature_snippet: |
+  #if defined(DUK_OPT_HEAPPTR_ENC16)
+  #define DUK_USE_HEAPPTR_ENC16(udata,ptr) DUK_OPT_HEAPPTR_ENC16((udata),(ptr))
+  #else
+  #undef DUK_USE_HEAPPTR_ENC16
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_HEAPPTR16

config/config-options/DUK_USE_HOBJECT_HASH_PART.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_HOBJECT_HASH_PART
+feature_snippet: |
+  /* For now, hash part is dropped if and only if 16-bit object fields are used. */
+  #define DUK_USE_HOBJECT_HASH_PART
+  #if defined(DUK_OPT_OBJSIZES16)
+  #undef DUK_USE_HOBJECT_HASH_PART
+  #endif
 introduced: 1.1.0
 default: true
 tags:

config/config-options/DUK_USE_HSTRING_EXTDATA.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_HSTRING_EXTDATA
+feature_enables: DUK_OPT_EXTERNAL_STRINGS
 introduced: 1.1.0
 related_feature_defines:
   - DUK_OPT_EXTERNAL_STRINGS

config/config-options/DUK_USE_INTEGER_BE.yaml

@@ -1,4 +1,18 @@
 define: DUK_USE_INTEGER_BE
+feature_snippet: |
+  #if defined(DUK_OPT_FORCE_BYTEORDER)
+  #if (DUK_OPT_FORCE_BYTEORDER == 1)
+  #undef DUK_USE_INTEGER_BE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 2)
+  #undef DUK_USE_INTEGER_BE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 3)
+  #define DUK_USE_INTEGER_BE
+  #else
+  #error invalid DUK_OPT_FORCE_BYTEORDER
+  #endif
+  #else
+  #undef DUK_USE_INTEGER_BE
+  #endif
 introduced: 1.0.0
 default: false
 conflicts:

config/config-options/DUK_USE_INTEGER_LE.yaml

@@ -1,4 +1,18 @@
 define: DUK_USE_INTEGER_LE
+feature_snippet: |
+  #if defined(DUK_OPT_FORCE_BYTEORDER)
+  #if (DUK_OPT_FORCE_BYTEORDER == 1)
+  #define DUK_USE_INTEGER_LE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 2)
+  #define DUK_USE_INTEGER_LE
+  #elif (DUK_OPT_FORCE_BYTEORDER == 3)
+  #undef DUK_USE_INTEGER_LE
+  #else
+  #error invalid DUK_OPT_FORCE_BYTEORDER
+  #endif
+  #else
+  #define DUK_USE_INTEGER_LE
+  #endif
 introduced: 1.0.0
 default: true
 conflicts:

config/config-options/DUK_USE_INTERRUPT_COUNTER.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_INTERRUPT_COUNTER
+feature_enables: DUK_OPT_INTERRUPT_COUNTER
 introduced: 1.1.0
 related:
   - DUK_USE_DEBUGGER_SUPPORT

config/config-options/DUK_USE_JC.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_JC
+feature_enables: DUK_OPT_JC
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_JSON_STRINGIFY_FASTPATH.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_JSON_STRINGIFY_FASTPATH
+feature_enables: DUK_OPT_JSON_STRINGIFY_FASTPATH
 introduced: 1.3.0
 default: false
 tags:

config/config-options/DUK_USE_JX.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_JX
+feature_enables: DUK_OPT_JX
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_LIGHTFUNC_BUILTINS.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_LIGHTFUNC_BUILTINS
+feature_enables: DUK_OPT_LIGHTFUNC_BUILTINS
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_MARK_AND_SWEEP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_MARK_AND_SWEEP
+feature_enables: DUK_OPT_MARK_AND_SWEEP
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_MS_STRINGTABLE_RESIZE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_MS_STRINGTABLE_RESIZE
+feature_enables: DUK_OPT_MS_STRINGTABLE_RESIZE
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_ARRAY_CONCAT_TRAILER.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_ARRAY_CONCAT_TRAILER
+feature_enables: DUK_OPT_NONSTD_ARRAY_CONCAT_TRAILER
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_ARRAY_MAP_TRAILER.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_ARRAY_MAP_TRAILER
+feature_enables: DUK_OPT_NONSTD_ARRAY_MAP_TRAILER
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_ARRAY_SPLICE_DELCOUNT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_ARRAY_SPLICE_DELCOUNT
+feature_enables: DUK_OPT_NONSTD_ARRAY_SPLICE_DELCOUNT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_FUNC_CALLER_PROPERTY.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_FUNC_CALLER_PROPERTY
+feature_enables: DUK_OPT_NONSTD_FUNC_CALLER_PROPERTY
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_NONSTD_FUNC_SOURCE_PROPERTY.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_FUNC_SOURCE_PROPERTY
+feature_enables: DUK_OPT_NONSTD_FUNC_SOURCE_PROPERTY
 introduced: 1.0.0
 default: false
 tags:
@@ -8,4 +9,4 @@ description: >
   function toString() to print out the actual function source.  The property
   is disabled by default because it increases memory footprint.
 
-  NOTE: Unimplemented as of Duktape 1.2.0.
+  NOTE: Unimplemented as of Duktape 1.3.0.

config/config-options/DUK_USE_NONSTD_FUNC_STMT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_FUNC_STMT
+feature_enables: DUK_OPT_NONSTD_FUNC_STMT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_GETTER_KEY_ARGUMENT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_GETTER_KEY_ARGUMENT
+feature_enables: DUK_OPT_NONSTD_ACCESSOR_KEY_ARGUMENT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_JSON_ESC_U2028_U2029.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_JSON_ESC_U2028_U2029
+feature_enables: DUK_OPT_NONSTD_JSON_ESC_U2028_U2029
 introduced: 1.1.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_REGEXP_DOLLAR_ESCAPE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_REGEXP_DOLLAR_ESCAPE
+feature_enables: DUK_OPT_NONSTD_REGEXP_DOLLAR_ESCAPE
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_SETTER_KEY_ARGUMENT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_SETTER_KEY_ARGUMENT
+feature_enables: DUK_OPT_NONSTD_ACCESSOR_KEY_ARGUMENT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_NONSTD_STRING_FROMCHARCODE_32BIT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_NONSTD_STRING_FROMCHARCODE_32BIT
+feature_enables: DUK_OPT_NONSTD_STRING_FROMCHARCODE_32BIT
 introduced: 1.2.0
 default: true
 tags:

config/config-options/DUK_USE_OBJSIZES16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_OBJSIZES16
+feature_enables: DUK_OPT_OBJSIZES16
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_OCTAL_SUPPORT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_OCTAL_SUPPORT
+feature_enables: DUK_OPT_OCTAL_SUPPORT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_PACKED_TVAL.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_PACKED_TVAL
+feature_enables: DUK_OPT_PACKED_TVAL
+# FIXME: current snippet is actually:
+#if defined(DUK_USE_PACKED_TVAL_POSSIBLE) && !defined(DUK_OPT_NO_PACKED_TVAL)
+#define DUK_USE_PACKED_TVAL
+#endif
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_PANIC_ABORT.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_PANIC_ABORT
+feature_snippet: |
+  #undef DUK_USE_PANIC_ABORT
+  #if !defined(DUK_OPT_SEGFAULT_ON_PANIC)
+  #define DUK_USE_PANIC_ABORT
+  #endif
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_PANIC_HANDLER.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_PANIC_HANDLER
+feature_snippet: |
+  #undef DUK_USE_PANIC_HANDLER
+  #if defined(DUK_OPT_PANIC_HANDLER)
+  #define DUK_USE_PANIC_HANDLER(code,msg) DUK_OPT_PANIC_HANDLER((code),(msg))
+  #endif
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_PANIC_SEGFAULT.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_PANIC_SEGFAULT
+feature_snippet: |
+  #undef DUK_USE_PANIC_SEGFAULT
+  #if defined(DUK_OPT_SEGFAULT_ON_PANIC)
+  #define DUK_USE_PANIC_SEGFAULT
+  #endif
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_PC2LINE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_PC2LINE
+feature_enables: DUK_OPT_PC2LINE
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_REFCOUNT16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_REFCOUNT16
+feature_enables: DUK_OPT_REFCOUNT16
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_REFERENCE_COUNTING.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_REFERENCE_COUNTING
+feature_enables: DUK_OPT_REFERENCE_COUNTING
 related_feature_defines:
   - DUK_OPT_NO_REFERENCE_COUNTING
 introduced: 1.0.0

config/config-options/DUK_USE_REGEXP_SUPPORT.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_REGEXP_SUPPORT
+feature_enables: DUK_OPT_REGEXP_SUPPORT
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_SECTION_B.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SECTION_B
+feature_enables: DUK_OPT_SECTION_B
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_SELF_TESTS.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SELF_TESTS
+feature_enables: DUK_OPT_SELF_TESTS
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_SETJMP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SETJMP
+feature_enables: DUK_OPT_SETJMP
 introduced: 1.1.0
 default: true
 tags:

config/config-options/DUK_USE_SHUFFLE_TORTURE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SHUFFLE_TORTURE
+feature_enables: DUK_OPT_SHUFFLE_TORTURE
 introduced: 1.2.0
 default: false
 tags:

config/config-options/DUK_USE_SIGSETJMP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SIGSETJMP
+feature_enables: DUK_OPT_SIGSETJMP
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_SOURCE_NONBMP.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_SOURCE_NONBMP
+feature_enables: DUK_OPT_SOURCE_NONBMP
 introduced: 1.0.0
 default: true
 tags:

config/config-options/DUK_USE_STRHASH16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_STRHASH16
+feature_enables: DUK_OPT_STRHASH16
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_STRICT_DECL.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_STRICT_DECL
+feature_enables: DUK_OPT_STRICT_DECL
 introduced: 1.1.0
 default: true
 tags:

config/config-options/DUK_USE_STRICT_UTF8_SOURCE.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_STRICT_UTF8_SOURCE
+feature_enables: DUK_OPT_STRICT_UTF8_SOURCE
 introduced: 1.0.0
 default: false
 tags:

config/config-options/DUK_USE_STRLEN16.yaml

@@ -1,4 +1,5 @@
 define: DUK_USE_STRLEN16
+feature_enables: DUK_OPT_STRLEN16
 introduced: 1.1.0
 default: false
 tags:

config/config-options/DUK_USE_STRTAB_CHAIN.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_STRTAB_CHAIN
+feature_snippet: |
+  #undef DUK_USE_STRTAB_CHAIN
+  #if defined(DUK_OPT_STRTAB_CHAIN) && defined(DUK_OPT_STRTAB_CHAIN_SIZE)
+  #define DUK_USE_STRTAB_CHAIN
+  #endif
 introduced: 1.1.0
 related:
   - DUK_USE_STRTAB_CHAIN_SIZE

config/config-options/DUK_USE_STRTAB_CHAIN_SIZE.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_STRTAB_CHAIN_SIZE
+feature_snippet: |
+  #undef DUK_USE_STRTAB_CHAIN_SIZE
+  #if defined(DUK_OPT_STRTAB_CHAIN) && defined(DUK_OPT_STRTAB_CHAIN_SIZE)
+  /* Low memory algorithm: separate chaining using arrays, fixed size hash */
+  #define DUK_USE_STRTAB_CHAIN_SIZE  DUK_OPT_STRTAB_CHAIN_SIZE
+  #endif
 introduced: 1.1.0
 requires:
   - DUK_USE_STRTAB_CHAIN

config/config-options/DUK_USE_STRTAB_PROBE.yaml

@@ -1,4 +1,9 @@
 define: DUK_USE_STRTAB_PROBE
+feature_snippet: |
+  #undef DUK_USE_STRTAB_PROBE
+  #if !(defined(DUK_OPT_STRTAB_CHAIN) && defined(DUK_OPT_STRTAB_CHAIN_SIZE))
+  #define DUK_USE_STRTAB_PROBE
+  #endif
 introduced: 1.1.0
 default: true
 tags:

config/config-options/DUK_USE_TAILCALL.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_TAILCALL
+feature_snippet: |
+  #if defined(DUK_OPT_NONSTD_FUNC_CALLER_PROPERTY)
+  #undef DUK_USE_TAILCALL
+  #else
+  #define DUK_USE_TAILCALL
+  #endif
 introduced: 1.0.0
 conflicts:
   - DUK_USE_NONSTD_FUNC_CALLER_PROPERTY

config/config-options/DUK_USE_TARGET_INFO.yaml

@@ -1,4 +1,10 @@
 define: DUK_USE_TARGET_INFO
+feature_snippet: |
+  #if defined(DUK_OPT_TARGET_INFO)
+  #define DUK_USE_TARGET_INFO DUK_OPT_TARGET_INFO
+  #else
+  #define DUK_USE_TARGET_INFO "unknown"
+  #endif
 introduced: 1.2.0
 default:
   string: "unknown"

config/config-options/DUK_USE_TRACEBACKS.yaml

@@ -1,4 +1,12 @@
 define: DUK_USE_TRACEBACKS
+feature_snippet: |
+  #if defined(DUK_OPT_NO_AUGMENT_ERRORS)
+  #undef DUK_USE_TRACEBACKS
+  #elif defined(DUK_OPT_NO_TRACEBACKS)
+  #undef DUK_USE_TRACEBACKS
+  #else
+  #define DUK_USE_TRACEBACKS
+  #endif
 introduced: 1.0.0
 default: true
 tags: