better document Miniperl.pm, (mini)perlmain.c

ExtUtils::Miniperl is used to generate both miniperlmain.c and perlmain.c,
but in different ways (via regen and via make respectively).

Update the pod in Miniperl.pm to explain this more clearly, and
imporve the header comment it emits in miniperlmain.c and perlmain.c.

1 files changed, 10 insertions, 3 deletions

diff --git a/miniperlmain.c b/miniperlmain.c
index fa7951f73b..a79099bcac 100644
--- a/miniperlmain.c
+++ b/miniperlmain.c
@@ -4,10 +4,10 @@
    Any changes made here will be lost!
  */
 
-/*    miniperlmain.c
+/*    miniperlmain.c or perlmain.c - a generated file
  *
  *    Copyright (C) 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2002, 2003,
- *    2004, 2005, 2006, 2007, by Larry Wall and others
+ *    2004, 2005, 2006, 2007, 2016 by Larry Wall and others
  *
  *    You may distribute under the terms of either the GNU General Public
  *    License or the Artistic License, as specified in the README file.
@@ -24,11 +24,18 @@
 
 /* This file contains the main() function for the perl interpreter.
  * Note that miniperlmain.c contains main() for the 'miniperl' binary,
- * while perlmain.c contains main() for the 'perl' binary.
+ * while perlmain.c contains main() for the 'perl' binary. The typical
+ * difference being that the latter includes Dynaloader.
  *
  * Miniperl is like perl except that it does not support dynamic loading,
  * and in fact is used to build the dynamic modules needed for the 'real'
  * perl executable.
+ *
+ * The content of the body of this generated file is mostly contained
+ * in Miniperl.pm - edit that file if you want to change anything.
+ * miniperlmain.c is generated by running regen/miniperlmain.pl.pl, while
+ * perlmain.c is built automatically by Makefile (so the former is
+ * included in the tarball while the latter isn't).
  */
 
 #ifdef OEMVS