[Axiom-developer] Misleading documentation

[Waldek Hebisch]

src/interp/Makfile.pamphlet contains misleading information about
the TRANOBJS group of files. The following patch (at least partially)
correct this information:

--- pp/build-improvements/src/interp/Makefile.pamphlet  2006-10-14 
19:58:17.000000000 +0200
+++ build-improvements-1012.nn2/src/interp/Makefile.pamphlet    2006-10-20 
02:57:49.642820264 +0200
@@ -308,9 +308,19 @@
 autoload_objects += $(BFOBJS)
 
 @
-The {\bf TRANOBJS} list contains files only used by the {\bf boot}
+The {\bf TRANOBJS} list contains files used by Spad to Aldor convertor.
+The files probably are also used by the {\bf boot}
 to Common Lisp translator and are probably never used by anyone
-but the developers. These files should probably be autoloaded.
+but the developers.
+
+When a user requests converting a file from Spad to Aldor the
+function
+[[spad2AsTranslatorAutoloadOnceTrigger]] is called triggering
+load of this group of files. Loading [[$TRANOBJS]] in turn replaces
+many compiler functions by versions contain in this files.
+ These files should probably be autoloaded
+(at least [[${AUTO}/wi1.$(OBJEXT)]] and [[${AUTO}/wi2.$(OBJEXT)]]
+(which replace compiler functions) {\em must} be autoloaded).
 <<environment>>=
 TRANOBJS= ${AUTO}/wi1.$(OBJEXT) ${AUTO}/wi2.$(OBJEXT) ${AUTO}/pspad1.$(OBJEXT) 
\
          ${AUTO}/pspad2.$(OBJEXT) ${AUTO}/mark.$(OBJEXT) 
${AUTO}/nspadaux.$(OBJEXT) \


-- 
                              Waldek Hebisch
address@hidden