=================
Duktape genconfig
=================

Overview
========

``genconfig`` is a helper script for coming up with a ``duk_config.h`` for
compiling Duktape for your platform.

To support this:

* It creates a Duktape 1.2.x compatible ``duk_config.h`` with automatic
  platform detection and ``DUK_OPT_xxx`` feature options.

* It helps to create a ``duk_config.h`` for your platform/compiler
  combination.  You can give a base configuration and then force certain
  values manually based on a YAML configuration file.

* It autogenerates documentation for config options (and Duktape 1.2.x
  feature options) based on option metadata files written in YAML.

Usage
=====

To create an autodetect duk_config.h header (compatible with Duktape 1.2.x)::

    $ python config/genconfig.py --metadata config --output /tmp/duk_config.h \
          autodetect-header

To create a barebones duk_config.h header for a specific platform (easier to
edit manually)::

    $ python config/genconfig.py --metadata config --output /tmp/duk_config.h \
          --platform linux --compiler gcc --architecture x64 \
          barebones-header

There are further commands to e.g. autogenerate config option documentation;
see ``genconfig.py`` for details.