You are viewing a plain text version of this content. The canonical link for it is here.
Posted to modperl-cvs@perl.apache.org by ri...@locus.apache.org on 2000/08/20 20:57:21 UTC
cvs commit: modperl-site/embperl Changes.pod.1.html Changes.pod.2.html Changes.pod.cont.html Embperl.pod.1.html Embperl.pod.3.html Embperl.pod.4.html Embperl.pod.6.html Embperl.pod.7.html INSTALL.pod.1.html
richter 00/08/20 11:57:21
Modified: embperl Changes.pod.1.html Changes.pod.2.html
Changes.pod.cont.html Embperl.pod.1.html
Embperl.pod.3.html Embperl.pod.4.html
Embperl.pod.6.html Embperl.pod.7.html
INSTALL.pod.1.html
Log:
Embperl Webpages - Changes
Revision Changes Path
1.167 +2 -10 modperl-site/embperl/Changes.pod.1.html
Index: Changes.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Changes.pod.1.html,v
retrieving revision 1.166
retrieving revision 1.167
diff -u -r1.166 -r1.167
--- Changes.pod.1.html 2000/08/20 17:50:34 1.166
+++ Changes.pod.1.html 2000/08/20 18:57:19 1.167
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
-<TITLE>1.3b5_dev -- That's what currently under developement</TITLE>
+<TITLE>1.3b5 /BETA) 20. Aug 2000</TITLE>
<LINK REV="made" HREF="mailto:root@venus.gr.ecos.de">
</HEAD>
@@ -8,7 +8,7 @@
<blockquote>
<blockquote>
<H1><strong>
-<A NAME="1_3b5_dev_That_s_what_current">1.3b5_dev -- That's what currently under developement</a></strong></h1>
+<A NAME="1_3b5_BETA_20_Aug_2000">1.3b5 /BETA) 20. Aug 2000</a></strong></h1>
</blockquote>
</blockquote>
@@ -17,14 +17,6 @@
<blockquote>
<blockquote>
[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.cont.html">PREV (Revision History - Content)</a>] [<a href="Changes.pod.2.html">NEXT (1.3b4 (BETA) 17.07.2000)</a>] <br><hr>
-<P>
-Last Update: Sun Aug 20 19:51:16 2000 (MET)
-
-<P>
-NOTE: This version is only available via <A HREF="CVS.pod.1.html#INTRO">"CVS"</A>
-
-
-
<P>
<PRE> - Embperl now supports Apache::Session 1.52. See "Session handling"
in the docs, how the setup has changed.
1.42 +2 -2 modperl-site/embperl/Changes.pod.2.html
Index: Changes.pod.2.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Changes.pod.2.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- Changes.pod.2.html 2000/08/10 19:33:21 1.41
+++ Changes.pod.2.html 2000/08/20 18:57:19 1.42
@@ -16,7 +16,7 @@
<BR CLEAR=LEFT>
<blockquote>
<blockquote>
-[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">PREV (1.3b5_dev -- That's what currently under developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b3 (BETA) 25.04.2000)</a>] <br><hr>
+[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">PREV (1.3b5 /BETA) 20. Aug 2000)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b3 (BETA) 25.04.2000)</a>] <br><hr>
<P>
<PRE> - New $escmode (or EMBPERL_ESCMODE) to disable the possiblilty
to turn off escaping with a leading backslash. Adding 4 to
@@ -68,7 +68,7 @@
<P>
<PRE>
</PRE>
-<p>[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">PREV (1.3b5_dev -- That's what currently under developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b3 (BETA) 25.04.2000)</a>] <br>
+<p>[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">PREV (1.3b5 /BETA) 20. Aug 2000)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b3 (BETA) 25.04.2000)</a>] <br>
<font color="#808080">___________________________________________________________________________________<br>
HTML::Embperl - Copyright (c) 1997-2000 Gerald Richter / <a href="http://www.ecos.de/">ecos gmbh</a>
</font></p>
1.42 +3 -3 modperl-site/embperl/Changes.pod.cont.html
Index: Changes.pod.cont.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Changes.pod.cont.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- Changes.pod.cont.html 2000/08/10 19:33:30 1.41
+++ Changes.pod.cont.html 2000/08/20 18:57:19 1.42
@@ -16,7 +16,7 @@
<BR CLEAR=LEFT>
<blockquote>
<blockquote>
-[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">NEXT (1.3b5_dev -- That's what currently under developement)</a>] <br><HTML>
+[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">NEXT (1.3b5 /BETA) 20. Aug 2000)</a>] <br><HTML>
<HEAD>
<TITLE>Revision History - Content</TITLE>
<LINK REV="made" HREF="mailto:root@venus.gr.ecos.de">
@@ -28,7 +28,7 @@
<UL>
- <LI><A href="Changes.pod.1.html#1_3b5_dev_That_s_what_current">1.3b5_dev - That's what currently under developement</A>
+ <LI><A href="Changes.pod.1.html#1_3b5_BETA_20_Aug_2000">1.3b5 /BETA) 20. Aug 2000</A>
<LI><A href="Changes.pod.2.html#1_3b4_BETA_17_07_2000">1.3b4 (BETA) 17.07.2000</A>
<LI><A href="Changes.pod.3.html#1_3b3_BETA_25_04_2000">1.3b3 (BETA) 25.04.2000</A>
<LI><A href="Changes.pod.4.html#1_3b2_BETA_11_Feb_2000">1.3b2 (BETA) 11. Feb 2000</A>
@@ -72,7 +72,7 @@
<LI><A href="Changes.pod.42.html#0_10beta_Jan_18_1997">0.10beta Jan 18 1997</A>
</UL>
<!-- INDEX END -->
-<hr><p>[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">NEXT (1.3b5_dev -- That's what currently under developement)</a>] <br>
+<hr><p>[<a href="index.html">HOME</a>] [<a href="Changes.pod.cont.html">CONTENT</a>] [<a href="Changes.pod.1.html">NEXT (1.3b5 /BETA) 20. Aug 2000)</a>] <br>
<font color="#808080">___________________________________________________________________________________<br>
HTML::Embperl - Copyright (c) 1997-2000 Gerald Richter / <a href="http://www.ecos.de/">ecos gmbh</a>
</font></p>
1.17 +9 -0 modperl-site/embperl/Embperl.pod.1.html
Index: Embperl.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.1.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Embperl.pod.1.html 2000/04/14 12:28:23 1.16
+++ Embperl.pod.1.html 2000/08/20 18:57:19 1.17
@@ -17,6 +17,15 @@
<blockquote>
<blockquote>
[<a href="index.html">HOME</a>] [<a href="Embperl.pod.cont.html">CONTENT</a>] [<a href="Embperl.pod.cont.html">PREV (Documentation - Content)</a>] [<a href="Embperl.pod.2.html">NEXT (Operating-Modes)</a>] <br><hr>
+<P>
+Embperl is a Perl extension module which gives you the power to embed Perl
+code directly in your HTML documents (like server-side includes for shell
+commands).
+
+<P>
+If build more than a single page you may also want to take a look at <A HREF="EmbperlObject.pod.cont.html">"perldoc EmbperlObject"</A> which gives you the possibility to build your website out of small objects.
+Addionaly <A HREF="Mail.pod.cont.html">"perldoc HTML::Embperl::Mail"</A> allows you to send resulting page via email.
+
<p>[<a href="index.html">HOME</a>] [<a href="Embperl.pod.cont.html">CONTENT</a>] [<a href="Embperl.pod.cont.html">PREV (Documentation - Content)</a>] [<a href="Embperl.pod.2.html">NEXT (Operating-Modes)</a>] <br>
<font color="#808080">___________________________________________________________________________________<br>
HTML::Embperl - Copyright (c) 1997-2000 Gerald Richter / <a href="http://www.ecos.de/">ecos gmbh</a>
1.17 +4 -3 modperl-site/embperl/Embperl.pod.3.html
Index: Embperl.pod.3.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.3.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Embperl.pod.3.html 2000/07/17 05:16:58 1.16
+++ Embperl.pod.3.html 2000/08/20 18:57:19 1.17
@@ -640,14 +640,15 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_COOKIE_EXPIRES">EMBPERL_COOKIE_EXPIRES</A></H2>
<P>
(only 1.2b4 or above) Set the expiration date that Embperl uses for the
-cookie with the session id. Default is none.
+cookie with the session id. You can specify the full date or relativ values
+(1.3b5 or higher). Examples: +30s +10m +1h -1d +3M +10y Default is none.
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="EMBPERL_SESSION_CLASSES">EMBPERL_SESSION_CLASSES</A></H2>
<P>
-Space separted list of object store and lock manager for Apache::Session
-(see <A href="Embperl.pod.7.html#Session_handling">Session handling</A>)
+Space separted list of object store and lock manager (and optional the
+serialsation and id generating class) for Apache::Session (see <A href="Embperl.pod.7.html#Session_handling">Session handling</A>)
<P>
<HR>
1.10 +5 -5 modperl-site/embperl/Embperl.pod.4.html
Index: Embperl.pod.4.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.4.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.4.html 2000/04/14 12:28:24 1.9
+++ Embperl.pod.4.html 2000/08/20 18:57:19 1.10
@@ -563,24 +563,24 @@
<P>
The output of perl blocks inside the <CODE>HREF</CODE> attribute of the <A href="Embperl.pod.4.html#item_A">A</A> Tags and the
<CODE>SRC</CODE> attribute of the other Tags are URL escaped instead of HTML escaped. (see
-also <EM>$escmode</EM>). Also when inside such a URL, <EM>Embperl</EM> expands array refernces to URL paramter syntax. Example:
+also <EM>$escmode</EM>). Also when inside such a URL, <EM>Embperl</EM> expands array and hash refernces to URL paramter syntax. Example:
<P>
<PRE> [-
- %A = (A => 1, B => 2) ;
+ $A = { A => 1, B => 2 } ; # Hashreference
@A = (X, 9, Y, 8, Z, 7)
-]
</PRE>
<P>
-<PRE> <A HREF="<A HREF="http://localhost/tests">http://localhost/tests</A>?[+ [ %A ] +]">
+<PRE> <A HREF="<A HREF="http://localhost/tests">http://localhost/tests</A>?[+ $A +]">
<A HREF="<A HREF="http://localhost/tests">http://localhost/tests</A>?[+ \@A +]">
</PRE>
<P>
is expanded by <EM>Embperl</EM> to
<P>
-<PRE> <A HREF="<A HREF="http://localhost/tests?A=1&">http://localhost/tests?A=1&</A>;B=2">
- <A HREF="<A HREF="http://localhost/tests?X=9&">http://localhost/tests?X=9&</A>;Y=8&Z=7">
+<PRE> <A HREF="<A HREF="http://localhost/tests?A=1&">http://localhost/tests?A=1&</A>;amp;B=2">
+ <A HREF="<A HREF="http://localhost/tests?X=9&">http://localhost/tests?X=9&</A>;amp;Y=8&Z=7">
</PRE>
</DL>
<p>[<a href="index.html">HOME</a>] [<a href="Embperl.pod.cont.html">CONTENT</a>] [<a href="Embperl.pod.3.html">PREV (Runtime configuration)</a>] [<a href="Embperl.pod.5.html">NEXT (Variable scope and cleanup)</a>] <br>
1.16 +5 -0 modperl-site/embperl/Embperl.pod.6.html
Index: Embperl.pod.6.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.6.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- Embperl.pod.6.html 2000/05/02 06:12:56 1.15
+++ Embperl.pod.6.html 2000/08/20 18:57:19 1.16
@@ -116,6 +116,11 @@
<STRONG>NOTE:</STRONG> The way <STRONG>uploadInfos</STRONG> are accessed before 1.2b11 are not supported anymore.
<P>
+<STRONG>NOTE:</STRONG> This works the other way as well: any input fields with names that are
+<CODE>%fdat</CODE> keys, and without values, will have their values
+automatically set to the appropriate <CODE>%fdat</CODE> value. See <A href="Embperl.pod.4.html#HTML_Tags">HTML Tags</A> <CODE>INPUT/OPTION/TEXTAREA</CODE>.
+
+<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="_ffld">@ffld</A></H2>
<P>
1.10 +26 -14 modperl-site/embperl/Embperl.pod.7.html
Index: Embperl.pod.7.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.7.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.7.html 2000/04/14 12:28:24 1.9
+++ Embperl.pod.7.html 2000/08/20 18:57:19 1.10
@@ -31,12 +31,14 @@
To configure <EM>Embperl</EM> to do session management for you, you must have installed <EM>Apache::Session</EM> (<STRONG>1.00 or higher</STRONG>) and tell Embperl which storage and locker classes you would like to use
for
<EM>Apache::Session</EM>. This is done by setting the environement variable
-<CODE>EMBPERL_SESSION_CLASSES</CODE>. You may have a <STRONG>startup.pl</STRONG> for your httpd which looks like this:
+<CODE>EMBPERL_SESSION_CLASSES</CODE>. If you want to use a MySQL database for storing your sessions, you may
+have a
+<STRONG>startup.pl</STRONG> for your httpd which looks like this:
<P>
<PRE> BEGIN
{
- $ENV{EMBPERL_SESSION_CLASSES} = "DBIStore SysVSemaphoreLocker" ;
+ $ENV{EMBPERL_SESSION_CLASSES} = "MySQL Semaphore" ;
$ENV{EMBPERL_SESSION_ARGS} = "DataSource=dbi:mysql:session UserName=test" ;
} ;
</PRE>
@@ -44,28 +46,38 @@
<PRE> use HTML::Embperl ;
</PRE>
<P>
-For <STRONG>Solaris</STRONG> it's neccessary to set the <CODE>nsems</CODE> Argument if you use SysVSemaphoreLocker
+or you may put this in the httpd/srm.conf:
<P>
-<PRE> $Apache::Session::SysVSemaphoreLocker::nsems = 16;
-</PRE>
-<P>
-You may also put this in the httpd/srm.conf:
-
-<P>
-<PRE> PerlSetEnv EMBPERL_SESSION_CLASSES "DBIStore SysVSemaphoreLocker"
+<PRE> PerlSetEnv EMBPERL_SESSION_CLASSES "MySQL Semaphore"
PerlSetEnv EMBPERL_SESSION_ARGS "DataSource=dbi:mysql:session UserName=test"
PerlModule HTML::Embperl ;
</PRE>
<P>
+Refer to the <EM>Apache::Session</EM> docs (e.g. <EM>Apache::Session::Store::MySQL</EM>) how to setup your database tables.
+
+<P>
<CODE>EMBPERL_SESSION_ARGS</CODE> is a space separated list of name/value pairs, which gives additional
arguments for Apache::Session classes.
+<P>
+Here is an example for using a filesystem based storage:
+
+<P>
+PerlSetEnv EMBPERL_SESSION_CLASSES ``File Semaphore'' PerlSetEnv
+EMBPERL_SESSION_ARGS ``Directory=/path/to/your/sessions''
+
+<P>
+Refer to the <EM>Apache::Session</EM> docs which other storage/locker are available.
+
+<P>
+Additionaly <CODE>EMBPERL_SESSION_CLASSES</CODE> can (optionaly) take two further classnames, which specifies the the class
+for serialization (Default: <CODE>Storable</CODE>) and for generating the id (Default: <CODE>MD5</CODE>).
+
<P>
-<STRONG>NOTE:</STRONG> The above configuration works only with <EM>Embperl</EM> 1.2b11 or above. The way
-<EM>Apache::Session</EM> was used in earlier versions still works, but I have removed the
-documentation to avoid confusion. Changes are, that you don't need to load
-<EM>Apache::Session</EM> anymore on your own and that <EM>Apache::Session 1.00</EM> takes totaly different arguments then <EM>Apache::Session 0.17</EM>.
+<STRONG>NOTE:</STRONG> The above configuration works only with <EM>Apache::Session</EM> 1.52 and <EM>Embperl</EM> 1.3b5 or above. Older versions of Embperl only supports <EM>Apache::Session</EM> 1.0x, which has different parameters for <CODE>EMBPERL_SESSION_CLASSES</CODE>
+(e.g. <CODE>$ENV{EMBPERL_SESSION_CLASSES} = "DBIStore SysVSemaphoreLocker" ; </CODE>)
+<EM>Apache::Session</EM> 1.0x still works with this Embperl version.
<P>
Now you are able to use the <CODE>%udat</CODE> and <CODE>%mdat</CODE> hashs
1.14 +4 -4 modperl-site/embperl/INSTALL.pod.1.html
Index: INSTALL.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/INSTALL.pod.1.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- INSTALL.pod.1.html 2000/07/17 05:16:59 1.13
+++ INSTALL.pod.1.html 2000/08/20 18:57:20 1.14
@@ -61,8 +61,8 @@
<P>
<STRONG>NOTE 1:</STRONG> (only Embperl-1.2b1 or higher) For using session handling you need
-Apache::Session-0.17 or higher. If possible use Apache::Session 1.00.
-Currently Apache::Session 1.50 or higher is <STRONG>not</STRONG> supported. (Coming soon)
+Apache::Session-0.17 or higher. If possible use Apache::Session 1.52 or
+higher.
<P>
<STRONG>NOTE 2:</STRONG> <EM>Embperl</EM> runs without additional Perl modules, but the <CODE>make test</CODE>
@@ -146,8 +146,8 @@
<P>
<STRONG>NOTE 1:</STRONG> (only Embperl-1.2b1 or higher) For using session handling you need
-Apache::Session-0.17 or higher. If possible use Apache::Session 1.00.
-Currently Apache::Session 1.50 or higher is <STRONG>not</STRONG> supported. (Coming soon)
+Apache::Session-0.17 or higher. If possible use Apache::Session 1.52 or
+higher.
<P>
<STRONG>NOTE 2:</STRONG> <EM>Embperl</EM> runs without additional Perl modules, but the <CODE>make test</CODE>