Add extras/ dir, add READMEs for extras+examples

dist-files/README.rst

@@ -55,6 +55,11 @@ Duktape itself is widely portable, some of the examples are Linux only.
 For instance the ``eventloop`` example illustrates how ``setTimeout()``
 and other standard timer functions could be implemented on Unix/Linux.
 
+The ``extras/`` directory provides utilities and modules which don't
+comfortably fit into the main Duktape library because of footprint or
+portability concerns.  Extras are maintained and bug fixed code, but
+don't have the same version guarantees as the main Duktape library.
+
 The ``polyfills/`` directory provides a few replacement suggestions for
 non-standard Javascript functions provided by other implementations.
 

examples/README.rst

@@ -0,0 +1,10 @@
+================
+Duktape examples
+================
+
+Examples for using Duktape.  These support user documentation and are
+intended as informative illustrations only.
+
+Examples are unmaintained and are not production quality code.  Bugs are
+not not necessarily fixed, unless the bug makes the example misleading
+as documentation.

extras/README.rst

@@ -0,0 +1,13 @@
+==============
+Duktape extras
+==============
+
+Extra modules and utilities.  Extras provide functionality that doesn't
+comfortably fit into the main Duktape library, perhaps for footprint or
+portability reasons, but are still useful for most users.
+
+Extras are maintained and will be bug fixed.  However, they don't have the
+same semantic versioning guarantees like the main Duktape library.  Extras
+may be dropped without warning as Duktape is versioned.  For instance, if
+an extra breaks due to Duktape changes and there is no time to fix it, the
+missing extra won't block a release and will be dropped.

util/make_dist.sh

@@ -54,6 +54,7 @@ rm -rf $DIST
 mkdir $DIST
 mkdir $DIST/src-separate
 mkdir $DIST/src
+mkdir $DIST/extras
 mkdir $DIST/polyfills
 #mkdir $DIST/doc
 mkdir $DIST/licenses
@@ -196,7 +197,7 @@ for i in \
 	cp polyfills/$i $DIST/polyfills/ || exit 1
 done
 
-
+cp examples/README.rst $DIST/examples/ || exit 1
 for i in \
 	README.rst \
 	duk_cmdline.c \
@@ -271,6 +272,9 @@ for i in \
 	cp examples/sandbox/$i $DIST/examples/sandbox/ || exit 1
 done
 
+cp extras/README.rst $DIST/extras/ || exit
+# XXX: copy extras
+
 for i in \
 	Makefile.cmdline \
 	Makefile.eventloop \

website/guide/versioning.html

@@ -28,6 +28,7 @@ <h2>Semantic versioning</h2>
     guarantees). Such changes are noted in release notes, and the goal is to cause
     a compile error when a no-longer-supported feature option is used so that any
     incorrect assumptions can be fixed.</li>
+<li>Extras distributed with Duktape (<code>extras/</code> directory).</li>
 </ul>
 
 <h2>Version naming</h2>