Addressed issue #73.

src/chain-complexes.lisp

@@ -239,10 +239,12 @@ follows:
             of the differential homomorphism, either by generator or by
             combination. The default is :GNRT
 
-:ORGN ORGN, a list containing a relevant and carefully chosen comment about
+:ORGN ORGN, a list which is the copy of a Lisp statement, in principle the
-            the origin of the chain complex. This comment should be unique
+            statement which was at the origin of the creation of this Kenzo
-            for a Kenzo session (between calls of CAT-INIT), as it is used
+            object. A caching process, using this slot, prevents the creation
-            for caching purposes.
+            of multiple copies of the same mathematical object, which is
+            important for efficiency. It is used also for debugging and
+            analyzing the program.
 
 Use this function instead of creating instances via the standard constructor
 MAKE-INSTANCE.
@@ -308,10 +310,12 @@ follows:
             of the differential homomorphism, either by generator or by
             combination. The default is :GNRT
 
-:ORGN ORGN, a list containing a relevant and carefully chosen comment about
+:ORGN ORGN, a list which is the copy of a Lisp statement, in principle the
-            the origin of the chain complex. This comment should be unique
+            statement which was at the origin of the creation of this Kenzo
-            for a Kenzo session (between calls of CAT-INIT), as it is used
+            object. A caching process, using this slot, prevents the creation
-            for caching purposes.
+            of multiple copies of the same mathematical object, which is
+            important for efficiency. It is used also for debugging and
+            analyzing the program.
 
 Use this function instead of creating instances via the standard constructor
 MAKE-INSTANCE.

src/classes.lisp

@@ -192,9 +192,11 @@ Intances of this class represent chain complexes. The class has 8 slots:
 7. IDNM, an integer, a system generated identifier for this object. Its reader
    function is IDNM.
 
-8. ORGN, a list containg a comment indicating the origin of the object. The
+8. ORGN, a list which is the copy of a Lisp statement, in principle the
-   should be unique (per session), since it is used in the implementation for
+   statement which was at the origin of the creation of this Kenzo object.
-   caching purposes. Its reader function is ORGN.
+   A caching process, using this slot, prevents the creation of multiple
+   copies of the same mathematical object, which is important for efficiency.
+   It is used also for debugging and analyzing the program.
 -----------------------------------------------------------------------------"))
 
 
@@ -275,9 +277,11 @@ degree -1. The class has 10 slots:
 9. IDNM, an integer, a system-generated identifier for this object. Its reader
    function is IDNM.
 
-10. ORGN, a list containg a comment indicating the origin of the object. The
+10. ORGN, a list which is the copy of a Lisp statement, in principle the
-    should be unique (per session), since it is used in the implementation for
+    statement which was at the origin of the creation of this Kenzo object.
-    caching purposes. Its reader function is ORGN.
+    A caching process, using this slot, prevents the creation of multiple
+    copies of the same mathematical object, which is important for efficiency.
+    It is used also for debugging and analyzing the program.
 -----------------------------------------------------------------------------"))
 
 
@@ -335,13 +339,14 @@ The class has 7 slots:
 5. H, an object of type MORPHISM representing the morphism of graded modules h.
    Its reader function is H1.
 
-9. IDNM, an integer, a system-generated identifier for this object. Its reader
+6. IDNM, an integer, a system-generated identifier for this object. Its reader
    function is IDNM.
 
-10. ORGN, a list containg a comment indicating the origin of the object.
+7. ORGN, a list which is the copy of a Lisp statement, in principle the
-    This comment should be unique for a Kenzo session (between calls of
+   statement which was at the origin of the creation of this Kenzo object.
-    CAT-INIT), as it is used for caching purposes. Its reader function
+   A caching process, using this slot, prevents the creation of multiple
-    is ORGN.
+   copies of the same mathematical object, which is important for efficiency.
+   It is used also for debugging and analyzing the program.
 -----------------------------------------------------------------------------"))
 
 

src/effective-homology.lisp

@@ -54,10 +54,12 @@ follows:
 :H H, an object of type MORPHISM representing the morphism of graded modules h
             of a reduction
 
-:ORGN ORGN, a list containing a relevant and carefully chosen comment about
+:ORGN ORGN, a list which is the copy of a Lisp statement, in principle the
-            the origin of the chain complex. This comment should be unique
+            statement which was at the origin of the creation of this Kenzo
-            for a Kenzo session (between calls of CAT-INIT), as it is used
+            object. A caching process, using this slot, prevents the creation
-            for caching purposes.
+            of multiple copies of the same mathematical object, which is
+            important for efficiency. It is used also for debugging and
+            analyzing the program.
 
 Use this function instead of creating instances via the standard constructor
 MAKE-INSTANCE.