Add comment to the top of most .c files explaining their purpose

p4raw-id: //depot/perl@23176

1 files changed, 7 insertions, 0 deletions

diff --git a/scope.c b/scope.c
index 54d0ac1755..d5b8b7fbad 100644
--- a/scope.c
+++ b/scope.c
@@ -13,6 +13,13 @@
  * levels..."
  */
 
+/* This function contains functions to manipluate various of perl's stacks;
+ * in particular it contains code to push various types of things onto
+ * the savestack, then to pop them off and perform the correct restorative
+ * action for each one. This corresponds to the cleanup Perl does at
+ * each scope exit.
+ */
+
 #include "EXTERN.h"
 #define PERL_IN_SCOPE_C
 #include "perl.h"