summaryrefslogtreecommitdiff
path: root/examples/README
diff options
context:
space:
mode:
Diffstat (limited to 'examples/README')
-rw-r--r--examples/README21
1 files changed, 19 insertions, 2 deletions
diff --git a/examples/README b/examples/README
index 2a362f2cd..793d131c8 100644
--- a/examples/README
+++ b/examples/README
@@ -1,12 +1,28 @@
- -*- text -*-
+ -*- 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
@@ -14,6 +30,7 @@ box-dynamic Implements the box type in a dynamically loadable
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.
+safe Examples for creating and using safe environments.