From 61296642cbf8fa29a8af855294fd11d2d43e79d5 Mon Sep 17 00:00:00 2001
From: Dave Mitchell <davem@fdisolutions.com>
Date: Sun, 1 Aug 2004 16:49:20 +0000
Subject: [PATCH] Add comment to top of reentr.c and fix typos in other files

p4raw-id: //depot/perl@23180
---
 deb.c          |  4 ++--
 dump.c         |  2 +-
 miniperlmain.c |  4 ++--
 pad.c          |  4 ++--
 perly.y        |  2 +-
 reentr.c       |  8 +++++++-
 reentr.h       |  2 +-
 reentr.pl      | 10 ++++++++--
 regcomp.c      |  4 ++--
 regexec.c      |  4 ++--
 scope.c        |  2 +-
 utf8.c         |  4 ++--
 12 files changed, 31 insertions(+), 19 deletions(-)

diff --git a/deb.c b/deb.c
index 21688c3..58b49a6 100644
--- a/deb.c
+++ b/deb.c
@@ -14,8 +14,8 @@
  */
 
 /*
- * This file contains various utilites for producing debugging output
- * (mainly related to  displaying the stack)
+ * This file contains various utilities for producing debugging output
+ * (mainly related to displaying the stack)
  */
 
 #include "EXTERN.h"
diff --git a/dump.c b/dump.c
index f80416b..5f0bef2 100644
--- a/dump.c
+++ b/dump.c
@@ -14,7 +14,7 @@
  */
 
 /* This file contains utility routines to dump the contents of SV and OP
- * structures, as used by comand-line options like -Dt and -Dx, and
+ * structures, as used by command-line options like -Dt and -Dx, and
  * by Devel::Peek.
  *
  * It also holds the debugging version of the  runops function.
diff --git a/miniperlmain.c b/miniperlmain.c
index 3cc25f8..3c13b7e 100644
--- a/miniperlmain.c
+++ b/miniperlmain.c
@@ -18,12 +18,12 @@
  *
  * Miniperl is like perl except that does not support dynamic loading,
  * and in fact is used to build the dynamic modules need for the 'real'
- * perl execuable.
+ * perl executable.
  */
 
 #ifdef OEMVS
 #ifdef MYMALLOC
-/* sbrk is limited to first heap segement so make it big */
+/* sbrk is limited to first heap segment so make it big */
 #pragma runopts(HEAP(8M,500K,ANYWHERE,KEEP,8K,4K) STACK(,,ANY,) ALL31(ON))
 #else
 #pragma runopts(HEAP(2M,500K,ANYWHERE,KEEP,8K,4K) STACK(,,ANY,) ALL31(ON))
diff --git a/pad.c b/pad.c
index dc220f5..f1d15ab 100644
--- a/pad.c
+++ b/pad.c
@@ -22,9 +22,9 @@
 /*
 =head1 Pad Data Structures
 
-This file contains the functions that create and manipluate scratchpads,
+This file contains the functions that create and manipulate scratchpads,
 which are array-of-array data structures attached to a CV (ie a sub)
-and which store lexical variables and opcode temporay and per-thread
+and which store lexical variables and opcode temporary and per-thread
 values.
 
 =for apidoc m|AV *|CvPADLIST|CV *cv
diff --git a/perly.y b/perly.y
index 5d1b19f..0d00b95 100644
--- a/perly.y
+++ b/perly.y
@@ -18,7 +18,7 @@
  *
  * The main job of of this grammar is to call the various newFOO()
  * functions in op.c to build a syntax tree of OP structs.
- * It relies in the lexer in toke.c to do the tokenizing.
+ * It relies on the lexer in toke.c to do the tokenizing.
  */
 
 /*  Make the parser re-entrant. */
diff --git a/reentr.c b/reentr.c
index 493a3b5..c2972e0 100644
--- a/reentr.c
+++ b/reentr.c
@@ -7,11 +7,17 @@
  *    License or the Artistic License, as specified in the README file.
  *
  *  !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by reentrl.pl from data in reentr.pl.
+ *  This file is built by reentr.pl from data in reentr.pl.
  *
  * "Saruman," I said, standing away from him, "only one hand at a time can
  *  wield the One, and you know that well, so do not trouble to say we!"
  *
+ * This file contains a collection of automatically created wrappers
+ * (created by running reentr.pl) for reentrant (thread-safe) versions of
+ * various library calls, such as getpwent_r.  The wrapping is done so
+ * that other files like pp_sys.c calling those library functions need not
+ * care about the differences between various platforms' idiosyncrasies
+ * regarding these reentrant interfaces.  
  */
 
 #include "EXTERN.h"
diff --git a/reentr.h b/reentr.h
index 5e6e274..728dcbc 100644
--- a/reentr.h
+++ b/reentr.h
@@ -7,7 +7,7 @@
  *    License or the Artistic License, as specified in the README file.
  *
  *  !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by reentrl.pl from data in reentr.pl.
+ *  This file is built by reentr.pl from data in reentr.pl.
  */
 
 #ifndef REENTR_H
diff --git a/reentr.pl b/reentr.pl
index 0622a80..f4d754a 100644
--- a/reentr.pl
+++ b/reentr.pl
@@ -47,7 +47,7 @@ print <<EOF;
  *    License or the Artistic License, as specified in the README file.
  *
  *  !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by reentrl.pl from data in reentr.pl.
+ *  This file is built by reentr.pl from data in reentr.pl.
  */
 
 #ifndef REENTR_H
@@ -751,11 +751,17 @@ print <<EOF;
  *    License or the Artistic License, as specified in the README file.
  *
  *  !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
- *  This file is built by reentrl.pl from data in reentr.pl.
+ *  This file is built by reentr.pl from data in reentr.pl.
  *
  * "Saruman," I said, standing away from him, "only one hand at a time can
  *  wield the One, and you know that well, so do not trouble to say we!"
  *
+ * This file contains a collection of automatically created wrappers
+ * (created by running reentr.pl) for reentrant (thread-safe) versions of
+ * various library calls, such as getpwent_r.  The wrapping is done so
+ * that other files like pp_sys.c calling those library functions need not
+ * care about the differences between various platforms' idiosyncrasies
+ * regarding these reentrant interfaces.  
  */
 
 #include "EXTERN.h"
diff --git a/regcomp.c b/regcomp.c
index 796d8fe..7587498 100644
--- a/regcomp.c
+++ b/regcomp.c
@@ -5,8 +5,8 @@
  * "A fair jaw-cracker dwarf-language must be."  --Samwise Gamgee
  */
 
-/* This file contains functions for compiling a regular expresssion.  See
- * also regexec.c which funnnily enough, contains functions for executing
+/* This file contains functions for compiling a regular expression.  See
+ * also regexec.c which funnily enough, contains functions for executing
  * a regular expression.
  */
 
diff --git a/regexec.c b/regexec.c
index d0d0ce7..e843478 100644
--- a/regexec.c
+++ b/regexec.c
@@ -5,8 +5,8 @@
  * "One Ring to rule them all, One Ring to find them..."
  */
 
-/* This file contains functions for executing a regular expresssion.  See
- * also regcomp.c which funnnily enough, contains functions for compiling
+/* This file contains functions for executing a regular expression.  See
+ * also regcomp.c which funnily enough, contains functions for compiling
  * a regular expression.
  */
 
diff --git a/scope.c b/scope.c
index 8dfb6c6..492ce60 100644
--- a/scope.c
+++ b/scope.c
@@ -13,7 +13,7 @@
  * levels..."
  */
 
-/* This function contains functions to manipluate various of perl's stacks;
+/* This file contains functions to manipulate 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
diff --git a/utf8.c b/utf8.c
index 2608924..e480ced 100644
--- a/utf8.c
+++ b/utf8.c
@@ -31,8 +31,8 @@ static char unees[] = "Malformed UTF-8 character (unexpected end of string)";
 
 This file contains various utility functions for manipulating UTF8-encoded
 strings. For the uninitiated, this is a method of representing arbitrary
-Unicde characters as a variable number of bytes, in such a way that
-characters in the ASCII range are unmodifed, and a zero byte never appears.
+Unicode characters as a variable number of bytes, in such a way that
+characters in the ASCII range are unmodified, and a zero byte never appears.
 
 =for apidoc A|U8 *|uvuni_to_utf8_flags|U8 *d|UV uv|UV flags
 
-- 
2.7.4