X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=globals.c;h=afb3f25158c062ecf2f13d6e24205682f6c9b229;hb=d74e8afc9309529cf5c6c4390fc311850865d506;hp=b88cb7b7c3f99fb540023bbbde7e3d3295111e17;hpb=d6376244c2261025775e8b11a6a64d7c9e0d1612;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/globals.c b/globals.c
index b88cb7b..afb3f25 100644
--- a/globals.c
+++ b/globals.c
@@ -1,12 +1,35 @@
 /*    globals.c
  *
- *    Copyright (c) 1997-2002, Larry Wall
+ *    Copyright (C) 1995, 1999, 2000, 2001, 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.
  *
  */
 
+/*
+ * "For the rest, they shall represent the other Free Peoples of the World:
+ * Elves, Dwarves, and Men." --Elrond
+ */
+
+/* This file exists to #include "perl.h" _ONCE_ with
+ * PERL_IN_GLOBALS_C defined. That causes various global varaiables
+ * in perl.h and other files it includes to be _defined_ (and initialized)
+ * rather than just declared.
+ *
+ * There is a #include "perlapi.h" which makes use of the fact
+ * that the object file created from this file will be included by linker
+ * (to resolve global variables). perlapi.h mention various other "API"
+ * functions not used by perl itself, but the functions get
+ * pulled into the perl executable via the refrerence here.
+ *
+ * Two printf() like functions have also found their way here.
+ * Most likely by analogy to the API scheme above (as perl doesn't
+ * use them) but they probably belong elsewhere the obvious place
+ * being in perlio.c
+ *
+*/
+
 #include "INTERN.h"
 #define PERL_IN_GLOBALS_C
 #include "perl.h"
@@ -30,3 +53,13 @@ Perl_printf_nocontext(const char *format, ...)
 }
 
 #include "perlapi.h"		/* bring in PL_force_link_funcs */
+
+/*
+ * Local variables:
+ * c-indentation-style: bsd
+ * c-basic-offset: 4
+ * indent-tabs-mode: t
+ * End:
+ *
+ * ex: set ts=8 sts=4 sw=4 noet:
+ */