[PATCH] Clarify PERL_SYS_INIT3() usage.

[Niko Tyni]

As seen in [perl #64326] and <http://bugs.debian.org/522099>, the
PERL_SYS_INIT3() documentation in perlembed.pod could be clearer about
the macro arguments.
---
 pod/perlembed.pod |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/pod/perlembed.pod b/pod/perlembed.pod
index 39364eb..3a16b98 100644
--- a/pod/perlembed.pod
+++ b/pod/perlembed.pod
@@ -202,6 +202,10 @@ of the C runtime environment necessary to run Perl interpreters; since
 PERL_SYS_INIT3() may change C<env>, it may be more appropriate to provide
 C<env> as an argument to perl_parse().
 
+Also notice that no matter what arguments you pass to perl_parse(),
+PERL_SYS_INIT3() must be invoked on the C main() argc, argv and env and
+only once.
+
 Now compile this program (I'll call it I<interp.c>) into an executable:
 
     % cc -o interp interp.c `perl -MExtUtils::Embed -e ccopts -e ldopts`
-- 
1.5.6.5


--7JfCtLOvnd9MIVvH--