From 7b8efacbb1727e113e4959cbe88921d459f35f43 Mon Sep 17 00:00:00 2001 From: Nick Ing-Simmons Date: Wed, 4 Aug 2004 18:16:47 +0000 Subject: Comment describing purpose. p4raw-id: //depot/perl@23195 --- globals.c | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) (limited to 'globals.c') diff --git a/globals.c b/globals.c index 5c487b9d99..994ca8da95 100644 --- a/globals.c +++ b/globals.c @@ -12,6 +12,24 @@ * 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" -- cgit v1.2.1