richter 00/10/18 00:34:22
Modified: embperl CVS.pod.1.html Changes.pod.1.html
Changes.pod.2.html Changes.pod.cont.html
Embperl.pod.17.html Embperl.pod.2.html
Embperl.pod.3.html Embperl.pod.6.html
Embperl.pod.7.html Embperl.pod.cont.html
EmbperlObject.pod.1.html EmbperlObject.pod.2.html
Faq.pod.1.html Faq.pod.cont.html INSTALL.pod.1.html
Log:
Embperl Webpages - Changes
Revision Changes Path
1.14 +1 -1 modperl-site/embperl/CVS.pod.1.html
Index: CVS.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/CVS.pod.1.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- CVS.pod.1.html 2000/09/27 04:37:57 1.13
+++ CVS.pod.1.html 2000/10/18 07:34:03 1.14
@@ -162,7 +162,7 @@
<P>
There is a CVS mailing list for Embperl (This is CVS - <STRONG>not</STRONG> a list
for asking questions about Embperl!!!). This list receives all
changes which are commited to the CVS. If you want to know what's going on
-which Embperl, you can subscribe by sending a mail to
<STRONG>[EMAIL PROTECTED]</STRONG>
+which Embperl, you can subscribe by sending a mail to
<STRONG>[EMAIL PROTECTED]</STRONG>
with <STRONG>subscribe</STRONG> in the body.
<p>[<a href="" >HOME</a>] [<a
href="CVS.pod.cont.html">CONTENT</a>] [<a href="CVS.pod.cont.html">PREV
(CVS - Content)</a>] <br>
1.178 +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.177
retrieving revision 1.178
diff -u -r1.177 -r1.178
--- Changes.pod.1.html 2000/10/17 11:01:57 1.177
+++ Changes.pod.1.html 2000/10/18 07:34:03 1.178
@@ -1,6 +1,6 @@
<HTML>
<HEAD>
-<TITLE>1.3b6_dev -- That's what currently under developement</TITLE>
+<TITLE>1.3b6 18. Sept 2000</TITLE>
<LINK REV="made" HREF="mailto:[EMAIL PROTECTED]">
</HEAD>
@@ -11,7 +11,7 @@
<tr>
<td valign=bottom align=center>
<font size=6><strong>
-<A NAME="1_3b6_dev_That_s_what_current">1.3b6_dev -- That's what currently under
developement</a></strong></font>
+<A NAME="1_3b6_BETA_18_Sept_2000">1.3b6 (BETA) 18. Sept 2000</a></strong></font>
</td><td rowspan=2 align=right></td>
</tr><tr><td valign=top align=center>
@@ -20,14 +20,6 @@
</td></tr></table>
[<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.3b5 (BETA) 20. Aug 2000)</a>] <br><hr>
-<P>
-Last Update: Tue Oct 17 13:02:32 2000 (MET)
-
-<P>
-NOTE: This version is only available via <A HREF="CVS.pod.1.html#INTRO" >"CVS"</A>
-
-
-
<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
1.46 +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.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- Changes.pod.2.html 2000/08/25 05:31:42 1.45
+++ Changes.pod.2.html 2000/10/18 07:34:04 1.46
@@ -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.3b6_dev -- That's what currently under
developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b4 (BETA)
17.07.2000)</a>] <br><hr>
+[<a href="" >HOME</a>] [<a
href="Changes.pod.cont.html">CONTENT</a>] [<a
href="Changes.pod.1.html">PREV (1.3b6 (BETA) 18. Sept 2000)</a>] [<a
href="Changes.pod.3.html">NEXT (1.3b4 (BETA) 17.07.2000)</a>] <br><hr>
<P>
<PRE> - Embperl now supports Apache::Session 1.52. See "Session
handling"
in the docs, how the setup has changed.
@@ -49,7 +49,7 @@
from Jason Bodnar. NOTE: That doesn't mean that Embperl is
threadsafe!
</PRE>
-<p>[<a href="" >HOME</a>] [<a
href="Changes.pod.cont.html">CONTENT</a>] [<a
href="Changes.pod.1.html">PREV (1.3b6_dev -- That's what currently under
developement)</a>] [<a href="Changes.pod.3.html">NEXT (1.3b4 (BETA)
17.07.2000)</a>] <br>
+<p>[<a href="" >HOME</a>] [<a
href="Changes.pod.cont.html">CONTENT</a>] [<a
href="Changes.pod.1.html">PREV (1.3b6 (BETA) 18. Sept 2000)</a>] [<a
href="Changes.pod.3.html">NEXT (1.3b4 (BETA) 17.07.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.46 +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.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- Changes.pod.cont.html 2000/08/25 05:31:51 1.45
+++ Changes.pod.cont.html 2000/10/18 07:34:04 1.46
@@ -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.3b6_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.3b6 (BETA) 18. Sept 2000)</a>]
<br><HTML>
<HEAD>
<TITLE>Revision History - Content</TITLE>
<LINK REV="made" HREF="mailto:[EMAIL PROTECTED]">
@@ -31,7 +31,7 @@
<UL>
- <LI><A href="Changes.pod.1.html#1_3b6_dev_That_s_what_current">1.3b6_dev -
That's what currently under developement</A>
+ <LI><A href="Changes.pod.1.html#1_3b6_BETA_18_Sept_2000">1.3b6 (BETA) 18.
Sept 2000</A>
<LI><A href="Changes.pod.2.html#1_3b5_BETA_20_Aug_2000">1.3b5 (BETA) 20. Aug
2000</A>
<LI><A href="Changes.pod.3.html#1_3b4_BETA_17_07_2000">1.3b4 (BETA)
17.07.2000</A>
<LI><A href="Changes.pod.4.html#1_3b3_BETA_25_04_2000">1.3b3 (BETA)
25.04.2000</A>
@@ -76,7 +76,7 @@
<LI><A href="Changes.pod.43.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.3b6_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.3b6 (BETA) 18. Sept 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.4 +1 -1 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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Embperl.pod.17.html 2000/08/25 05:31:52 1.3
+++ Embperl.pod.17.html 2000/10/18 07:34:04 1.4
@@ -41,7 +41,7 @@
<P>
Then download my mmm-embperl.el from this one: <A
-HREF="http://inanna.starseed.com/~erik/mmm-embperl.el">http://inanna.starseed.com/~erik/mmm-embperl.el</A>
+HREF="http://www.aarg.net/erik/mmm-embperl.el">http://www.aarg.net/erik/mmm-embperl.el</A>
<P>
1.22 +1 -1 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.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- Embperl.pod.2.html 2000/08/25 05:31:53 1.21
+++ Embperl.pod.2.html 2000/10/18 07:34:04 1.22
@@ -366,7 +366,7 @@
<DT><STRONG><A NAME="path">path (1.3b1 and above)</A></STRONG><DD>
<P>
-Same as <A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b1_and_above_">"EMBPERL_PATH"</A> (see below)
+Same as <A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b6_and_above_">"EMBPERL_PATH"</A> (see below)
<DT><STRONG><A NAME="uri">uri</A></STRONG><DD>
<P>
1.20 +7 -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.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- Embperl.pod.3.html 2000/08/25 05:31:54 1.19
+++ Embperl.pod.3.html 2000/10/18 07:34:04 1.20
@@ -23,7 +23,7 @@
<LI><A
href="Embperl.pod.3.html#EMBPERL_FILESMATCH">EMBPERL_FILESMATCH</A>
<LI><A
href="Embperl.pod.3.html#EMBPERL_ALLOW_only_1_2b10_and_a">EMBPERL_ALLOW (only 1.2b10
and above)</A>
- <LI><A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b1_and_above_">EMBPERL_PATH (1.3b1 and
above)</A>
+ <LI><A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b6_and_above_">EMBPERL_PATH (1.3b6 and
above)</A>
<LI><A
href="Embperl.pod.3.html#EMBPERL_COMPARTMENT">EMBPERL_COMPARTMENT</A>
<LI><A href="Embperl.pod.3.html#EMBPERL_ESCMODE">EMBPERL_ESCMODE</A>
<LI><A href="Embperl.pod.3.html#EMBPERL_LOG">EMBPERL_LOG</A>
@@ -89,10 +89,14 @@
<P>
<HR>
-<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="EMBPERL_PATH_1_3b1_and_above_">EMBPERL_PATH (1.3b1 and above)</A></H2>
+<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.
-When a file is processed and the filename does not contain a path, <EM>Embperl</EM>
searches all the specified directories for that file.
+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
+done if the filename starts with any number of <CODE>../</CODE> i.e. refers to an
upper directory. Then <EM>Embperl</EM> strips the same number of entries at the start
of the searchpath as the
+filename contains <CODE>../</CODE>.
<P>
<HR>
1.19 +17 -1 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.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- Embperl.pod.6.html 2000/08/25 05:31:54 1.18
+++ Embperl.pod.6.html 2000/10/18 07:34:05 1.19
@@ -32,13 +32,14 @@
<LI><A href="Embperl.pod.6.html#_cnt">$cnt</A>
<LI><A href="Embperl.pod.6.html#_tabmode">$tabmode</A>
<LI><A href="Embperl.pod.6.html#_escmode">$escmode</A>
- <LI><A href="Embperl.pod.6.html#_req_rec">$req_rec</A>
+ <LI><A href="Embperl.pod.7.html#_req_rec">$req_rec</A>
<LI><A href="Embperl.pod.6.html#LOG">LOG</A>
<LI><A href="Embperl.pod.6.html#OUT">OUT</A>
<LI><A href="Embperl.pod.6.html#_param">@param</A>
<LI><A
href="Embperl.pod.6.html#_http_headers_out_only_1_2b10_a">%http_headers_out (only
1.2b10 and above)</A>
<LI><A href="Embperl.pod.6.html#_optXXX_dbgXXX">$optXXX $dbgXXX</A>
<LI><A href="Embperl.pod.6.html#_CLEANUP">%CLEANUP</A>
+ <LI><A href="Embperl.pod.6.html#_CLEANUPFILE_1_2b6_">%CLEANUPFILE
(1.2b6+)</A>
</UL>
<hr>
<P>
@@ -250,6 +251,14 @@
to ignore the backslash when it does output escaping at all. (only 1.3b4
and above)
+<P>
+<STRONG>NOTE 2:</STRONG> If you want to output binary data, you must set the
escmode to zero. (only
+1.3b6 and above)
+
+<P>
+<PRE>
+=over 4
+</PRE>
<DL>
<DT><STRONG><A NAME="_escmode">$escmode = 3 (or 7)</A></STRONG><DD>
<P>
@@ -376,6 +385,13 @@
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.
+
+<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.
<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.13 +65 -1 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.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- Embperl.pod.7.html 2000/08/25 05:31:54 1.12
+++ Embperl.pod.7.html 2000/10/18 07:34:05 1.13
@@ -19,7 +19,16 @@
<img src="line.jpg" alt="________" WIDTH="732" HEIGHT="35" >
</td></tr></table>
-[<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><hr>
+[<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> <UL>
+
+ <LI><A
href="Embperl.pod.7.html#Functions_Methods_for_session_ha">Functions/Methods for
session handling</A>
+ <LI><A
href="Embperl.pod.7.html#HTML_Embperl_Req_SetupSession">HTML::Embperl::Req::SetupSession
($req_rec, $Inputfile) [1.3b6+]</A>
+ <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>
+ </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
@@ -93,6 +102,61 @@
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>
+<HR>
+<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Functions_Methods_for_session_ha">Functions/Methods for session handling</A></H2>
+<P>
+<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.
+
+<DL>
+<DT><STRONG><A NAME="_req_rec">$req_rec</A></STRONG><DD>
+<P>
+Apache request record when running under mod_perl, <CODE>undef</CODE> otherwise.
+
+<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.
+
+</DL>
+<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>. See also <CODE>CleanupSession</CODE>.
+
+<P>
+<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
+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
+every Embperl page in <CODE>@_</CODE> .
+
+<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>
+<P>
+Deletes the session data and removes the cookie from the browser. 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_DeleteSessio">HTML::Embperl::Req::DeleteSession / $r ->
DeleteSession [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>[<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>
1.25 +13 -2 modperl-site/embperl/Embperl.pod.cont.html
Index: Embperl.pod.cont.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.cont.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- Embperl.pod.cont.html 2000/08/25 05:31:55 1.24
+++ Embperl.pod.cont.html 2000/10/18 07:34:05 1.25
@@ -48,7 +48,7 @@
<LI><A
href="Embperl.pod.3.html#EMBPERL_FILESMATCH">EMBPERL_FILESMATCH</A>
<LI><A
href="Embperl.pod.3.html#EMBPERL_ALLOW_only_1_2b10_and_a">EMBPERL_ALLOW (only 1.2b10
and above)</A>
- <LI><A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b1_and_above_">EMBPERL_PATH (1.3b1 and
above)</A>
+ <LI><A
href="Embperl.pod.3.html#EMBPERL_PATH_1_3b6_and_above_">EMBPERL_PATH (1.3b6 and
above)</A>
<LI><A
href="Embperl.pod.3.html#EMBPERL_COMPARTMENT">EMBPERL_COMPARTMENT</A>
<LI><A href="Embperl.pod.3.html#EMBPERL_ESCMODE">EMBPERL_ESCMODE</A>
<LI><A href="Embperl.pod.3.html#EMBPERL_LOG">EMBPERL_LOG</A>
@@ -99,16 +99,27 @@
<LI><A href="Embperl.pod.6.html#_cnt">$cnt</A>
<LI><A href="Embperl.pod.6.html#_tabmode">$tabmode</A>
<LI><A href="Embperl.pod.6.html#_escmode">$escmode</A>
- <LI><A href="Embperl.pod.6.html#_req_rec">$req_rec</A>
+ <LI><A href="Embperl.pod.7.html#_req_rec">$req_rec</A>
<LI><A href="Embperl.pod.6.html#LOG">LOG</A>
<LI><A href="Embperl.pod.6.html#OUT">OUT</A>
<LI><A href="Embperl.pod.6.html#_param">@param</A>
<LI><A
href="Embperl.pod.6.html#_http_headers_out_only_1_2b10_a">%http_headers_out (only
1.2b10 and above)</A>
<LI><A href="Embperl.pod.6.html#_optXXX_dbgXXX">$optXXX $dbgXXX</A>
<LI><A href="Embperl.pod.6.html#_CLEANUP">%CLEANUP</A>
+ <LI><A href="Embperl.pod.6.html#_CLEANUPFILE_1_2b6_">%CLEANUPFILE
(1.2b6+)</A>
</UL>
<LI><A href="Embperl.pod.7.html#Session_handling">Session handling</A>
+ <UL>
+
+ <LI><A
href="Embperl.pod.7.html#Functions_Methods_for_session_ha">Functions/Methods for
session handling</A>
+ <LI><A
href="Embperl.pod.7.html#HTML_Embperl_Req_SetupSession">HTML::Embperl::Req::SetupSession
($req_rec, $Inputfile) [1.3b6+]</A>
+ <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>
+ </UL>
+
<LI><A
href="Embperl.pod.8.html#_Safe_Namespaces_and_opcode_res">(Safe-)Namespaces and opcode
restrictions</A>
<LI><A href="Embperl.pod.9.html#Utility_Functions">Utility Functions</A>
<UL>
1.6 +5 -3 modperl-site/embperl/EmbperlObject.pod.1.html
Index: EmbperlObject.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/EmbperlObject.pod.1.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- EmbperlObject.pod.1.html 2000/08/25 05:31:55 1.5
+++ EmbperlObject.pod.1.html 2000/10/18 07:34:05 1.6
@@ -25,14 +25,15 @@
of smaller parts. Basicly it does the following:
<P>
-When a request comes in a page, which name is specified by
<EM>EMBPERL_OBJECT_BASE</EM>, is searched in the same directory as the requested page.
If the pages
+When a request comes in, a page, which name is specified by
<EM>EMBPERL_OBJECT_BASE</EM>, is searched in the same directory as the requested page.
If the pages
isn't found,
<EM>EmbperlObject</EM> walking up the directory tree until it finds the page, or it
reaches <CODE>DocumentRoot</CODE> or the directory specified by
<EM>EMBPERL_OBJECT_STOPDIR</EM>.
<P>
This page is then called as frame for building the real page. Addtionaly
<EM>EmbperlObject</EM>
sets the search path to contain all directories it had to walk before
-finding that page.
+finding that page. If <EM>EMBPERL_OBJECT_STOPDIR</EM> is set the path contains all
directories up to the in
+EMBPERL_OBJECT_STOPDIR specified one.
<P>
This frame page can now include other pages, using the
<CODE>HTML::Embperl::Execute</CODE> method. Because the search path is set by
<EM>EmbperlObject</EM> the included files are searched in the directories starting at
the
@@ -42,7 +43,8 @@
the subdirectory.
<P>
-To include the original requested file, you need to call <CODE>Execute</CODE> with
a <CODE>'*'</CODE> as filename.
+To include the original requested file, you need to call <CODE>Execute</CODE> with
a <CODE>'*'</CODE> as filename. To call the the same file, but in an upper directory
you can
+use the special shortcut <CODE>../*</CODE>.
<P>
Additionaly <EM>EmbperlObject</EM> sets up a inherence hierachie for you: The
requested page inherit from the
1.7 +2 -1 modperl-site/embperl/EmbperlObject.pod.2.html
Index: EmbperlObject.pod.2.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/EmbperlObject.pod.2.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- EmbperlObject.pod.2.html 2000/08/25 05:31:56 1.6
+++ EmbperlObject.pod.2.html 2000/10/18 07:34:05 1.7
@@ -67,7 +67,8 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="EMBPERL_OBJECT_ADDPATH">EMBPERL_OBJECT_ADDPATH</A></H2>
<P>
Additional directories where to search for pages. Directories are separated
-by <CODE>;</CODE> (on Unix <CODE>:</CODE> works also)
+by <CODE>;</CODE> (on Unix <CODE>:</CODE> works also). This path is
+<STRONG>always</STRONG> appended to the searchpath.
<P>
<HR>
1.15 +16 -0 modperl-site/embperl/Faq.pod.1.html
Index: Faq.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.1.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- Faq.pod.1.html 2000/08/25 05:31:57 1.14
+++ Faq.pod.1.html 2000/10/18 07:34:06 1.15
@@ -27,6 +27,7 @@
<LI><A href="Faq.pod.1.html#I_m_getting_">I'm getting:</A>
<LI><A href="Faq.pod.1.html#I_m_trying_to_build_HTML_Embper">I'm
trying to build HTML::Embperl, and while running 'make' i get:</A>
<LI><A href="Faq.pod.1.html#I_have_a_lot_of_errors_in_make_">I have a
lot of errors in 'make test' from mod_perl when using Embperl</A>
+ <LI><A href="Faq.pod.1.html#How_can_I_prevent_make_test_fr">How can I
prevent 'make test' from running some of the tests? </A>
<LI><A href="Faq.pod.1.html#Running_make_test_fails_with_a">Running
'make test' fails with an error message at loading of Embperl </A>
<LI><A href="Faq.pod.1.html#How_can_I_build_a_statically_lin">How can
I build a statically-linked copy of Embperl with mod_perl </A>
<LI><A href="Faq.pod.1.html#How_do_I_load_Embperl_at_server_">How do I
load Embperl at server startup?</A>
@@ -99,6 +100,21 @@
Try recompiling Perl and all modules -- this can sometimes make those
annoying error messages disappear!
+<P>
+<HR>
+<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_can_I_prevent_make_test_fr">How can I prevent 'make test' from running some
of the tests?</A></H2>
+<P>
+For example, I don't allow CGI scripts, so 'make test' fails at CGI. How do
+I run just the other tests?
+
+<P>
+Try:
+
+<P>
+<PRE> $ make test TESTARGS="--help"
+ # and for just offline and mod_perl:
+ $ make test TESTARGS="-hoe"
+</PRE>
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Running_make_test_fails_with_a">Running 'make test' fails with an error message
at loading of Embperl
1.17 +1 -0 modperl-site/embperl/Faq.pod.cont.html
Index: Faq.pod.cont.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.cont.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Faq.pod.cont.html 2000/08/25 05:31:59 1.16
+++ Faq.pod.cont.html 2000/10/18 07:34:06 1.17
@@ -40,6 +40,7 @@
<LI><A href="Faq.pod.1.html#I_m_getting_">I'm getting:</A>
<LI><A href="Faq.pod.1.html#I_m_trying_to_build_HTML_Embper">I'm
trying to build HTML::Embperl, and while running 'make' i get:</A>
<LI><A href="Faq.pod.1.html#I_have_a_lot_of_errors_in_make_">I have a
lot of errors in 'make test' from mod_perl when using Embperl</A>
+ <LI><A href="Faq.pod.1.html#How_can_I_prevent_make_test_fr">How can I
prevent 'make test' from running some of the tests? </A>
<LI><A href="Faq.pod.1.html#Running_make_test_fails_with_a">Running
'make test' fails with an error message at loading of Embperl </A>
<LI><A href="Faq.pod.1.html#How_can_I_build_a_statically_lin">How can
I build a statically-linked copy of Embperl with mod_perl </A>
<LI><A href="Faq.pod.1.html#How_do_I_load_Embperl_at_server_">How do I
load Embperl at server startup?</A>
1.17 +15 -0 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.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- INSTALL.pod.1.html 2000/08/25 05:32:00 1.16
+++ INSTALL.pod.1.html 2000/10/18 07:34:06 1.17
@@ -22,6 +22,7 @@
[<a href="" >HOME</a>] <br> <UL>
<LI><A href="INSTALL.pod.1.html#UNIX">UNIX</A>
+ <LI><A href="INSTALL.pod.1.html#Options_for_make_test">Options for
make test</A>
<LI><A href="INSTALL.pod.1.html#WIN_32">WIN 32</A>
<LI><A
href="INSTALL.pod.1.html#Further_Documentation_english_">Further Documentation
(english)</A>
<LI><A href="INSTALL.pod.1.html#Further_Documentation_german_">Further
Documentation (german)</A>
@@ -89,6 +90,20 @@
</UL>
<P>
If you have already successfully build and tested <CODE>mod_perl</CODE> all modules
will already be there.
+
+<P>
+<HR>
+<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Options_for_make_test">Options for make test</A></H2>
+<P>
+<CODE>make test</CODE> can take several options, with can be given with the
<CODE>TESTARGS</CODE>
+parameter:
+
+<P>
+<PRE> make test TESTARGS="--help"
+</PRE>
+<P>
+will show you a list of available option. Most of them you will never need,
+they are mainly nesseccary for debugging <EM>Embperl</EM> itself.
<P>
<HR>