Integrate:

[ 23173]
Fix and update Perl_grok_* docs.

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

[ 23180]
Add comment to top of reentr.c and fix typos in other files

[ 23187]
more typo fixes for change 3176 (comments at top of .c files)

[ 23195]
Comment describing purpose.

[ 23196]
Document sv_catpvn_nomg, sv_setsv_nomg and sv_catsv_nomg.

[ 23207]
fix minor nit in file description, to keep Jarkko happy

[ 23214]
Subject: api doc fix for SvSetMagicSV_nosteal
Message-ID: <411C150C.5020602@stason.org>
p4raw-link: @23214 on //depot/perl: 8066315874125a86ec0500eff546689dd0058589
p4raw-link: @23207 on //depot/perl: 56da48f7e00cdb289542091917287b81e0078360
p4raw-link: @23196 on //depot/perl: 0f76ff59727b0fa5128e3888186cfa355dc6891d
p4raw-link: @23195 on //depot/perl: 7b8efacbb1727e113e4959cbe88921d459f35f43
p4raw-link: @23187 on //depot/perl: ddfa107c1b1f4a56f36bb18fc7c4fc45ab1119d0
p4raw-link: @23180 on //depot/perl: 61296642cbf8fa29a8af855294fd11d2d43e79d5
p4raw-link: @23176 on //depot/perl: 166f8a29442475f7fe0e9216f957512a793bc4ed
p4raw-link: @23173 on //depot/perl: 7b667b5fb1c41f31aff1e46b9f74e36eb063010e

p4raw-id: //depot/maint-5.8/perl@23308
p4raw-integrated: from //depot/perl@23307 'copy in' globals.c locale.c
	(@19242..) perlio.c (@22509..) malloc.c (@23126..) numeric.c
	(@23173..) run.c (@23176..) 'edit in' perly.h (@22306..) dump.c
	perly.y regcomp.c regexec.c (@23176..) miniperlmain.c
	(@23180..) pod/perlapi.pod (@23196..) 'merge in' taint.c
	(@21563..) reentr.c reentr.h reentr.pl (@21660..) doop.c
	(@22509..) pp_pack.c (@22780..) universal.c (@23021..) hv.c
	(@23061..) doio.c (@23076..) pp_sort.c (@23102..) pp_sys.c
	(@23156..)
p4raw-integrated: from //depot/perl@23196 'edit in' sv.h (@22937..)
p4raw-integrated: from //depot/perl@23187 'edit in' perl.c (@23176..)
	mg.c (@23177..)
p4raw-integrated: from //depot/perl@23180 'edit in' scope.c (@23178..)
	'ignore' utf8.c (@23176..)
p4raw-integrated: from //depot/perl@23176 'edit in' pad.c (@22896..)
	deb.c (@23156..) 'merge in' gv.c (@22962..) op.c (@23115..)
	util.c (@23126..) pp.c (@23145..) pp_ctl.c pp_hot.c (@23156..)

1 files changed, 8 insertions, 2 deletions

diff --git a/reentr.pl b/reentr.pl
index 0026dda4e7..fa8b98e9e5 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
@@ -839,11 +839,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"