[prev in list] [next in list] [prev in thread] [next in thread]
List: apache-modperl-cvs
Subject: cvs commit: modperl-site/embperl Changes.pod.1.html Changes.pod.2.html Changes.pod.cont.html Embperl
From: richter () locus ! apache ! org
Date: 2000-11-07 19:34:00
[Download RAW message or body]
richter 00/11/07 11:34:00
Modified: embperl Changes.pod.1.html Changes.pod.2.html
Changes.pod.cont.html Embperl.pod.1.html
Embperl.pod.10.html Embperl.pod.11.html
Embperl.pod.12.html Embperl.pod.14.html
Embperl.pod.16.html Embperl.pod.17.html
Embperl.pod.2.html Embperl.pod.3.html
Embperl.pod.4.html Embperl.pod.5.html
Embperl.pod.6.html Embperl.pod.7.html
Embperl.pod.8.html Embperl.pod.9.html
Embperl.pod.cont.html
Log:
Embperl Webpages - Changes
Revision Changes Path
1.181 +6 -3 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.180
retrieving revision 1.181
diff -u -r1.180 -r1.181
--- Changes.pod.1.html 2000/11/07 11:29:34 1.180
+++ Changes.pod.1.html 2000/11/07 19:33:54 1.181
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
-<TITLE>1.2b7_dev -- That's what currently under developement</TITLE>
+<TITLE>1.3b7_dev -- That's what currently under developement</TITLE>
<LINK REV="made" HREF="mailto:root@venus.gr.ecos.de">
</HEAD>
@@ -11,7 +11,7 @@
<tr>
<td valign=bottom align=center>
<font size=6><strong>
-<A NAME="1_2b7_dev_That_s_what_current">1.2b7_dev -- That's what currently under \
developement</a></strong></font> +<A NAME="1_3b7_dev_That_s_what_current">1.3b7_dev \
-- That's what currently under developement</a></strong></font>
</td><td rowspan=2 align=right></td>
</tr><tr><td valign=top align=center>
@@ -21,7 +21,7 @@
[<a href="" >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.3b6 (BETA) 18. Oct 2000)</a>] <br><hr> \
<P>
-Last Update: Tue Nov 7 12:26:45 2000 (MET)
+Last Update: Tue Nov 7 20:31:16 2000 (MET)
<P>
NOTE: This version is only available via <A HREF="CVS.pod.1.html#INTRO" >"CVS"</A>
@@ -41,6 +41,9 @@
- Fixed problem when use multiple nested ../foo.htm inside EmbperlObject.
Spotted by Neil Gunton.
- Included patch from Angus Lees to ease building on debian.
+ - make test now works again with BEN-SSL httpsd. With help from Neil Gunton.
+ - Included grammaticaly updated Embperl.pod. Many thanks to Ilia Lobsanov
+ for doing the proof reading.
</PRE>
<p>[<a href="" >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.3b6 (BETA) 18. Oct \
2000)</a>] <br>
<font color="#808080">___________________________________________________________________________________<br>
1.49 +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.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- Changes.pod.2.html 2000/11/07 11:29:36 1.48
+++ Changes.pod.2.html 2000/11/07 19:33:54 1.49
@@ -19,7 +19,7 @@
<img src="line.jpg" alt="________" WIDTH="732" HEIGHT="35" >
</td></tr></table>
-[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">PREV (1.2b7_dev -- That's what currently under \
developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b5 (BETA) 20. \
Aug 2000)</a>] <br><hr> +[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">PREV (1.3b7_dev -- That's what currently under \
developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b5 (BETA) 20. \
Aug 2000)</a>] <br><hr> <P>
<PRE> - Embperl now runs on ActiveState Perl. (At least in offline mode,
mod_perl mode seems to still have some problems). With a lot of help
@@ -57,7 +57,7 @@
- Embperl now cache same files with relative path, which are located
in different directories correctly.
</PRE>
-<p>[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">PREV (1.2b7_dev -- That's what currently under \
developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b5 (BETA) 20. \
Aug 2000)</a>] <br> +<p>[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">PREV (1.3b7_dev -- That's what currently under \
developement)</a>] [<a href="Changes.pod.3.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.49 +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.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- Changes.pod.cont.html 2000/11/07 11:29:39 1.48
+++ Changes.pod.cont.html 2000/11/07 19:33:54 1.49
@@ -19,7 +19,7 @@
<img src="line.jpg" alt="________" WIDTH="732" HEIGHT="35" >
</td></tr></table>
-[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">NEXT (1.2b7_dev -- That's what currently under \
developement)</a>] <br><HTML> +[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">NEXT (1.3b7_dev -- That's what currently under \
developement)</a>] <br><HTML> <HEAD>
<TITLE>Revision History - Content</TITLE>
<LINK REV="made" HREF="mailto:root@venus.gr.ecos.de">
@@ -31,7 +31,7 @@
<UL>
- <LI><A href="Changes.pod.1.html#1_2b7_dev_That_s_what_current">1.2b7_dev - That's \
what currently under developement</A> + <LI><A \
href="Changes.pod.1.html#1_3b7_dev_That_s_what_current">1.3b7_dev - That's what \
currently under developement</A> <LI><A \
href="Changes.pod.2.html#1_3b6_BETA_18_Oct_2000">1.3b6 (BETA) 18. Oct 2000</A> \
<LI><A href="Changes.pod.3.html#1_3b5_BETA_20_Aug_2000">1.3b5 (BETA) 20. Aug \
2000</A> <LI><A href="Changes.pod.4.html#1_3b4_BETA_17_07_2000">1.3b4 (BETA) \
17.07.2000</A> @@ -77,7 +77,7 @@
<LI><A href="Changes.pod.44.html#0_10beta_Jan_18_1997">0.10beta Jan 18 1997</A>
</UL>
<!-- INDEX END -->
-<hr><p>[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">NEXT (1.2b7_dev -- That's what currently under \
developement)</a>] <br> +<hr><p>[<a href="" >HOME</a>] [<a \
href="Changes.pod.cont.html">CONTENT</a>] [<a \
href="Changes.pod.1.html">NEXT (1.3b7_dev -- That's what currently under \
developement)</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.19 +1 -2 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.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- Embperl.pod.1.html 2000/08/25 05:31:51 1.18
+++ Embperl.pod.1.html 2000/11/07 19:33:54 1.19
@@ -26,8 +26,7 @@
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. +If building more than a single page, you may \
also want to take a look at <A HREF="EmbperlObject.pod.cont.html" >"perldoc \
EmbperlObject"</A> which lets you build your website out of small objects. \
Additionally, <A HREF="Mail.pod.cont.html" >"perldoc HTML::Embperl::Mail"</A> allows \
you to send the resulting page via email.
<p>[<a href="" >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>
1.11 +2 -2 modperl-site/embperl/Embperl.pod.10.html
Index: Embperl.pod.10.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.10.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Embperl.pod.10.html 2000/08/25 05:31:51 1.10
+++ Embperl.pod.10.html 2000/11/07 19:33:54 1.11
@@ -72,7 +72,7 @@
via the URI /embperl. Every request to /embperl/foo.html will do a
proxy-request to /src/foo.html. The file /src/foo.html will be processed by
mod_include and then sent to Embperl, where it can be processed by Embperl
-before being sent to the browser. It would be also possible to use two
+before being sent to the browser. It would also be possible to use two
httpd's on different ports. In this configuration, the source and the URI
location could be the same.
@@ -92,7 +92,7 @@
</PRE>
<P>
LogOutput is a custom output function. It sends the output to the browser \
<STRONG>and</STRONG>
-writes the output to a unique file. The filename has the the form
+writes the output to a unique file. The filename has the form
``$basepath.$$.$LogOutputFileno''.
<p>[<a href="" >HOME</a>] [<a \
href="Embperl.pod.cont.html">CONTENT</a>] [<a \
href="Embperl.pod.9.html">PREV (Utility Functions)</a>] [<a \
href="Embperl.pod.11.html">NEXT (Inside Embperl - How the embedded Perl code is \
actually processed)</a>] <br>
1.10 +5 -5 modperl-site/embperl/Embperl.pod.11.html
Index: Embperl.pod.11.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.11.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.11.html 2000/08/25 05:31:51 1.9
+++ Embperl.pod.11.html 2000/11/07 19:33:54 1.10
@@ -256,7 +256,7 @@
<PRE> <A HREF="<A \
HREF="http://host/script?name=">http://host/script?name=</A>[+$n+]"> </PRE>
<P>
-When <CODE>$n</CODE> is ``My name'' the requested URL, when you click on
+When <CODE>$n</CODE> is ``My name'', the requested URL, when you click on
the hyperlink, will be
<P>
@@ -289,7 +289,7 @@
<P>
<PRE> NOTE: You cannot set $escmode more than once inside a [+ ... +] block.
Embperl uses the first setting of $escmode it encounters inside the block.
- If you need to change $escmode more than once, you must use muliple
+ If you need to change $escmode more than once, you must use multiple
[+ ... +] blocks.
</PRE>
@@ -300,9 +300,9 @@
<P>
Now everything is done and the output can be sent to the browser. If you
haven't set dbgEarlyHttpHeaders, the output is buffered until the
-successful completion of document execution of the document, and is sent to
-the browser along with the HTTP headers. If an error occurs, an error
-document is sent instead.
+successful completion of document execution, and is sent to the browser
+along with the HTTP headers. If an error occurs, an error document is sent
+instead.
<P>
The content length and every <META HTTP-EQUIV=...> is added to the
1.10 +2 -2 modperl-site/embperl/Embperl.pod.12.html
Index: Embperl.pod.12.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.12.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.12.html 2000/08/25 05:31:51 1.9
+++ Embperl.pod.12.html 2000/11/07 19:33:54 1.10
@@ -27,8 +27,8 @@
should <STRONG>never</STRONG> enable <STRONG>dbgFlushOutput</STRONG>, \
<STRONG>dbgFlushLog</STRONG> or <STRONG>dbgCacheDisable</STRONG> in a production \
environment. More debugging options are useful for development where it doesn't \
matter if the request takes a little bit
-longer, but on a heavily-loaded server they should be disabled. Addtionaly
-the options <EM>optDisableChdir</EM>, <EM>optDisableHtmlScan</EM>,
+longer, but on a heavily-loaded server they should be disabled.
+Additionally the options <EM>optDisableChdir</EM>, <EM>optDisableHtmlScan</EM>,
<EM>optDisableCleanup</EM> have consequences for the performance.
<P>
1.15 +1 -1 modperl-site/embperl/Embperl.pod.14.html
Index: Embperl.pod.14.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.14.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- Embperl.pod.14.html 2000/08/25 05:31:52 1.14
+++ Embperl.pod.14.html 2000/11/07 19:33:54 1.15
@@ -27,7 +27,7 @@
</UL>
<hr>
<P>
-I have tested Embperl succesfully
+I have tested Embperl successfully
<P>
<HR>
1.10 +1 -1 modperl-site/embperl/Embperl.pod.16.html
Index: Embperl.pod.16.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.16.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.16.html 2000/08/25 05:31:52 1.9
+++ Embperl.pod.16.html 2000/11/07 19:33:54 1.10
@@ -63,7 +63,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="CVS">CVS</A></H2>
<P>
-The lastest developements are available from a CVS. Look at <A \
HREF="CVS.pod.1.html#INTRO" >"perldoc CVS.pod"</A> for a detailed description. +The \
latest developments are available via CVS. Look at <A HREF="CVS.pod.1.html#INTRO" \
>"perldoc CVS.pod"</A> for a detailed description.
<p>[<a href="" >HOME</a>] [<a \
href="Embperl.pod.cont.html">CONTENT</a>] [<a \
href="Embperl.pod.15.html">PREV (Support)</a>] [<a \
href="Embperl.pod.17.html">NEXT (Syntaxmodes for various editors)</a>] \
<br>
<font color="#808080">___________________________________________________________________________________<br>
1.5 +3 -3 modperl-site/embperl/Embperl.pod.17.html
Index: Embperl.pod.17.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.17.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Embperl.pod.17.html 2000/10/18 07:34:04 1.4
+++ Embperl.pod.17.html 2000/11/07 19:33:54 1.5
@@ -51,12 +51,12 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="VIM">VIM</A></H2>
<P>
-Vim Syntaxfile from Steve Willer could be found at <A
+Vim Syntaxfile from Steve Willer can be found at <A
HREF="http://www.interlog.com/~willer/embperl.vim">http://www.interlog.com/~willer/embperl.vim</A>
<P>
-Vim Syntaxfile from Kee Hinckley could be found at <A
+Vim Syntaxfile from Kee Hinckley can be found at <A
HREF="http://www.somewhere.com/software/">http://www.somewhere.com/software/</A>
@@ -64,7 +64,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="Dreamweaver">Dreamweaver</A></H2> <P>
-Dreamweaverextention which tell Dreamweaver not to touch Embperl code could
+Dreamweaver extension which tells Dreamweaver not to touch Embperl code can
be found at <A
HREF="http://www.somewhere.com/software/">http://www.somewhere.com/software/</A>
1.23 +22 -22 modperl-site/embperl/Embperl.pod.2.html
Index: Embperl.pod.2.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.2.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- Embperl.pod.2.html 2000/10/18 07:34:04 1.22
+++ Embperl.pod.2.html 2000/11/07 19:33:54 1.23
@@ -120,7 +120,7 @@
<P>
If you are running the Apache httpd, you can also define
-<STRONG>embpcgi.pl</STRONG> as a handler for a specific file extention or \
directory. +<STRONG>embpcgi.pl</STRONG> as a handler for a specific file extension \
or directory.
<P>
Example of Apache <CODE>srm.conf</CODE>:
@@ -131,12 +131,12 @@
</Directory>
</PRE>
<P>
-<STRONG>NOTE 1</STRONG>: Out of security reasons, embpexec.pl must not be used \
anymore as CGI
-script!
+<STRONG>NOTE 1</STRONG>: For security reasons, embpexec.pl must not be used as a \
CGI script +anymore!
<P>
<STRONG>NOTE 2</STRONG>: CGI Scripts are not so secure. You should consider using \
<EM>EMBPERL_ALLOW</EM>
-to restrict the access to the rights documents.
+to restrict access.
<P>
<HR>
@@ -192,7 +192,7 @@
<STRONG>must not</STRONG> load Embperl at server startup time!
<P>
-<STRONG>See also</STRONG>: <A HREF="EmbperlObject.pod.cont.html" >"perldoc \
EmbperlObject"</A> to see how to setup <EM>Embperl</EM> in a way to create your site \
out of small overwriteable objects. +<STRONG>See also</STRONG>: <A \
HREF="EmbperlObject.pod.cont.html" >"perldoc EmbperlObject"</A> to see how to setup \
<EM>Embperl</EM> so as to create your site out of small overwriteable objects.
<P>
<HR>
@@ -201,11 +201,11 @@
Execute can be used to call Embperl from your own modules/scripts (for
example from a Apache::Registry or CGI script) or from within another
Embperl page (only 1.2b1 or higher) to nest multiple Embperl pages (for
-example to store a common header or footer in an different file).
+example to store a common header or footer in a different file).
<P>
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
+only takes a 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.
@@ -213,7 +213,7 @@
(See <STRONG>eg/x/Excute.pl</STRONG> for more detailed examples)
<P>
-<STRONG>See also</STRONG>: <A HREF="EmbperlObject.pod.cont.html" >"perldoc \
EmbperlObject"</A> to see how to setup <EM>Embperl</EM> in a way to create your site \
out of small overwriteable objects and <A HREF="Mail.pod.cont.html" >"perldoc \
HTML::Embperl::Mail"</A> how to use <EM>Embperl</EM> to send email. +<STRONG>See \
also</STRONG>: <A HREF="EmbperlObject.pod.cont.html" >"perldoc EmbperlObject"</A> to \
see how to setup <EM>Embperl</EM> so as to create your site out of small \
overwriteable objects and <A HREF="Mail.pod.cont.html" >"perldoc \
HTML::Embperl::Mail"</A> on how to use <EM>Embperl</EM> to send email.
<P>
<PRE> Execute($filename, $p1, $p2, $pn) ;
@@ -265,18 +265,18 @@
<DT><STRONG><A NAME="import">import</A></STRONG><DD>
<P>
-A value of zero tell's Embperl not to execute the page, but define all
+A value of zero tells Embperl not to execute the page, but define all
subrountines found inside. This is neccessary before calling them with
Execute by the <STRONG>sub</STRONG>
-parameter or for an later import.
+parameter or for a later import.
<P>
-A value of one tell's Embperl to define to subrountines inside the file (if
+A value of one tells Embperl to define the subrountines inside the file (if
not already done) and to import them as perl subroutines into the current
namespace.
<P>
-See <STRONG>[$ sub $]</STRONG> metacommand and section about subroutines for more \
infos. +See <STRONG>[$ sub $]</STRONG> metacommand and section about subroutines for \
more info.
<DT><STRONG><A NAME="req_rec">req_rec</A></STRONG><DD>
<P>
@@ -378,16 +378,16 @@
<DT><STRONG><A NAME="input_func">input_func</A></STRONG><DD>
<P>
-Same as <A href="Embperl.pod.3.html#EMBPERL_INPUT_FUNC">EMBPERL_INPUT_FUNC</A> \
(see below). Additionaly you can specify an code reference to an perl
-function, which is used as input function or an array reference, where the
-first element contains the code reference and further elements contains
+Same as <A href="Embperl.pod.3.html#EMBPERL_INPUT_FUNC">EMBPERL_INPUT_FUNC</A> \
(see below). Additionaly you can specify a code reference to a perl +subroutine, \
which is used as input function; or an array reference, where +the first element \
contains the code reference and further elements contain additional arguments passed \
to the function.
<DT><STRONG><A NAME="output_func">output_func</A></STRONG><DD>
<P>
-Same as <A href="Embperl.pod.3.html#EMBPERL_OUTPUT_FUNC">EMBPERL_OUTPUT_FUNC</A> \
(see below). Additionaly you can specify an code reference to an perl
-function, which is used as output function or an array reference, where the
-first element contains the code reference and further elements contains
+Same as <A href="Embperl.pod.3.html#EMBPERL_OUTPUT_FUNC">EMBPERL_OUTPUT_FUNC</A> \
(see below). Additionaly you can specify a code reference to a perl +subroutine, \
which is used as output function; or an array reference, where +the first element \
contains the code reference and further elements contain additional arguments passed \
to the function.
<DT><STRONG><A NAME="cookie_name">cookie_name</A></STRONG><DD>
@@ -408,8 +408,8 @@
<DT><STRONG><A NAME="errors">errors</A></STRONG><DD>
<P>
-Takes a reference to an array. Upon return the array will contain a copy of
-all errormessages, as long as there are any.
+Takes a reference to an array. Upon return, the array will contain a copy
+of all errormessages, if any.
</DL>
<P>
@@ -418,7 +418,7 @@
<DL>
<DT><STRONG><A NAME="HTML">HTML::Embperl::Init ($Logfile, \
$DebugDefault)</A></STRONG><DD> <P>
-This function can be used to setup the logfile path and (optional) a
+This function can be used to setup the logfile path and (optionally) a
default value for the debugflags, which will be used in further calls to
Execute. There will always be only one logfile, but you can use \
<STRONG>Init</STRONG> to change it at any time.
@@ -429,7 +429,7 @@
<DT><STRONG><A NAME="HTML">HTML::Embperl::ScanEnvironment \
(\%params)</A></STRONG><DD> <P>
-Scans the <STRONG>%ENV</STRONG> and setups <STRONG>%params</STRONG> for use by \
<STRONG>Execute</STRONG>. All Embperl runtime configuration options are recognized, \
except +Scans <STRONG>%ENV</STRONG>, setting up <STRONG>%params</STRONG> for use by \
<STRONG>Execute</STRONG>. All Embperl runtime configuration options are recognized, \
except EMBPERL_LOG.
</DL>
1.21 +43 -43 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.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- Embperl.pod.3.html 2000/10/18 07:34:04 1.20
+++ Embperl.pod.3.html 2000/11/07 19:33:55 1.21
@@ -50,7 +50,7 @@
<P>
The runtime configuration is done by setting environment variables, either
on the command line (when working offline) or in your web server's
-configuration file. Most HTTP servers understand
+configuration file. Most HTTP servers understand:
<P>
SetEnv <var> <value>
@@ -71,7 +71,7 @@
<P>
If specified, only files which match the given <STRONG>perl regular \
expression</STRONG> will be processed by Embperl, all other files will be handled by \
the standard Apache handler. This can be useful if you have Embperl documents
-and non Embperl documents (e.g. gifs) cohabitating in the same directory.
+and non Embperl documents (e.g. gifs) residing in the same directory.
EMBPERL_FILESMATCH works only under mod_perl.
<P>
@@ -83,15 +83,14 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="EMBPERL_ALLOW_only_1_2b10_and_a">EMBPERL_ALLOW (only 1.2b10 and above)</A></H2> \
<P>
-If specified, only files which match the given <STRONG>perl regular \
expression</STRONG> will be processed by Embperl, all other files will return \
FORBIDDEN.
-Especialy in a CGI environenemt this can be usefull to make a server more
-secure.
+If specified, only files which match the given <STRONG>perl regular \
expression</STRONG> will be processed by Embperl. All other files will return \
FORBIDDEN. This +is especially useful in a CGI environment by making the server more \
secure.
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="EMBPERL_PATH_1_3b6_and_above_">EMBPERL_PATH (1.3b6 and above)</A></H2> <P>
-Can contain a semikolon (under Unix also colon) separated file search path.
+Can contain a semicolon (also colon under Unix) separated file search path.
When a file is processed and the filename isn't an absolute path or does
not start with ./ (or .\ under windows), <EM>Embperl</EM> searches all the \
specified directories for that file. Directories must end with a slash \
(<CODE>/</CODE>), otherwise the entry is treated as a fileprefix. A special handling \
is @@ -116,10 +115,9 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="EMBPERL_LOG">EMBPERL_LOG</A></H2> <P>
Gives the location of the log file. This will contain information about
-what Embperl is doing. How much information depends on the debug settings
-(see <A href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> below). The log \
output is intended to show what your embedded Perl code is
-doing and to help debug it. The default is
-<STRONG>/tmp/embperl.log</STRONG>.
+what Embperl is doing. The amount of information depends on the debug
+settings (see <A href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> below). \
The log output is intended to show what your embedded Perl code is +doing and to \
help debug it. The default is <STRONG>/tmp/embperl.log</STRONG>.
<P>
<STRONG>NOTE:</STRONG> When running under mod_perl you need to use \
<STRONG>PerlSetEnv</STRONG> for setting the logfile path, and mod_perl >= 1.07_03 \
if you load @@ -131,7 +129,7 @@
<P>
The name of the package where your code will be executed. By default,
Embperl generates a unique package name for every file. This ensures that
-variables and functions from one file can not affect those from another
+variables and functions from one file do not conflict with those of another
file. (Any package's variables will still be accessible with explicit
package names.)
@@ -141,7 +139,7 @@
<P>
Gives a virtual location where you can access the Embperl logfile with a
browser. This feature is disabled (default) if EMBPERL_VIRTLOG is not
-specified. See also <A href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> \
and dbgLogLink for an Example how to set it up in your srm.conf. +specified. See \
also <A href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> and dbgLogLink for \
an Example on how to set it up in your srm.conf.
<P>
<HR>
@@ -157,8 +155,8 @@
<DT><STRONG><A NAME="optDisableEmbperlErrorPage">optDisableEmbperlErrorPage = \
2</A></STRONG><DD> <P>
-Tells Embperl to not send its own errorpage in case of failure, instead
-shows as much of the page as possible. Errors are only logged to the log
+Tells Embperl not to send its own errorpage in case of failure, but instead
+show as much of the page as possible. Errors are only logged to the log
file. Without this option, Embperl sends its own error page, showing all
the errors which have occurred. If you have dbgLogLink enabled, every error
will be a link to the corresponding location in the log file. This option
@@ -166,9 +164,9 @@
<DT><STRONG><A NAME="optReturnError">optReturnError = 262144</A></STRONG><DD>
<P>
-With this option set Embperl sends no output in case of an error, instead
-it returns the error back to Apache or the calling programm. When running
-under mod_perl this gives you the chance to use the Apache <EM>ErrorDocument</EM>
+With this option set, Embperl sends no output in case of an error. It
+returns the error back to Apache or the calling program. When running under
+mod_perl this gives you the chance to use the Apache <EM>ErrorDocument</EM>
directive to show a custom error-document. Inside the ErrorDocument you can
retrieve the error messages with
@@ -199,7 +197,7 @@
<P>
If you are using a WYSIWYG editor which inserts unwanted HTML tags in your
-Perl expressions and escapes special charcaters automatically (e.g., `<'
+Perl expressions and escapes special characters automatically (e.g., `<'
appears as `&lt;' in the source), you should not set this option.
Embperl will automatically convert the HTML input back to the Perl
expressions as you wrote them.
@@ -217,14 +215,16 @@
<DT><STRONG><A NAME="optDisableChdir">optDisableChdir = 128</A></STRONG><DD>
<P>
-Without this option, Embperl changes the currect directory to the one where
-the script resides. This gives you the chance to use relative pathnames.
-Since directory-changing takes up some millisecs, you can disable it with
-this option if you don't need it.
+By default, Embperl changes the current directory to the one where the
+script resides, thus giving you the chance to use relative pathnames. Since
+directory-changing takes up some millisecs, you can disable it with this
+option if you don't need it.
<DT><STRONG><A NAME="optDisableFormData">optDisableFormData = 256</A></STRONG><DD>
<P>
-This option disables the setup of <CODE>%fdat</CODE> and @ffld. Embperl will not \
do anything with the posted form data. +This option disables the setup of \
<CODE>%fdat</CODE> and @ffld. Embperl will not do anything with the posted form data. \
Set this when +using Execute from your perl script and you have already read the \
Form Data +(via eg. CGI.pm).
<DT><STRONG><A NAME="optDisableHtmlScan">optDisableHtmlScan = 512</A></STRONG><DD>
<P>
@@ -250,18 +250,18 @@
<P>
This option will cause Embperl to insert all formfields in
<CODE>%fdat</CODE> and @ffld, even if they are empty. Empty formfields will be \
inserted with an
-empty string. Without this option empty formfields will not be insert in
+empty string. Without this option, empty formfields will be absent from
<CODE>%fdat</CODE> and @ffld.
<DT><STRONG><A NAME="optRedirectStdout">optRedirectStdout = 16384</A></STRONG><DD>
<P>
Redirects STDOUT to the Embperl output stream before every request and
-resets it afterwards. If set, you can use a normal Perl <STRONG>print</STRONG> \
inside any Perl block to output data. Without this option you can only +resets it \
afterwards. If set, you can use a normal Perl <STRONG>print</STRONG> inside any Perl \
block to output data. Without this option you can only use output data by using the \
[+ ... +] block, or printing to the filehandle <STRONG>OUT</STRONG>.
<DT><STRONG><A NAME="optUndefToEmptyValue">optUndefToEmptyValue = \
32768</A></STRONG><DD> <P>
-Normally if there is no value in <CODE>%fdat</CODE> for a specific input
+Normally, if there is no value in <CODE>%fdat</CODE> for a specific input
field, Embperl will leave it untouched. When this option is set, Embperl
will handle the field as if an empty string was stored in
<CODE>%fdat</CODE> for the field.
@@ -275,7 +275,7 @@
<DT><STRONG><A NAME="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.
+requested. With this option set, Embperl will return an empty document.
<DT><STRONG><A NAME="optKeepSrcInMemory">optKeepSrcInMemory = 524288 (only 1.2b5 \
and above)</A></STRONG><DD> <P>
@@ -285,15 +285,15 @@
<DT><STRONG><A NAME="optKeepSpaces">optKeepSpaces = 1048576 (only 1.2b5 and above) \
= 0x100000,</A></STRONG><DD> <P>
-Disable the removing of spaces and empty lines from the output. This is
-usefull for other sources then HTML.
+Disable the removal of spaces and empty lines from the output. This is
+useful for sources other than HTML.
<DT><STRONG><A NAME="optOpenLogEarly">optOpenLogEarly = 2097152 (only 1.2b5 and \
above)</A></STRONG><DD> <P>
-This option causeses Embperl to open the logfile as soon as it is loaded
-into memory. You can use this when you load Embperl via PerlModule under
-Apache, to open the log as root instead of the non-privileged user Apache
-runs as. =item optUncloseWarn = 4194304 (only 1.2b6 and above)
+This option causes Embperl to open the logfile as soon as it is loaded into
+memory. You can use this when you load Embperl via PerlModule under Apache,
+to open the log as root instead of the non-privileged user Apache runs as.
+=item optUncloseWarn = 4194304 (only 1.2b6 and above)
<P>
Disable the warnings about unclosed <CODE>if</CODE>, <CODE>while</CODE>, \
<CODE>table</CODE> etc. at the end of the file. @@ -330,7 +330,7 @@
<DT><STRONG><A NAME="dbgForm">dbgForm = 32</A></STRONG><DD>
<P>
-Lists posted form data.
+List posted form data.
<DT><STRONG><A NAME="dbgTab">dbgTab = 64</A></STRONG><DD>
<P>
@@ -396,7 +396,7 @@
time. (This should not be used in normal operation as it slows down Embperl
dramatically.) This option is only here for debugging Embperl's cache
handling. There is no guarantee that Embperl behaves the same with and
-without cache (actually is does not!)
+without cache (actually it does not!)
<DT><STRONG><A NAME="dbgHeadersIn">dbgHeadersIn = 262144</A></STRONG><DD>
<P>
@@ -418,7 +418,7 @@
<DT><STRONG><A NAME="dbgImport">dbgImport = 4194304 (only 1.2b5 and \
above)</A></STRONG><DD> <P>
-Show how subroutines are imported in other namesapces
+Show how subroutines are imported in other namespaces.
</DL>
<P>
@@ -459,10 +459,10 @@
</PRE>
<DT><STRONG><A NAME="_cacheargs">$cacheargs</A></STRONG><DD>
<P>
-a reference to a scalar, to which the modification time should be returned,
-alternativ (1.2.1 and up) you can return a reference to a hash with the
+a reference to a scalar, to which the modification time should be returned.
+Alternatively (1.2.1 and up), you can return a reference to a hash with the
elements <A href="Embperl.pod.2.html#item_mtime">mtime</A> and <A \
href="Embperl.pod.2.html#item_inputfile">inputfile</A>
-with are used to correcly cache the precompiled Perlcode.
+which are used to correcly cache the precompiled Perlcode.
<P>
<PRE> Example:
@@ -524,7 +524,7 @@
See also <A href="Embperl.pod.10.html#ProxyInput_r_in_mtime_sr">ProxyInput</A> \
below, for an input function which comes with Embperl.
<P>
-NOTE: There are also two modules (<EM>HTML::EmbperlChain</EM> and \
<EM>Apache::EmbperlFilter</EM>) which provides you with the possibility to chain \
<EM>Embperl</EM> and other modules together. +NOTE: There are also two modules \
(<EM>HTML::EmbperlChain</EM> and <EM>Apache::EmbperlFilter</EM>) which allow you to \
chain <EM>Embperl</EM> and other modules together.
<P>
<HR>
@@ -593,7 +593,7 @@
See also <A href="Embperl.pod.10.html#LogOutput_r_out_basepath_">LogOutput</A> \
below, for an output function which comes with Embperl.
<P>
-NOTE: There are also two modules (<EM>HTML::EmbperlChain</EM> and \
<EM>Apache::EmbperlFilter</EM>) which provides you with the possibility to chain \
<EM>Embperl</EM> and other modules together. +NOTE: There are also two modules \
(<EM>HTML::EmbperlChain</EM> and <EM>Apache::EmbperlFilter</EM>) which allow you to \
chain <EM>Embperl</EM> and other modules together.
<P>
<HR>
@@ -661,8 +661,8 @@
<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 (and optional the
-serialsation and id generating class) for Apache::Session (see <A \
href="Embperl.pod.7.html#Session_handling">Session handling</A>) +Space separated \
list of object store and lock manager (and optionally the +serialization and id \
generating class) for Apache::Session (see <A \
href="Embperl.pod.7.html#Session_handling">Session handling</A>)
<P>
<HR>
1.13 +24 -25 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- Embperl.pod.4.html 2000/08/25 05:31:54 1.12
+++ Embperl.pod.4.html 2000/11/07 19:33:55 1.13
@@ -106,7 +106,7 @@
No output will be generated.
</PRE>
<P>
-<PRE> [- use SomeModule ; -] You can use other modules. NOTE the semikolon!
+<PRE> [- use SomeModule ; -] You can use other modules. NOTE the semicolon!
</PRE>
<P>
<PRE> [- $i=0; while ($i<5) {$i++} -] Even more complex
@@ -139,14 +139,13 @@
<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.
+This is similar to [- Perl Code -]. The main difference is, while [- Perl
+Code -] always has its own scope, all [* Perl code *] blocks runs in the
+same scope. This allows you to define ``local'' variables with a scope of
+the whole page. Normally, 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 to recursively call an Embperl document via Execute.
<P>
There is a second reason to use the [* Perl code *] instead of the [- Perl
@@ -196,10 +195,10 @@
(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.
+<STRONG>NOTE 3:</STRONG> There are still benefits of using [- ... -] and \
metacommands: - much better +debugging in the log file. - no restriction on where \
they can be used. You +can use them anywhere; even inside html tags that are \
interpreted by +Embperl.
<P>
<HR>
@@ -343,14 +342,14 @@
fields are sent to the browser, which sends it back with the next request.
If you have a large amount of data, store it in a file with a unique name
and send only the filename in a hidden field. Be aware of the fact that the
-data can be change by the browser if the user doesn't behave exactly as you
-expect. Users have a nasty habit of doing this all of the time. Your
+data can be changed by the browser if the user doesn't behave exactly as
+you expect. Users have a nasty habit of doing this all of the time. Your
program should be able to handle such situations properly.
<DT><STRONG><A NAME="var">var</A></STRONG><DD>
<P>
The var command declares one or more variables for use within this Embperl
-document and sets the <STRONG>strict</STRONG> pragma. The variable names must be \
supplied as space-separated list. +document and sets the <STRONG>strict</STRONG> \
pragma. The variable names must be supplied as a space-separated list.
<P>
Example: [$var <CODE>$a</CODE> <CODE>%b</CODE> <CODE>@c</CODE> $]
@@ -426,8 +425,8 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A NAME="HTML_Tags">HTML \
Tags</A></H2> <P>
-Embperl recognizes the following HTML tags specially. All others are simply
-passed through, as long as they are not part of a Embperl command.
+Embperl recognizes the following HTML tags in a special way. All others are
+simply passed through, as long as they are not part of a Embperl command.
<DL>
<DT><STRONG><A NAME="TABLE">TABLE, /TABLE, TR, /TR</A></STRONG><DD>
@@ -443,13 +442,13 @@
<P>
Embperl checks if any of $row, $col, or <CODE>$cnt</CODE> is used. Embperl
-repeats all text between <table> and </table>, as long the
-expressions in which <CODE>$row</CODE> or <CODE>$cnt</CODE> occurs is/are
+repeats all text between <table> and </table>, as long as the
+expressions in which <CODE>$row</CODE> or <CODE>$cnt</CODE> occurs are
defined.
<P>
-Embperl repeats all text between <tr> and </tr>, as long the
-expressions in which <CODE>$col</CODE> or <CODE>$cnt</CODE> occurs is/are
+Embperl repeats all text between <tr> and </tr>, as long as the
+expressions in which <CODE>$col</CODE> or <CODE>$cnt</CODE> occurs are
defined.
<P>
@@ -522,7 +521,7 @@
</PRE>
<DT><STRONG><A NAME="INPUT">INPUT</A></STRONG><DD>
<P>
-The INPUT tag interacts with the hashes <CODE>%idat</CODE> und <CODE>%fdat</CODE>. \
If the input tag has no value, and a key exists with the same text as the +The INPUT \
tag interacts with the hashes <CODE>%idat</CODE> and <CODE>%fdat</CODE>. If the input \
tag has no value and a key exists with the same text as the NAME attribute of the \
input tag, Embperl will generate a VALUE attribute with the corresponding value of \
the hash key. All values of <INPUT> tags are stored in the hash \
<CODE>%idat</CODE>, with NAME as the hash key and VALUE as the hash value. Special \
processing is done for TYPE=RADIO and TYPE=CHECKBOX. If the VALUE attribute contains
@@ -530,7 +529,7 @@
else it is removed.
<P>
-So if you specify as the ACTION URL the file which contains the form
+So, if you specify, as the ACTION URL, the file which contains the form
itself, the form will be redisplayed with same values as entered the first
time. (See eg/x/neu.htm for an example.)
@@ -566,7 +565,7 @@
<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 and hash refernces to URL paramter syntax. Example: +also <EM>$escmode</EM>). \
Also, when inside such a URL, <EM>Embperl</EM> expands array and hash references to \
URL parameter syntax. Example:
<P>
<PRE> [-
1.20 +1 -1 modperl-site/embperl/Embperl.pod.5.html
Index: Embperl.pod.5.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.5.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- Embperl.pod.5.html 2000/08/25 05:31:54 1.19
+++ Embperl.pod.5.html 2000/11/07 19:33:55 1.20
@@ -58,7 +58,7 @@
function.
<P>
-You can define expections to the cleanup rule with the hash \
<STRONG>%CLEANUP</STRONG>. +You can define exceptions to the cleanup rule with the \
hash <STRONG>%CLEANUP</STRONG>.
<P>
If you like to do your own cleanup you can define a subroutine \
<STRONG>CLEANUP</STRONG>
1.20 +25 -25 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.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- Embperl.pod.6.html 2000/10/18 07:34:05 1.19
+++ Embperl.pod.6.html 2000/11/07 19:33:55 1.20
@@ -63,9 +63,9 @@
Embperl's CGI mode -- it is safer to use POST.
<P>
-If multiple fields with the same name send to a Embperl page they will put
-in the same hash element and separated be tabs. You can split it up in an
-array, by writting:
+If multiple fields with the same name are sent to a Embperl page, they will
+put in the same hash element and separated be tabs. You can split it up in
+an array, by writting:
<P>
<PRE> @array = split (/\t/, $fdat{'fieldname'}) ;
@@ -101,11 +101,11 @@
</PRE>
<P>
-When you have installed CGI.pm 2.46 or above you may also retrieve the
+When you have installed CGI.pm 2.46 or above, you may also retrieve the
filename (local filename, as it was on the browser side) and the
-informations provied by the CGI.pm uploadInfo function. To get the filename
-just print out the value of the correspondig <CODE>%fdat</CODE> entry,
-instead of using it as a filehandle. To get the <STRONG>uploadInfo</STRONG> use \
the fieldname with a dash in front of it: +information provided by the CGI.pm \
uploadInfo function. To get the +filename, simply print out the value of the \
corresponding +<CODE>%fdat</CODE> entry, instead of using it as a filehandle. To get \
the <STRONG>uploadInfo</STRONG> use the fieldname with a dash in front of it:
<P>
<PRE> Example:
@@ -117,7 +117,7 @@
Content-Type: [+ $fdat{-ImageName} -> {'Content-Type'} +] <br>
</PRE>
<P>
-<STRONG>NOTE:</STRONG> The way <STRONG>uploadInfos</STRONG> are accessed before \
1.2b11 are not supported anymore. +<STRONG>NOTE:</STRONG> The way \
<STRONG>uploadInfos</STRONG> are accessed before 1.2b11 is not supported anymore.
<P>
<STRONG>NOTE:</STRONG> This works the other way as well: any input fields with \
names that are @@ -147,8 +147,8 @@
and sends it via a cookie to the browser. The data you have written to
<CODE>%udat</CODE> is stored by Apache::Session. The next time the same
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.7.html#Session_handling">Session handling</A>) +id back and \
Embperl fills the <CODE>%udat</CODE> hash from Apache::Session +with the same values \
as you have stored for that user. (See also <A \
href="Embperl.pod.7.html#Session_handling">Session handling</A>)
<P>
<HR>
@@ -158,8 +158,8 @@
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.7.html#Session_handling">Session handling</A>) +Apache::Session \
with the same values as you have stored within the last +request to that page. (See \
also <A href="Embperl.pod.7.html#Session_handling">Session handling</A>)
<P>
<HR>
@@ -171,7 +171,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="_maxrow_maxcol">$maxrow, $maxcol</A></H2> <P>
-Maxium number of rows or columns to display in a table. To prevent endless
+Maximum number of rows or columns to display in a table. To prevent endless
loops, <CODE>$maxrow</CODE> defaults to 100 and <CODE>$maxcol</CODE> to 10.
(See <A href="Embperl.pod.4.html#HTML_Tags">"HTML tag table"</A>.)
@@ -195,8 +195,8 @@
<P>
End table looping when any one of the expressions in the table row using
<CODE>$row</CODE> returns undefined. The row containing the undefined
-expression is <STRONG>not</STRONG> displayed. Only those expression are observed \
which contains an access to
-the varibale $row.
+expression is <STRONG>not</STRONG> displayed. Only those expressions are observed \
which contain an access to +the variable $row.
<DT><STRONG>$tabmode = 2</STRONG><DD>
<P>
@@ -218,8 +218,8 @@
<P>
End table column looping when any one of the expressions in the table
column using <CODE>$col</CODE> returns undefined. The column containing the
-undefined expression is <STRONG>not</STRONG> displayed. Only those expression are \
observed which contains an access to
-the varibale $col.
+undefined expression is <STRONG>not</STRONG> displayed. Only those expressions are \
observed which contain an access to +the variable $col.
<DT><STRONG>$tabmode = 32</STRONG><DD>
<P>
@@ -246,7 +246,7 @@
escaped with a backslash. While this is a handy thing, it could be very
dangerous in situations, where content that is inserted by some user is
redisplayed, because they can enter arbitary HTML and preceed them with a
-backslash to avoid correct esaping when their input is redisplayed again.
+backslash to avoid correct escaping when their input is redisplayed again.
To avoid this problem, add 4 to the values below. This will cause Embperl
to ignore the backslash when it does output escaping at all. (only 1.3b4
and above)
@@ -330,8 +330,8 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="_http_headers_out_only_1_2b10_a">%http_headers_out (only 1.2b10 and \
above)</A></H2> <P>
-You can put any http headers you want to send into this hash. If you set an
-location header Embperl will automaticly set the status to 301 (Redirect).
+You can put any http headers you want to send into this hash. If you set a
+location header, Embperl will automaticly set the status to 301 (Redirect).
Example:
<P>
@@ -381,17 +381,17 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="_CLEANUP">%CLEANUP</A></H2> <P>
Embperl cleanups up only variables with are defined within the Embperl
-page. If you want Embperl to cleanup addtional variables you can add them
+page. If you want Embperl to cleanup additional variables you can add them
to the hash %CLEANUP, with the key set to the variable name and the value
-set to one. The other way round you could prevent Embperl from cleaning up
-some variables, by adding them to this hash, with a values of zero.
+set to one. The other way you could prevent Embperl from cleaning up some
+variables, is by adding them to this hash, with values of zero.
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="_CLEANUPFILE_1_2b6_">%CLEANUPFILE (1.2b6+)</A></H2> <P>
-Same purpose as <CODE>%CLEANUP</CODE>, but you may add filenames and all variables \
defined inside that file will
-be cleaned up.
+Same purpose as <CODE>%CLEANUP</CODE>, but you may add filenames. All variables \
defined inside that file will be +cleaned up.
<p>[<a href="" >HOME</a>] [<a \
href="Embperl.pod.cont.html">CONTENT</a>] [<a \
href="Embperl.pod.5.html">PREV (Variable scope and cleanup)</a>] [<a \
href="Embperl.pod.7.html">NEXT (Session handling)</a>] \
<br>
<font color="#808080">___________________________________________________________________________________<br>
1.14 +34 -25 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.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- Embperl.pod.7.html 2000/10/18 07:34:05 1.13
+++ Embperl.pod.7.html 2000/11/07 19:33:55 1.14
@@ -26,23 +26,24 @@
<LI><A href="Embperl.pod.7.html#HTML_Embperl_Req_GetSession_">HTML::Embperl::Req::GetSession \
/ $r -> GetSession [1.3b6+]</A>
<LI><A href="Embperl.pod.7.html#HTML_Embperl_Req_CleanupSessi">HTML::Embperl::Req::CleanupSession \
/ $r -> CleanupSession [1.3b6+]</A>
<LI><A href="Embperl.pod.7.html#HTML_Embperl_Req_DeleteSessio">HTML::Embperl::Req::DeleteSession \
/ $r -> DeleteSession [1.3b6+]</A>
- <LI><A href="Embperl.pod.7.html#HTML_Embperl_Req_DeleteSessio">HTML::Embperl::Req::DeleteSession \
/ $r -> DeleteSession [1.3b6+]</A> + <LI><A \
href="Embperl.pod.7.html#HTML_Embperl_Req_RefreshSessi">HTML::Embperl::Req::RefreshSession \
/ $r -> RefreshSession [1.3b6+]</A> + <LI><A \
href="Embperl.pod.7.html#HTML_Embperl_Req_SetSessionCo">HTML::Embperl::Req::SetSessionCookie \
/ $r -> SetSessionCookie [1.3b7+] </A>
</UL>
<hr>
<P>
From 1.2b1 and higher Embperl is able to handle per user sessions for you.
-You can store any data in the <EM>%udat</EM> hash and if the same user request \
again an Embperl document, you will see +You can store any data in the \
<EM>%udat</EM> hash and if the same user requests an Embperl document again, you will \
see the same values in that hash again.
<P>
-From 1.2b2 and higher Embperl is able to handle per module/page persitent
+From 1.2b2 and higher Embperl is able to handle per module/page persistent
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 <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
+<EM>Apache::Session</EM>. This is done by setting the environment variable
<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:
@@ -66,7 +67,7 @@
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. +Refer to \
the <EM>Apache::Session</EM> docs (e.g. <EM>Apache::Session::Store::MySQL</EM>) on \
how to setup your database tables.
<P>
<CODE>EMBPERL_SESSION_ARGS</CODE> is a space separated list of name/value pairs, \
which gives additional @@ -80,28 +81,27 @@
EMBPERL_SESSION_ARGS ``Directory=/path/to/your/sessions''
<P>
-Refer to the <EM>Apache::Session</EM> docs which other storage/locker are \
available. +Refer to the <EM>Apache::Session</EM> docs to find out which other \
storage/locker methods 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>). +<CODE>EMBPERL_SESSION_CLASSES</CODE> can (optionally) \
take two more classnames, which specify 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>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> +<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 support <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
-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
+Now you are able to use the <CODE>%udat</CODE> and <CODE>%mdat</CODE>
+hashes for your user/module sessions. As long as you don't touch
+<CODE>%udat</CODE> or %mdat, Embperl will not create any session, and
+Apache::Session is not 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 its id, while the data is stored by Apache::Session. (Further
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.
+modify %mdat, Embperl will store the data via Apache::Session and retrieve
+it when the next request comes to the same page.
<P>
<HR>
@@ -110,7 +110,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="HTML_Embperl_Req_SetupSession">HTML::Embperl::Req::SetupSession ($req_rec, \
$Inputfile) [1.3b6+]</A></H2> <P>
-This can be used from an script that will later on call <A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A> to \
preset the session so it's available to the calling script. +This can be used from \
a script that will later call <A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A> to \
preset the session so it's available to the calling script.
<DL>
<DT><STRONG><A NAME="_req_rec">$req_rec</A></STRONG><DD>
@@ -119,7 +119,7 @@
<DT><STRONG><A NAME="_Inputfile">$Inputfile</A></STRONG><DD>
<P>
-Name of file that will be process later by Embperl. It is used to setup \
<EM>%mdat</EM>. If you don't pass the <CODE>$Inputfile</CODE>, <CODE>%mdat</CODE> is \
not setup. +Name of file that will be later processed by Embperl. It is used to \
setup <EM>%mdat</EM>. If you don't pass the <CODE>$Inputfile</CODE>, \
<CODE>%mdat</CODE> is not setup.
</DL>
<P>
@@ -130,16 +130,16 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="HTML_Embperl_Req_GetSession_">HTML::Embperl::Req::GetSession / $r -> \
GetSession [1.3b6+]</A></H2> <P>
-Returns a reference to <EM>%udat</EM> or, if call in an array context, a reference \
to <EM>%udat</EM>
-and <EM>%mdat</EM>. This could be used by modules that are called from inside a \
Embperl page,
-where the session management is already setup. If called as a method \
<CODE>$r</CODE> must be a HTML::Embperl::Req object, which is passed as first \
parameter to +Returns a reference to <EM>%udat</EM> or, if called in an array \
context, a reference to <EM>%udat</EM> +and <EM>%mdat</EM>. This could be used by \
modules that are called from inside an Embperl +page, where the session management \
is already setup. If called as a method <CODE>$r</CODE> must be a HTML::Embperl::Req \
object, which is passed as first parameter to every Embperl page in <CODE>@_</CODE> \
.
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="HTML_Embperl_Req_CleanupSessi">HTML::Embperl::Req::CleanupSession / $r -> \
CleanupSession [1.3b6+]</A></H2> <P>
-Must be called at the end of a script by scripts, that uses \
<CODE>SetupSession</CODE>, but do not call <A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A>. If \
called as a method <CODE>$r</CODE> must be a HTML::Embperl::Req object, which is \
passed as first parameter to +Must be called at the end of a script by scripts that \
use <CODE>SetupSession</CODE>, but do not call <A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A>. If \
called as a method <CODE>$r</CODE> must be a HTML::Embperl::Req object, which is \
passed as first parameter to every Embperl page in <CODE>@_</CODE> .
<P>
@@ -152,12 +152,21 @@
<P>
<HR>
-<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="HTML_Embperl_Req_DeleteSessio">HTML::Embperl::Req::DeleteSession / $r -> \
DeleteSession [1.3b6+]</A></H2> +<H2><img src="sq.gif" width="16" height="16" \
alt="-"> <A NAME="HTML_Embperl_Req_RefreshSessi">HTML::Embperl::Req::RefreshSession / \
$r -> RefreshSession [1.3b6+]</A></H2> <P>
Triggers a resend of the cookie. Normaly the cookie is only send the first
time. If called as a method <CODE>$r</CODE> must be a HTML::Embperl::Req object, \
which is passed as first parameter to every Embperl page in <CODE>@_</CODE> .
+<P>
+<HR>
+<H2><img src="sq.gif" width="16" height="16" alt="-"> <A \
NAME="HTML_Embperl_Req_SetSessionCo">HTML::Embperl::Req::SetSessionCookie / $r -> \
SetSessionCookie [1.3b7+] +
+Must be called by scripts that use <CODE>SetupSession</CODE>,
+but do not call <A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A>. \
This is neccessary to set the cookie +for the session id, in case a new session is \
created, which is normaly done by +<A \
HREF="/HTML/Embperl/Execute|Execute.html">HTML::Embperl::Execute|Execute</A>. \
If called as a method <CODE>$r</CODE> must be +a HTML::Embperl::Req \
object, which is passed as first parameter to every Embperl page in @_ .</A></H2> \
<p>[<a href="" >HOME</a>] [<a \
href="Embperl.pod.cont.html">CONTENT</a>] [<a \
href="Embperl.pod.6.html">PREV (Predefined variables)</a>] [<a \
href="Embperl.pod.8.html">NEXT ((Safe-)Namespaces and opcode \
restrictions)</a>] <br>
<font color="#808080">___________________________________________________________________________________<br>
HTML::Embperl - Copyright (c) 1997-2000 Gerald Richter / <a \
href="http://www.ecos.de/">ecos gmbh</a>
1.11 +3 -3 modperl-site/embperl/Embperl.pod.8.html
Index: Embperl.pod.8.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.8.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Embperl.pod.8.html 2000/08/25 05:31:55 1.10
+++ Embperl.pod.8.html 2000/11/07 19:33:55 1.11
@@ -31,9 +31,9 @@
is used by another document.
<P>
-If Embperl is used by more then one person, it may be neccessary to really
-protect documents from each other. To do this, Embperl gives you the option
-of using safe namespaces. Each document runs in its own package and can't
+If Embperl is used by more than one person, it may be neccessary to protect
+documents from each other. To do this, Embperl gives you the option of
+using safe namespaces. Each document runs in its own package and can't
access anything outside of this package. (See the documentation of Safe.pm
for a more detailed discussion of safe namespaces.)
1.10 +5 -5 modperl-site/embperl/Embperl.pod.9.html
Index: Embperl.pod.9.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.9.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- Embperl.pod.9.html 2000/08/25 05:31:55 1.9
+++ Embperl.pod.9.html 2000/11/07 19:33:55 1.10
@@ -76,14 +76,14 @@
<BODY>
[- MailFormTo('webmaster@domain.xy',
'Mail from WWW Form', 'email') -]
- Your data has been sccesfully sent!
+ Your data has been successfully sent!
</BODY>
</HTML>
</PRE>
<P>
-This will send a mail with all fields of the form to <A
+This will send an email with all the form fields to <A
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic