perl-modperl-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rich...@hyperreal.org
Subject cvs commit: modperl-site/embperl Changes.pod.1.html Changes.pod.2.html Changes.pod.3.html Changes.pod.cont.html Embperl.pod.1.html Embperl.pod.10.html Embperl.pod.13.html Embperl.pod.2.html Embperl.pod.3.html Embperl.pod.5.html Embperl.pod.6.html Embperl.pod.cont.html Examples.html INSTALL.pod.1.html index.html
Date Tue, 10 Nov 1998 09:35:48 GMT
richter     98/11/10 01:35:48

  Modified:    embperl  Changes.pod.1.html Changes.pod.2.html
                        Changes.pod.3.html Changes.pod.cont.html
                        Embperl.pod.1.html Embperl.pod.10.html
                        Embperl.pod.13.html Embperl.pod.2.html
                        Embperl.pod.3.html Embperl.pod.5.html
                        Embperl.pod.6.html Embperl.pod.cont.html
                        Examples.html INSTALL.pod.1.html index.html
  Log:
  Embperl Webpages - Changes
  
  Revision  Changes    Path
  1.22      +9 -8      modperl-site/embperl/Changes.pod.1.html
  
  Index: Changes.pod.1.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Changes.pod.1.html,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -r1.21 -r1.22
  --- Changes.pod.1.html	1998/11/08 19:54:47	1.21
  +++ Changes.pod.1.html	1998/11/10 09:35:43	1.22
  @@ -8,7 +8,7 @@
   <blockquote>
     <blockquote>
       <H1><strong>
  -<A NAME="1_2b2_dev_That_s_what_current">1.2b2_dev -- That's what currently under
developement</a></strong></h1>
  +<A NAME="1_2b2_BETA_9_Nov_1998">1.2b2 (BETA) 9 Nov 1998</a></strong></h1>
     </blockquote>
   </blockquote>
   
  @@ -16,13 +16,8 @@
   <BR CLEAR=LEFT>
   <blockquote>
     <blockquote>
  -[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.cont.html">PREV (Revision History - Content)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">NEXT (1.2b1  8 Oct 1998)</a>]&nbsp;&nbsp;
<br><hr>
  +[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.cont.html">PREV (Revision History - Content)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">NEXT (1.2b1 (BETA)  8 Oct 1998)</a>]&nbsp;&nbsp;
<br><hr>
   <P>
  -NOTE: This version is only available via <A HREF="CVS.pod.1.html#INTRO">"CVS"</A>
  -
  -
  -
  -<P>
   <PRE>   - There is now a short form of the Execute function. You can
        now include a sub page in an Embperl page by simply writing
        [- Execute ('filename.html') -] or use
  @@ -56,6 +51,12 @@
        more readable, based on a patch from Todd Eigenshink.
      - Embperl compiles now with mod_ssl (from Ralf Engelschall). 
        Spotted by Dirk Lutzebaeck and Randel Schwartz.
  +   - Added a patch from Todd Eigenshink to build Embperl with
  +     Stronghold 2.4.1
  +   - Added patch from Gerald McLarnon so Embperl compiles on AIX
  +   - Added optAllowZeroFileSize to accept files of length 0, 
  +     without that option Embperl will report NOT_FOUND. 
  +     Suggested by Doug Bagley
   </PRE>
   <P>
   <PRE>   - fixed a wrong call to logerror when OPT_EXECCGI is not on, 
  @@ -87,7 +88,7 @@
      - Empty values (VALUE=&quot;&quot;) in input tags will not be overridden by
        value in %fdat
   </PRE>
  -<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.cont.html">PREV (Revision History - Content)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">NEXT (1.2b1  8 Oct 1998)</a>]&nbsp;&nbsp;
<br>
  +<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.cont.html">PREV (Revision History - Content)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">NEXT (1.2b1 (BETA)  8 Oct 1998)</a>]&nbsp;&nbsp;
<br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
       </font></p>
  
  
  
  1.10      +3 -3      modperl-site/embperl/Changes.pod.2.html
  
  Index: Changes.pod.2.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Changes.pod.2.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- Changes.pod.2.html	1998/10/25 21:10:59	1.9
  +++ Changes.pod.2.html	1998/11/10 09:35:43	1.10
  @@ -8,7 +8,7 @@
   <blockquote>
     <blockquote>
       <H1><strong>
  -<A NAME="1_2b1_8_Oct_1998">1.2b1  8 Oct 1998</a></strong></h1>
  +<A NAME="1_2b1_BETA_8_Oct_1998">1.2b1 (BETA)  8 Oct 1998</a></strong></h1>
     </blockquote>
   </blockquote>
   
  @@ -16,7 +16,7 @@
   <BR CLEAR=LEFT>
   <blockquote>
     <blockquote>
  -[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">PREV (1.2b2_dev -- That's what currently under developement)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.3.html">NEXT (1.1.1  15 Sep 1998)</a>]&nbsp;&nbsp;
<br><hr>
  +[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">PREV (1.2b2 (BETA) 9 Nov 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.3.html">NEXT (1.1.1  15 Sep 1998)</a>]&nbsp;&nbsp;
<br><hr>
   <P>
   <PRE>   - I have reworked the whole source code so Embperl is now
        going to be an object. This means Embperl is reentrant, you
  @@ -30,7 +30,7 @@
      - Errors of Input/Output function now also log to the httpd error log
      - Added an test for input file not found
   </PRE>
  -<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">PREV (1.2b2_dev -- That's what currently under developement)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.3.html">NEXT (1.1.1  15 Sep 1998)</a>]&nbsp;&nbsp;
<br>
  +<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">PREV (1.2b2 (BETA) 9 Nov 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.3.html">NEXT (1.1.1  15 Sep 1998)</a>]&nbsp;&nbsp;
<br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
       </font></p>
  
  
  
  1.7       +2 -2      modperl-site/embperl/Changes.pod.3.html
  
  Index: Changes.pod.3.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Changes.pod.3.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- Changes.pod.3.html	1998/10/25 21:11:01	1.6
  +++ Changes.pod.3.html	1998/11/10 09:35:43	1.7
  @@ -16,7 +16,7 @@
   <BR CLEAR=LEFT>
   <blockquote>
     <blockquote>
  -[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">PREV (1.2b1  8 Oct 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.4.html">NEXT (1.1.0  28 Jul 98)</a>]&nbsp;&nbsp;
<br><hr>
  +[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">PREV (1.2b1 (BETA)  8 Oct 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.4.html">NEXT (1.1.0  28 Jul 98)</a>]&nbsp;&nbsp;
<br><hr>
   <P>
   <PRE>   - A lot of documentation updates. Now Embperl ships with most of 
        the documentation which is also available on 
  @@ -46,7 +46,7 @@
        MailFormTo dies when it can't connect to mailserver. Spotted by
        Steffen Geschke.
   </PRE>
  -<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">PREV (1.2b1  8 Oct 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.4.html">NEXT (1.1.0  28 Jul 98)</a>]&nbsp;&nbsp;
<br>
  +<p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.2.html">PREV (1.2b1 (BETA)  8 Oct 1998)</a>]&nbsp;&nbsp;
[<a href="Changes.pod.4.html">NEXT (1.1.0  28 Jul 98)</a>]&nbsp;&nbsp;
<br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
       </font></p>
  
  
  
  1.10      +4 -4      modperl-site/embperl/Changes.pod.cont.html
  
  Index: Changes.pod.cont.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Changes.pod.cont.html,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- Changes.pod.cont.html	1998/10/25 21:11:02	1.9
  +++ Changes.pod.cont.html	1998/11/10 09:35:43	1.10
  @@ -16,7 +16,7 @@
   <BR CLEAR=LEFT>
   <blockquote>
     <blockquote>
  -[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">NEXT (1.2b2_dev -- That's what currently under developement)</a>]&nbsp;&nbsp;
<br><HTML>
  +[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Changes.pod.1.html">NEXT (1.2b2 (BETA) 9 Nov 1998)</a>]&nbsp;&nbsp;
<br><HTML>
   <HEAD>
   <TITLE>Changes.pod.cont</TITLE>
   <LINK REV="made" HREF="mailto:root@venus.gr.ecos.de">
  @@ -28,8 +28,8 @@
   
   <UL>
   
  -	<LI><A href="Changes.pod.1.html#1_2b2_dev_That_s_what_current">1.2b2_dev -
That's what currently under developement</A>
  -	<LI><A href="Changes.pod.2.html#1_2b1_8_Oct_1998">1.2b1  8 Oct 1998</A>
  +	<LI><A href="Changes.pod.1.html#1_2b2_BETA_9_Nov_1998">1.2b2 (BETA) 9 Nov
1998</A>
  +	<LI><A href="Changes.pod.2.html#1_2b1_BETA_8_Oct_1998">1.2b1 (BETA)  8 Oct
1998</A>
   	<LI><A href="Changes.pod.3.html#1_1_1_15_Sep_1998">1.1.1  15 Sep 1998</A>
   	<LI><A href="Changes.pod.4.html#1_1_0_28_Jul_98">1.1.0  28 Jul 98</A>
   	<LI><A href="Changes.pod.5.html#1_1b2_27_Jun_98">1.1b2  27 Jun 98</A>
  @@ -57,7 +57,7 @@
   	<LI><A href="Changes.pod.27.html#0_10beta_Jan_18_1997">0.10beta 	Jan 18 1997</A>
   </UL>
   <!-- INDEX END -->
  -<hr><p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a
href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp; [<a href="Changes.pod.1.html">NEXT
(1.2b2_dev -- That's what currently under developement)</a>]&nbsp;&nbsp; <br>
  +<hr><p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a
href="Changes.pod.cont.html">CONTENT</a>]&nbsp;&nbsp; [<a href="Changes.pod.1.html">NEXT
(1.2b2 (BETA) 9 Nov 1998)</a>]&nbsp;&nbsp; <br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
       </font></p>
  
  
  
  1.5       +27 -2     modperl-site/embperl/Embperl.pod.1.html
  
  Index: Embperl.pod.1.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.1.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- Embperl.pod.1.html	1998/10/08 20:57:59	1.4
  +++ Embperl.pod.1.html	1998/11/10 09:35:44	1.5
  @@ -197,14 +197,29 @@
   example to store a common header or footer in an different file). 
   
   <P>
  -Execute takes a hash reference as its argument. This gives it the chance to
  +There are two forms you can use for calling Execute. A short form which
  +only takes an filename and optional additional parameters or a long form
  +which takes a hash reference as its argument. This gives it the chance to
   vary the parameters according to the job that should be done.
   
   <P>
   (See <STRONG>eg/x/Excute.pl</STRONG> for more detailed examples)
   
   <P>
  -Possible items are:
  +<PRE>  Execute($filename, $p1, $p2, $pn) ;
  +</PRE>
  +<P>
  +This will cause Embperl to interpret the file with the name
  +<CODE>$filename</CODE> and, if specified, pass any additional parameters in
  +the array @param (just like <CODE>@_</CODE> in a perl subroutine). The above
example
  +could also be written in the long form:
  +
  +<P>
  +<PRE>  Execute ({inputfile =&gt; $filename,
  +            param     =&gt; [$p1, $p2, $pn]}) ;
  +</PRE>
  +<P>
  +The possible items for hash of the long form are:
   
   <DL>
   <DT><STRONG><A NAME="item_inputfile">inputfile</A></STRONG><DD>
  @@ -235,6 +250,9 @@
   
   <DT><STRONG><A NAME="item_req_rec">req_rec</A></STRONG><DD>
   <P>
  +NOTE: The req_rec parameter isn't necessary anymore in versions &gt;= 1.2b2
  +
  +<P>
   If used under mod_perl, you should set the req_rec parameter to the Apache
   request record object provided by mod_perl.
   
  @@ -384,6 +402,13 @@
   </PRE>
   <P>
   <PRE> print $out ;
  +</PRE>
  +<P>
  +<PRE> # Include a common header in an Embperl page, 
  + # which is stored in /path/to/head.html
  + 
  + [- Execute ('/path/to/head.html') -]
  + 
   </PRE>
   <p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Embperl.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.cont.html">PREV (Documentation - Content)</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.2.html">NEXT (Runtime configuration)</a>]&nbsp;&nbsp;
<br>
       <font color="#808080">___________________________________________________________________________________<br>
  
  
  
  1.3       +1 -1      modperl-site/embperl/Embperl.pod.10.html
  
  Index: Embperl.pod.10.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.10.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Embperl.pod.10.html	1998/10/08 20:58:00	1.2
  +++ Embperl.pod.10.html	1998/11/10 09:35:44	1.3
  @@ -271,7 +271,7 @@
   Example:
   
   <P>
  -<PRE>   &lt;A HREF='<A HREF="http://host/script?name=&quot">http://host/script?name=&quot</A>;[+$n+]&quot;'&gt;
  +<PRE>   &lt;A HREF=&quot;<A HREF="http://host/script?name=">http://host/script?name=</A>[+$n+]&quot;&gt;
   </PRE>
   <P>
   When <CODE>$n</CODE> is ``My name'' the requested URL, when you click on
  
  
  
  1.4       +13 -5     modperl-site/embperl/Embperl.pod.13.html
  
  Index: Embperl.pod.13.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.13.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- Embperl.pod.13.html	1998/10/08 20:58:00	1.3
  +++ Embperl.pod.13.html	1998/11/10 09:35:44	1.4
  @@ -34,11 +34,14 @@
   <DT><STRONG><A NAME="item_perl5">perl5.005_01</A></STRONG><DD>
   <DT><STRONG><A NAME="item_apache_1">apache_1.2.5</A></STRONG><DD>
   <DT><STRONG><A NAME="item_apache_1">apache_1.2.6</A></STRONG><DD>
  -<DT><STRONG><A NAME="item_apache_1">apache_1.3b3</A></STRONG><DD>
  -<DT><STRONG><A NAME="item_apache_1">apache_1.3b5</A></STRONG><DD>
  -<DT><STRONG><A NAME="item_apache_1">apache_1.3b6</A></STRONG><DD>
  +<DT><STRONG><A NAME="item_apache_1">apache_1.3.0</A></STRONG><DD>
  +<DT><STRONG><A NAME="item_apache_1">apache_1.3.1</A></STRONG><DD>
  +<DT><STRONG><A NAME="item_apache_1">apache_1.3.2</A></STRONG><DD>
  +<DT><STRONG><A NAME="item_apache_1">apache_1.3.3</A></STRONG><DD>
   <DT><STRONG><A NAME="item_apache_ssl">apache_ssl (Ben SSL)</A></STRONG><DD>
   <DT><STRONG><A NAME="item_Stronghold">Stronghold 2.2</A></STRONG><DD>
  +<DT><STRONG>Stronghold 2.4.1</STRONG><DD>
  +<DT><STRONG><A NAME="item_Apache_1">Apache_1.3.3 with mod_ssl</A></STRONG><DD>
   </DL>
   <P>
   I know from other people that it works on many other UNIX systems
  @@ -49,8 +52,8 @@
   <DL>
   <DT><STRONG>perl5.004_04</STRONG><DD>
   <DT><STRONG><A NAME="item_perl5">perl5.005</A></STRONG><DD>
  -<DT><STRONG>apache_1.3b5</STRONG><DD>
  -<DT><STRONG><A NAME="item_apache_1">apache_1.3.1</A></STRONG><DD>
  +<DT><STRONG>apache_1.3.1</STRONG><DD>
  +<DT><STRONG>apache_1.3.2</STRONG><DD>
   </DL>
   <P>
   <HR>
  @@ -59,6 +62,11 @@
   <DT><STRONG><A NAME="item_perl5">perl5.004_02 (binary distribution)</A></STRONG><DD>
   <DT><STRONG><A NAME="item_Offline">Offline mode</A></STRONG><DD>
   </DL>
  +<P>
  +If you plan to use the nested Embperl pages (i.e. call Execute inside
  +another Embperl page) I recommend to upgrade to perl5.005 due to the better
  +stack-memory-allocation.
  +
   <p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Embperl.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.12.html">PREV (Bugs)</a>]&nbsp;&nbsp; [<a href="Embperl.pod.14.html">NEXT
(Support)</a>]&nbsp;&nbsp; <br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
  
  
  
  1.6       +15 -8     modperl-site/embperl/Embperl.pod.2.html
  
  Index: Embperl.pod.2.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.2.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- Embperl.pod.2.html	1998/10/08 20:58:01	1.5
  +++ Embperl.pod.2.html	1998/11/10 09:35:44	1.6
  @@ -215,9 +215,21 @@
   will handle the field as if an empty string was stored in
   <CODE>%fdat</CODE> for the field.
   
  -</DL>
  +<DT><STRONG><A NAME="item_optNoHiddenEmptyValue">optNoHiddenEmptyValue
= 65536 (only 1.2b2 and above)</A></STRONG><DD>
  +<P>
  +Normally, if there is a value defined in <CODE>%fdat</CODE> for a specific
  +input field, Embperl will output a hidden input element for it when you use <STRONG>hidden</STRONG>.
When this option is set, Embperl will not output a hidden input element
  +for this field when the value is a blank string.
  +
  +<DT><STRONG><A NAME="item_optAllowZeroFilesize">optAllowZeroFilesize
= 131072 (only 1.2b2 and above)</A></STRONG><DD>
  +<P>
  +Normaly Embperl reports NOT_FOUND (404) if a file of length zero is
  +requested. With this option set Embperl will return an empty document.
  +
   <P>
  -<HR>
  +<PRE> 
  +=back
  +</PRE>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_DEBUG">EMBPERL_DEBUG</A></H2>
   <P>
   This is a bitmask which specifies what should be written to the log. The
  @@ -329,8 +341,6 @@
   EMBPERL_VIRTLOG.) If Embperl crashes, add <CODE>512</CODE> so the logfile is
flushed after every line is written and you can see where
   Embperl is when it crashes.
   
  -<P>
  -<HR>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_INPUT_FUNC">EMBPERL_INPUT_FUNC</A></H2>
   <P>
   This directive gives you the possiblity to specify a non-standard way of
  @@ -417,8 +427,6 @@
   <P>
   See also <A href="Embperl.pod.9.html#ProxyInput_r_in_mtime_sr">ProxyInput</A>
below, for an input function which comes with Embperl.
   
  -<P>
  -<HR>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_OUTPUT_FUNC">EMBPERL_OUTPUT_FUNC</A></H2>
   <P>
   This directive allows you to specify a non-standard way of dealing with
  @@ -483,12 +491,11 @@
   <P>
   See also <A href="Embperl.pod.9.html#LogOutput_r_out_basepath_">LogOutput</A>
below, for an output function which comes with Embperl.
   
  -<P>
  -<HR>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_MAILHOST">EMBPERL_MAILHOST</A></H2>
   <P>
   Specifies which host the <A href="Embperl.pod.8.html#MailFormTo_MailTo_Subject_R">MailFormTo</A>
function uses as SMTP server. Default is <STRONG>localhost</STRONG>.
   
  +</DL>
   <p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Embperl.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.1.html">PREV (Operating-Modes)</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.3.html">NEXT (SYNTAX)</a>]&nbsp;&nbsp; <br>
       <font color="#808080">___________________________________________________________________________________<br>
       HTML::Embperl - Copyright (c) 1997-1998 Gerald Richter / ECOS
  
  
  
  1.4       +93 -4     modperl-site/embperl/Embperl.pod.3.html
  
  Index: Embperl.pod.3.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.3.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- Embperl.pod.3.html	1998/10/08 20:58:01	1.3
  +++ Embperl.pod.3.html	1998/11/10 09:35:44	1.4
  @@ -21,15 +21,17 @@
   		<LI><A href="Embperl.pod.3.html#_Perl_code_">[+ Perl code +]</A>
   		<LI><A href="Embperl.pod.3.html#_Perl_code_">[- Perl code -]</A>
   		<LI><A href="Embperl.pod.3.html#_Perl_Code_">[! Perl Code !]</A>
  +		<LI><A href="Embperl.pod.3.html#_Perl_code_">[* Perl code *]</A>
  +		<LI><A href="Embperl.pod.3.html#_Some_Text_Comments_">[# Some Text #]  (Comments)</A>
   		<LI><A href="Embperl.pod.3.html#_Cmd_Arg_Meta_Commands_">[$ Cmd Arg $]  (Meta-Commands)</A>
   		<LI><A href="Embperl.pod.3.html#HTML_Tags">HTML Tags</A>
   	</UL>
   <hr>
   <P>
  -Embperl understands four categories of commands. The first three are
  -special Embperl commands, and the last category consists of some HTML tags
  -which can trigger special processing. Embperl commands can span multiple
  -lines and need not start or end at a line boundary.
  +Embperl understands four categories of commands. The first ones are special
  +Embperl commands, and the last category consists of some HTML tags which
  +can trigger special processing. Embperl commands can span multiple lines
  +and need not start or end at a line boundary.
   
   <P>
   Before the special Embperl commands are processed, and for the VALUE
  @@ -124,6 +126,93 @@
   Same as [- Perl Code -] with the exception that the code is only executed
   at the first request. This could be used to define subroutines, or do
   one-time initialization.
  +
  +<P>
  +<HR>
  +<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="_Perl_code_">[*
Perl code *]</A></H2>
  +<P>
  +(only version 1.2b2 or higher, experimental!!)
  +
  +<P>
  +This is similar to [- Perl Code -], the main difference is, while [- Perl
  +Code -], has always it's own scope, all [* Perl code *] blocks runs in the
  +same scope. This gives you the possibilty to define ``local'' variables
  +with a scope of the whole page. Normaly you don't need to use local,
  +because Embperl takes care of separate namespaces of different documents
  +and cleanup after the request is finished, but in special cases it's
  +necessary. For example if you want recursivly call an Embperl document via
  +Execute.
  +
  +<P>
  +There is a second reason to use the [* Perl code *] instead of the [- Perl
  +Code -]. If you like to use perl's control structures. Perl's if, while,
  +for etc. can <STRONG>not</STRONG> spawn mulitple [- Perl Code -] blocks, but
it can spawn multiple [* Perl
  +Code *]. 
  +
  +<P>
  +<PRE>  Example:
  +</PRE>
  +<P>
  +<PRE>  [* foreach $i (1..10) { *]
  +    
  +    [- $a = $i + 5 -]
  +    loop count + 5 = [+ $a +] &lt;br&gt;
  +</PRE>
  +<P>
  +<PRE>  [* } *]
  +</PRE>
  +<P>
  +<PRE>  The following B&lt;won't&gt; work:
  +</PRE>
  +<P>
  +<PRE>  [- foreach $i (1..10) { -]
  +    some text here &lt;br&gt;
  +  [- } -]
  +</PRE>
  +<P>
  +The same can be done with Embperl <A href="Embperl.pod.3.html#_Cmd_Arg_Meta_Commands_">meta
commands</A> (see below)
  +
  +<P>
  +<PRE>  [$ foreach $i (1..10) $]
  +    
  +    [- $a = $i + 5 -]
  +    loop count + 5 = [+ $a +] &lt;br&gt;
  +</PRE>
  +<P>
  +<PRE>  [$ endforeach $]
  +</PRE>
  +<P>
  +<STRONG>NOTE 1:</STRONG> [* ... *] blocks _must_ always end with a <STRONG>;</STRONG>,<STRONG>{</STRONG>
or <STRONG>}</STRONG>
  +
  +
  +
  +<P>
  +<STRONG>NOTE 2:</STRONG> [* ... *] cannot apear inside a html tag that is interpreted
by Embperl
  +(unless you disable the interpretation of such tags like table, input etc.)
  +
  +<P>
  +<STRONG>NOTE 3:</STRONG> Since the execution of [- ... -] and metacommands
is controlled by Embperl,
  +there is a much better debugging output in the logfile for this two ones.
  +Also no restriction where they can be used apply to meta-commands. You can
  +use them anywhere even inside of html tags that are interpreted by Embperl.
  +
  +<P>
  +<HR>
  +<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="_Some_Text_Comments_">[#
Some Text #]  (Comments)</A></H2>
  +<P>
  +(only version 1.2b2 or higher)
  +
  +<P>
  +This is a comment block. Everything between the [# and the #] will be
  +removed from the output.
  +
  +<P>
  +<STRONG>NOTE 1:</STRONG> The [* ... *] blocks are interpreted before the comment
block, so they are
  +executed also inside a comment. 
  +
  +<P>
  +<STRONG>NOTE 2:</STRONG> Everything (except [* ... +]) is really removed from
the source, so you can
  +also use the [# ... #] block to take a part out of your document.
   
   <P>
   <HR>
  
  
  
  1.5       +12 -0     modperl-site/embperl/Embperl.pod.5.html
  
  Index: Embperl.pod.5.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.5.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- Embperl.pod.5.html	1998/10/08 20:58:02	1.4
  +++ Embperl.pod.5.html	1998/11/10 09:35:44	1.5
  @@ -23,6 +23,7 @@
   		<LI><A href="Embperl.pod.5.html#_ffld">@ffld</A>
   		<LI><A href="Embperl.pod.5.html#_idat">%idat</A>
   		<LI><A href="Embperl.pod.5.html#_udat_only_1_2b1_or_higher_">%udat (only
1.2b1 or higher)</A>
  +		<LI><A href="Embperl.pod.5.html#_mdat_only_1_2b2_or_higher_">%mdat (only
1.2b2 or higher)</A>
   		<LI><A href="Embperl.pod.5.html#_row_col">$row, $col</A>
   		<LI><A href="Embperl.pod.5.html#_maxrow_maxcol">$maxrow, $maxcol</A>
   		<LI><A href="Embperl.pod.5.html#_cnt">$cnt</A>
  @@ -110,6 +111,17 @@
   user request an Embperl page, the browser sends the cookie with the session
   id back and Embperl fill the <CODE>%udat</CODE> hash from Apache::Session
   with just the same values as you have stored for that user. (See also <A href="Embperl.pod.6.html#Session_handling">Session
handling</A>)
  +
  +<P>
  +<HR>
  +<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="_mdat_only_1_2b2_or_higher_">%mdat
(only 1.2b2 or higher)</A></H2>
  +<P>
  +You can use <STRONG>%mdat</STRONG> to store per module/page data. As long as
you don't use %mdat, nothing
  +happens, but as soon as you write anything to %mdat, Embperl creates a
  +session id and stores the data via Apache::Session. The next time any user
  +hits the same Embperl page, Embperl fill the <CODE>%mdat</CODE> hash from
  +Apache::Session with just the same values as you have stored within the
  +last request to that page. (See also <A href="Embperl.pod.6.html#Session_handling">Session
handling</A>)
   
   <P>
   <HR>
  
  
  
  1.3       +27 -10    modperl-site/embperl/Embperl.pod.6.html
  
  Index: Embperl.pod.6.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.6.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Embperl.pod.6.html	1998/10/08 20:58:02	1.2
  +++ Embperl.pod.6.html	1998/11/10 09:35:45	1.3
  @@ -23,14 +23,19 @@
   the same values in that hash again.
   
   <P>
  +From 1.2b2 and higher Embperl is able to handle per module/page persitent
  +data for you. You can store any data in the <EM>%mdat</EM> hash and if any
request comes to the same Embperl document, you will see
  +the same values in that hash again.
  +
  +<P>
   To configure Embperl to do session management for you, you must have
   installed Apache::Session and loaded it before you load Embperl and you
   must tell Embperl which storage you would like to use for Apache::Session,
  -by setting the environement variable EMBPERL_SESSION_CLASS. You may have a
  -startup.pl for your httpd which looks like this:
  +by setting the environement variable EMBPERL_SESSION_CLASS. You may have a <STRONG>startup.pl</STRONG>
for your httpd which looks like this:
   
   <P>
  -<PRE> $ENV{EMBPERL_SESSION_CLASS}='File' ;
  +<PRE> $ENV{SESSION_FILE_DIRECTORY}='/tmp/sessions' ;
  + $ENV{EMBPERL_SESSION_CLASS}='File' ;
    use Apache::Session::File ;
    use HTML::Embperl ;
   </PRE>
  @@ -38,22 +43,34 @@
   <PRE> 1 ;
   </PRE>
   <P>
  +or put it in the httpd/srm.conf like this
  +
  +<P>
  +<PRE> PerlSetEnv SESSION_FILE_DIRECTORY /tmp/sessions
  + PerlSetEnv EMBPERL_SESSION_CLASS  File
  + PerlModule Apache::Session::File 
  + PerlModule HTML::Embperl ;
  +</PRE>
  +<P>
   NOTE: You can use all the environement variables recognized by
   Apache::Session to configure it.
   
   <P>
  -Now you are able to use the <CODE>%udat</CODE> hash for your user sessions.
  -As long as you don't touch <CODE>%udat</CODE> Embperl will not create any
  +Now you are able to use the <CODE>%udat</CODE> and <CODE>%mdat</CODE>
hashs
  +for your user/module sessions. As long as you don't touch
  +<CODE>%udat</CODE> or <CODE>%mdat</CODE> Embperl will not create
any
   session, also Apache::Session is loaded. As soon as you store any value to
   %udat, Embperl will create a new session and send a cookie to the browser
   to maintain it's id, while the data is stored by Apache::Session. (Further
  -version may also be able to use URL rewriting for storing the id).
  +version may also be able to use URL rewriting for storing the id). When you
  +store data to <CODE>%mdat</CODE> Embperl will store the data via
  +Apache::Session and retrieves it when the next request comes to the same
  +page.
   
   <P>
  -<STRONG>NOTE: In the current version (1.2b1) session handling is experimental and
not very well tested!
  -also it works only under mod_perl, CGI will come in one of the next releases</STRONG>
  -
  -
  +<STRONG>NOTE: In the current version (1.2b2) the per user session handling  works
only under mod_perl,
  +CGI will come in one of the next releases</STRONG>. The per module session handling
works in all operating modes.
  + 
   
   <p>[<a href="index.html">HOME</a>]&nbsp;&nbsp; [<a href="Embperl.pod.cont.html">CONTENT</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.5.html">PREV (Predefined variables)</a>]&nbsp;&nbsp;
[<a href="Embperl.pod.7.html">NEXT ((Safe-)Namespaces and opcode restrictions)</a>]&nbsp;&nbsp;
<br>
       <font color="#808080">___________________________________________________________________________________<br>
  
  
  
  1.7       +3 -0      modperl-site/embperl/Embperl.pod.cont.html
  
  Index: Embperl.pod.cont.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Embperl.pod.cont.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- Embperl.pod.cont.html	1998/10/08 20:58:03	1.6
  +++ Embperl.pod.cont.html	1998/11/10 09:35:45	1.7
  @@ -61,6 +61,8 @@
   		<LI><A href="Embperl.pod.3.html#_Perl_code_">[+ Perl code +]</A>
   		<LI><A href="Embperl.pod.3.html#_Perl_code_">[- Perl code -]</A>
   		<LI><A href="Embperl.pod.3.html#_Perl_Code_">[! Perl Code !]</A>
  +		<LI><A href="Embperl.pod.3.html#_Perl_code_">[* Perl code *]</A>
  +		<LI><A href="Embperl.pod.3.html#_Some_Text_Comments_">[# Some Text #]  (Comments)</A>
   		<LI><A href="Embperl.pod.3.html#_Cmd_Arg_Meta_Commands_">[$ Cmd Arg $]  (Meta-Commands)</A>
   		<LI><A href="Embperl.pod.3.html#HTML_Tags">HTML Tags</A>
   	</UL>
  @@ -74,6 +76,7 @@
   		<LI><A href="Embperl.pod.5.html#_ffld">@ffld</A>
   		<LI><A href="Embperl.pod.5.html#_idat">%idat</A>
   		<LI><A href="Embperl.pod.5.html#_udat_only_1_2b1_or_higher_">%udat (only
1.2b1 or higher)</A>
  +		<LI><A href="Embperl.pod.5.html#_mdat_only_1_2b2_or_higher_">%mdat (only
1.2b2 or higher)</A>
   		<LI><A href="Embperl.pod.5.html#_row_col">$row, $col</A>
   		<LI><A href="Embperl.pod.5.html#_maxrow_maxcol">$maxrow, $maxcol</A>
   		<LI><A href="Embperl.pod.5.html#_cnt">$cnt</A>
  
  
  
  1.3       +6 -0      modperl-site/embperl/Examples.html
  
  Index: Examples.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/Examples.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Examples.html	1998/08/31 10:06:19	1.2
  +++ Examples.html	1998/11/10 09:35:45	1.3
  @@ -32,6 +32,12 @@
   		<LI><A HREF="#Execute_pl">Execute.pl</A>
   	</UL>
   <hr>
  +
  +<bold>NOTE:</bold> All examples are just static pages, they just to
  +show how the output looks like. There currently no real working
  +examples here
  +<hr>
  +
   <P>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="if_htm">if.htm</A></H2>
   <P>
  
  
  
  1.5       +18 -1     modperl-site/embperl/INSTALL.pod.1.html
  
  Index: INSTALL.pod.1.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/INSTALL.pod.1.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- INSTALL.pod.1.html	1998/10/08 20:58:04	1.4
  +++ INSTALL.pod.1.html	1998/11/10 09:35:45	1.5
  @@ -59,11 +59,17 @@
   
   
   <P>
  -<STRONG>NOTE:</STRONG> (Embperl-1.2b1 or higher) For using session handling
you need
  +<STRONG>NOTE:</STRONG> (only Embperl-1.2b1 or higher) For using session handling
you need
   Apache::Session-0.16 or higher. For Apache-Session-0.16 to work, you must
   apply the session.patch from the Embperl distribution.
   
   <P>
  +<STRONG>NOTE:</STRONG> (only Embperl-1.2b1 or higher) If you plan to use nested
Embperl pages
  +(i.e. call <STRONG>Execute</STRONG>
  +inside a Embperl page, you should upgrade to perl 5.005 or higher due to
  +the better stack-memory-allocation.
  +
  +<P>
   <HR>
   <H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="WIN_32">WIN
32</A></H2>
   <P>
  @@ -120,6 +126,17 @@
   <STRONG>nmake install</STRONG>
   
   
  +
  +<P>
  +<STRONG>NOTE:</STRONG> (only Embperl-1.2b1 or higher) For using session handling
you need
  +Apache::Session-0.16 or higher. For Apache-Session-0.16 to work, you must
  +apply the session.patch from the Embperl distribution.
  +
  +<P>
  +<STRONG>NOTE:</STRONG> (only Embperl-1.2b1 or higher) If you plan to use nested
Embperl pages
  +(i.e. call <STRONG>Execute</STRONG>
  +inside a Embperl page, you should upgrade to perl 5.005 or higher due to
  +the better stack-memory-allocation.
   
   <P>
   <HR>
  
  
  
  1.8       +2 -2      modperl-site/embperl/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /export/home/cvs/modperl-site/embperl/index.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- index.html	1998/11/09 22:08:59	1.7
  +++ index.html	1998/11/10 09:35:45	1.8
  @@ -62,10 +62,10 @@
             <td bgcolor="#00ff00">&nbsp;Current Version </td>
           </tr>
           <tr>
  -          <td bgcolor="#00ff20">&nbsp;<code>Stable: 1.1.1</code></td>
  +          <td bgcolor="#00ff20">&nbsp;<a href="Embperl.pod.15.html"><code>Stable:
1.1.1</code></a></td>
           </tr>
           <tr>
  -          <td bgcolor="#00ff40">&nbsp;<code>Beta: &nbsp;&nbsp;1.2b1</code></td>
  +          <td bgcolor="#00ff40">&nbsp;<a href="Embperl.pod.15.html"><code>Beta:
&nbsp;&nbsp;1.2b2</code></a></td>
           </tr>
           <tr>
             <td bgcolor="#00ff60"><big>&nbsp;&nbsp;</big></td>
  
  
  

Mime
View raw message