Index: Makefile.in
===================================================================
diff -u -r17880e63ccb02577a5c856aaa6344cd83028a07b -r5693145107c55b5f64bf0fb487aa43e0f2238f1a
--- Makefile.in	(.../Makefile.in)	(revision 17880e63ccb02577a5c856aaa6344cd83028a07b)
+++ Makefile.in	(.../Makefile.in)	(revision 5693145107c55b5f64bf0fb487aa43e0f2238f1a)
@@ -47,6 +47,7 @@
 appdirs		= 
 appsrc		= COPYRIGHT 
 
+
 # XOTcl subpackage
 xotcl_srcdir	= ${srcdir}/library/xotcl
 xotcl_src_doc_dir = ${xotcl_srcdir}/doc
@@ -222,6 +223,21 @@
 # Start of user-definable TARGETS section
 #========================================================================
 
+EXAMPLE_SCRIPTS = \
+	$(src_doc_dir)/example-scripts/bagel.html \
+	$(src_doc_dir)/example-scripts/rosetta-classes.html \
+	$(src_doc_dir)/example-scripts/rosetta-constraint-genericity.html \
+	$(src_doc_dir)/example-scripts/rosetta-delegates.html \
+	$(src_doc_dir)/example-scripts/rosetta-distinct-objects.html \
+	$(src_doc_dir)/example-scripts/rosetta-polymorphic-copy.html \
+	$(src_doc_dir)/example-scripts/rosetta-polymorphism.html \
+	$(src_doc_dir)/example-scripts/rosetta-serialization.html \
+	$(src_doc_dir)/example-scripts/rosetta-singleton.html \
+
+%.html : %.tcl
+	$(TCLSH) $(src_app_dir_native)/utils/source-doc-beautifier.tcl $<
+	asciidoc $*.txt
+
 #========================================================================
 # TEA TARGETS.  Please note that the "libraries:" target refers to platform
 # independent files, and the "binaries:" target inclues executable programs and
@@ -254,10 +270,12 @@
 libraries-pkgindex: pkgIndex.tcl
 	@$(TCLSH) $(src_lib_dir_native)/lib/make.tcl -dir $(src_lib_dir_native) -all
 
-fulldoc: doc pdf
+full-doc: doc pdf example-doc
 # use language reference as sample file to trigger generation of documentation files
 doc: $(xotcl_target_doc_dir)/langRef-xotcl.html
 
+example-doc: $(EXAMPLE_SCRIPTS)
+
 $(xotcl_target_doc_dir)/langRef-xotcl.html: pkgIndex.tcl $(xotcl_src_doc_dir)/langRef.xotcl $(XODOC_SOURCE)
 	@docs=""; \
 	for i in $(XODOC_SOURCE); do docs="$$docs `@CYGPATH@ $$i`"; done; \
@@ -415,6 +433,16 @@
 	$(TCLSH) $(src_test_dir_native)/mixinof.test -libdir $(PLATFORM_DIR) $(TESTFLAGS)
 	$(TCLSH) $(src_test_dir_native)/tcl86.test -libdir $(PLATFORM_DIR) $(TESTFLAGS)
 	$(TCLSH) $(src_test_dir_native)/contains.test -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/bagel.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-singleton.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-classes.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-constraint-genericity.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-delegates.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-distinct-objects.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-polymorphic-copy.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-polymorphism.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-serialization.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
+	$(TCLSH) $(src_doc_dir_native)/example-scripts/rosetta-singleton.tcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)
 
 test-xotcl: $(TCLSH_PROG)
 	$(TCLSH) $(xotcl_src_test_dir)/testo.xotcl -libdir $(PLATFORM_DIR) $(TESTFLAGS)