commenting and cleaning up synth.mlua

diff --git a/src/samples/synth.mlua b/src/samples/synth.mlua
index d73e68a424ff739c1bcce2860492cc431c11d895..e572b4bcf24e8b16055f4bc860144986a289f581 100644 (file)
--- a/src/samples/synth.mlua
+++ b/src/samples/synth.mlua
@@ -177,6 +177,10 @@ function synth:list (list, sep, start)
 end
 
 --------------------------------------------------------------------------------
+--
+-- Tag methods.
+-- ------------
+--
 -- Specific AST node dumping methods, associated to their node kinds
 -- by their name, which is the corresponding AST tag.
 -- synth:node() is in charge of delegating a node's treatment to the
@@ -187,11 +191,14 @@ end
 --
 -- There are several things that could be refactored into common subroutines
 -- here: statement blocks dumping, function dumping...
--- However, given their small size and linear execution, it seems more
--- readable to avoid multiplication of such tiny functions.
+-- However, given their small size and linear execution
+-- (they basically perform series of :acc(), :node(), :list(), 
+-- :nl(), :nlindent() and :nldedent() calls), it seems more readable
+-- to avoid multiplication of such tiny functions.
 --
 -- To make sense out of these, you need to know metalua's AST syntax, as
 -- found in the reference manual or in metalua/doc/ast.txt.
+--
 --------------------------------------------------------------------------------
 
 function synth:Do (node)