update init documentation

diff --git a/msp4th/msp4th.c b/msp4th/msp4th.c
index 22d4e6fdf57fd6fa91a8740044eed8d7ae4430f3..2ac9525252b08d33b61869dec10a617415904626 100644 (file)
--- a/msp4th/msp4th.c
+++ b/msp4th/msp4th.c
@@ -1502,11 +1502,15 @@ GCC_DIAG_ON(int-to-pointer-cast);
 void msp4th_init(struct msp4th_config *c)
 {
     /*
-     * Get addresses of user-configurable arrays from the pre-known vector
-     * table locations.
+     * Startup the interpreter with a given configuration.  Struct describes
+     * the locations of the stacks, user program code and names, input
+     * buffers, and the terminal input/output functions.  See main() for
+     * an example of usage.
      *
-     * Changing the values in the msp4th_* locations and calling
-     * msp4th_init() again restarts the interpreter with the new layout;
+     * Changing the struct and calling msp4th_init() again restarts the
+     * interpreter with the new layout.  This allows expanding the RAM
+     * available to the interpreter if necessary for larger programs, or even
+     * injection of pre-compiled user code.
      */
     mathStackPtr = c->mathStackStart;
     addrStackPtr = c->addrStackStart;