github
/
duktape
mirror of https://github.com/svaarala/duktape.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5812 Commits
65 Branches
60 Tags
84 MiB
 
 
 
 
 
 
Tree: 3da19ff2db
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '3da19ff2db'
${ noResults }
duktape/config
Sami Vaarala c0234dddf1
Define DUK_USE_TRACEBACK_DEPTH even w/o tracebacks 		9 years ago
..
config-options Define DUK_USE_TRACEBACK_DEPTH even w/o tracebacks 9 years ago
examples Config option changes for paranoid errors 9 years ago
feature-options Config metadata improvements 9 years ago
header-snippets Define DUK_USE_TRACEBACK_DEPTH even w/o tracebacks 9 years ago
other-defines Add duk_uidx_t type to config headers 9 years ago
README.rst Genconfig improvements and fixes 9 years ago
architectures.yaml Config metadata improvements 9 years ago
compilers.yaml Config metadata improvements 9 years ago
extract_unique_options.py Tool to extract DUK_USE/DUK_OPT from existing code 9 years ago
genconfig.py Genconfig DUK_LOSE_CONST (unused initially) 9 years ago
platforms.yaml Config metadata improvements 9 years ago
tags.yaml Config option changes for refzero torture 9 years ago

README.rst 

=================
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.