diff --git a/examples/example1/example1.yml2 b/examples/example1/example1.yml2
index fa425f2..f77a9bf 100644
--- a/examples/example1/example1.yml2
+++ b/examples/example1/example1.yml2
@@ -7,12 +7,14 @@ pEpACIDLang {
         copyleft "Copyleft text";
 
         api api1 {
-            // creates a type-alias with optional
-            // properties to specialize the type.
-            // the aliased type must be a basetype
+            // deftype is used for two things:
+            // * create a type-alias for any type with optional
+            //   properties to narrow the definition of the type.
+            // * instantiate a "generic type" into a (concrete) type
             deftype deftype1 as size;
             deftype deftype2 as string;
             deftype stringlist as list<string>;
+            deftype stringlist2 as stringlist;
 
             enum enum1 {
                 item item1 doc="item with automatic value";
@@ -71,7 +73,6 @@ pEpACIDLang {
             };
 
 
-
             // TEST
             // ----