- -*- text -*-
-
-This directory contains examples illustrating various aspects of Guile
-programming.
-
-See the README files in the subdirectories for details.
-
-scripts Examples for writing simple scripts in Guile Scheme.
-box Example for extending Guile with a new data type.
-box-module Similar to `box', but define new procedures in a named module.
-box-dynamic Implements the box type in a dynamically loadable library.
-modules Examples for writing and using Guile modules.
-safe Examples for creating and using safe environments.
+ -*- outline -*-
+
+* Overview
+
+This directory contains examples illustrating various aspects of Guile
+programming.
+
+If you plan writing Scheme programs, have a look at the `scripts'
+directory. To learn more about Guile modules, check out the `modules'
+directory, and maybe the `box-module' and `box-dynamic-module'
+directories, if you are into C programming or shared libraries,
+respectively. The `safe' directory contains examples for evaluation
+Scheme code in controlled environments (sandboxing). The directories
+`box', `box-module', `box-dynamic' and `box-dynamic-module' are
+interesting if you plan writing Guile extensions.
+
+See the README files in the subdirectories for details.
+
+
+* Included Examples
+
+scripts Examples for writing simple scripts in Guile Scheme.
+
+box Example for extending Guile with a new data type.
+
+box-module Similar to `box', but defines new procedures in a
+ named module.
+box-dynamic Implements the box type in a dynamically loadable
+ library.
+box-dynamic-module Combination of `box-module' and `box-dynamic':
+ Implements the `box' type in a shared library and
+ defines the procedures in a Guile module.
+
+modules Examples for writing and using Guile modules.
+
+safe Examples for creating and using safe environments.
+
+compat autoconf code for making a Guile extension
+ compatible with older versions of Guile.
+