richter 00/12/03 23:42:26
Modified: embperl Embperl.pod.11.html Embperl.pod.14.html
Embperl.pod.15.html Embperl.pod.2.html
Embperl.pod.3.html Embperl.pod.4.html
Embperl.pod.6.html Embperl.pod.7.html
EmbperlObject.pod.3.html Faq.pod.1.html
Faq.pod.2.html Faq.pod.3.html Faq.pod.4.html
Faq.pod.5.html Faq.pod.6.html Features.pod.1.html
INSTALL.pod.1.html Intro.pod.7.html Mail.pod.1.html
index.html
Log:
Embperl Webpages - Changes
Revision Changes Path
1.11 +7 -8 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.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Embperl.pod.11.html 2000/11/07 19:33:54 1.10
+++ Embperl.pod.11.html 2000/12/04 07:42:23 1.11
@@ -36,15 +36,14 @@
it takes the following steps.
<OL>
-<LI><STRONG><A NAME="Remove_anything_which_looks_like">Remove anything which looks
like an HTML tag</A></STRONG>
-<LI><STRONG><A NAME="Translate_HTML_escapes_to_their_">Translate HTML escapes to
their corresponding ASCII characters</A></STRONG>
-<LI><STRONG><A NAME="Remove_all_carriage_returns">Remove all carriage
returns</A></STRONG>
-<LI><STRONG><A NAME="Eval_the_Perl_code_into_a_subrou">Eval the Perl code into a
subroutine</A></STRONG>
-<LI><STRONG><A NAME="Call_the_subroutine">Call the subroutine</A></STRONG>
-<LI><STRONG><A NAME="Escape_special_characters_in_the">Escape special characters in
the return value</A></STRONG>
-<LI><STRONG><A NAME="Send_the_return_value_as_output_">Send the return value as
output to the destination (browser or file)</A></STRONG>
+<br> <LI><STRONG><A NAME="Remove_anything_which_looks_like">Remove anything
which looks like an HTML tag</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Translate_HTML_escapes_to_their_">Translate HTML
escapes to their corresponding ASCII characters</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Remove_all_carriage_returns">Remove all carriage
returns</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Eval_the_Perl_code_into_a_subrou">Eval the Perl code
into a subroutine</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Call_the_subroutine">Call the
subroutine</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Escape_special_characters_in_the">Escape special
characters in the return value</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Send_the_return_value_as_output_">Send the return
value as output to the destination (browser or file)</A></STRONG><br>
</OL>
-<P>
Steps 1-4 take place only the first time the Perl code is encountered.
Embperl stores the eval'ed subroutine, so all subsequent requests only need
to execute steps 5-7.
1.17 +29 -30 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.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Embperl.pod.14.html 2000/12/04 05:40:39 1.16
+++ Embperl.pod.14.html 2000/12/04 07:42:23 1.17
@@ -33,48 +33,47 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="on_Linux_2_x_with">on Linux 2.x with</A></H2>
<DL>
-<DT><STRONG><A NAME="perl5">perl5.004_04</A></STRONG><DD>
-<DT><STRONG><A NAME="perl5">perl5.005_03</A></STRONG><DD>
-<DT><STRONG><A NAME="perl5">perl5.6.0</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.2.5</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.2.6</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.0</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.1</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.2</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.3</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.4</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.5</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.6</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.9</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.12</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_1">apache_1.3.14</A></STRONG><DD>
-<DT><STRONG><A NAME="apache_ssl">apache_ssl (Ben SSL)</A></STRONG><DD>
-<DT><STRONG><A NAME="Stronghold">Stronghold 2.2</A></STRONG><DD>
-<DT><STRONG>Stronghold 2.4.1</STRONG><DD>
-<DT><STRONG><A NAME="Apache_1">Apache_1.3.3 with mod_ssl 2.0.13</A></STRONG><DD>
-<DT><STRONG><A NAME="Apache_1">Apache_1.3.6 with mod_ssl 2.3.5</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.004_04</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.005_03</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.6.0</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.2.5</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.2.6</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.0</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.1</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.2</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.3</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.4</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.5</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.6</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.9</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.12</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_1">apache_1.3.14</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="apache_ssl">apache_ssl (Ben SSL)</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Stronghold">Stronghold 2.2</A></STRONG><DD>
+<br> <DT><STRONG>Stronghold 2.4.1</STRONG><DD>
+<br> <DT><STRONG><A NAME="Apache_1">Apache_1.3.3 with mod_ssl
2.0.13</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Apache_1">Apache_1.3.6 with mod_ssl
2.3.5</A></STRONG><DD>
</DL>
-<P>
I know from other people that it works on many other UNIX systems
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="on_Windows_NT_4_0_with">on Windows NT 4.0 with</A></H2>
<DL>
-<DT><STRONG>perl5.004_04</STRONG><DD>
-<DT><STRONG><A NAME="perl5">perl5.005</A></STRONG><DD>
-<DT><STRONG>perl5.6.0</STRONG><DD>
-<DT><STRONG>apache_1.3.1</STRONG><DD>
-<DT><STRONG>apache_1.3.6</STRONG><DD>
-<DT><STRONG>apache_1.3.9</STRONG><DD>
-<DT><STRONG>apache_1.3.12</STRONG><DD>
+<br> <DT><STRONG>perl5.004_04</STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.005</A></STRONG><DD>
+<br> <DT><STRONG>perl5.6.0</STRONG><DD>
+<br> <DT><STRONG>apache_1.3.1</STRONG><DD>
+<br> <DT><STRONG>apache_1.3.6</STRONG><DD>
+<br> <DT><STRONG>apache_1.3.9</STRONG><DD>
+<br> <DT><STRONG>apache_1.3.12</STRONG><DD>
</DL>
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="on_Windows_95_98_with">on Windows 95/98 with</A></H2>
<DL>
-<DT><STRONG><A NAME="perl5">perl5.004_02 (binary distribution, only Offline
Mode)</A></STRONG><DD>
-<DT><STRONG><A NAME="perl5">perl5.005_02 + apache_1.3.6</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.004_02 (binary distribution, only
Offline Mode)</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="perl5">perl5.005_02 + apache_1.3.6</A></STRONG><DD>
</DL>
<p>[<a href="" >HOME</a>] [<a
href="Embperl.pod.cont.html">CONTENT</a>] [<a
href="Embperl.pod.13.html">PREV (Bugs)</a>] [<a
href="Embperl.pod.15.html">NEXT (Support)</a>] <br>
<font
color="#808080">___________________________________________________________________________________<br>
1.16 +7 -11 modperl-site/embperl/Embperl.pod.15.html
Index: Embperl.pod.15.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Embperl.pod.15.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- Embperl.pod.15.html 2000/12/04 05:40:39 1.15
+++ Embperl.pod.15.html 2000/12/04 07:42:23 1.16
@@ -28,7 +28,6 @@
<hr>
<P>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Feedback_and_Bug_Reports">Feedback and Bug Reports</A></H2>
-<P>
Please let me know if you use or test this module. Bugs, questions,
suggestions for things you would find useful, etc., are discussed on the
Embperl mailing list. If you have a site that is using Embperl, I would
@@ -66,13 +65,12 @@
need commercial support, ecos can provide it for you. We offer:
<UL>
-<LI><STRONG><A NAME="Consulting">Consulting and assitance for you and your
programmers</A></STRONG>
-<LI><STRONG><A NAME="Planning">Planning of your dynamic website</A></STRONG>
-<LI><STRONG><A NAME="Creating">Creating of parts or a whole website</A></STRONG>
-<LI><STRONG><A NAME="Fixing">Fixing bugs in Embperl (also available for
mod_perl)</A></STRONG>
-<LI><STRONG><A NAME="Adding">Adding new features</A></STRONG>
+<br> <LI><STRONG><A NAME="Consulting">Consulting and assitance for you and
your programmers</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Planning">Planning of your dynamic
website</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Creating">Creating of parts or a whole
website</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Fixing">Fixing bugs in Embperl (also available for
mod_perl)</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Adding">Adding new features</A></STRONG><br>
</UL>
-<P>
You can reach us via <A HREF="http://www.ecos.de">http://www.ecos.de</A> or
<A HREF="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</A> For more information about
our support see
@@ -90,12 +88,10 @@
you have two possibilities:
<OL>
-<LI>
-<P>
+<br> <LI>
Send me patches for things you like to see in Embperl
-<LI>
-<P>
+<br> <LI>
Buy commercial support (see above). Also you <STRONG>may</STRONG> get the same
answers to your questions on the mailing list, by buying the
commercial support you not only buy support for yourself and can be sure
you get an answer, you also give us the possibility to put more power in
1.24 +38 -76 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.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- Embperl.pod.2.html 2000/11/07 19:33:54 1.23
+++ Embperl.pod.2.html 2000/12/04 07:42:23 1.24
@@ -55,29 +55,24 @@
Use embpexec.pl on Unix systems and embpexec.bat on Win32 systems.
<DL>
-<DT><STRONG><A NAME="htmlfile">htmlfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="htmlfile">htmlfile</A></STRONG><DD>
The full pathname of the HTML file which should be processed by Embperl.
-<DT><STRONG><A NAME="query_string">query_string</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="query_string">query_string</A></STRONG><DD>
Optional. Has the same meaning as the environment variable QUERY_STRING
when invoked as a CGI script. That is, QUERY_STRING contains everything
following the first ``?'' in a URL. <query_string> should be
URL-encoded. The default is no query string.
-<DT><STRONG><A NAME="_o">-o outputfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_o">-o outputfile</A></STRONG><DD>
Optional. Gives the filename to which the output is written. The default is
stdout.
-<DT><STRONG><A NAME="_l">-l logfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_l">-l logfile</A></STRONG><DD>
Optional. Gives the filename of the logfile. The default is
/tmp/embperl.log.
-<DT><STRONG><A NAME="_d">-d debugflags</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_d">-d debugflags</A></STRONG><DD>
Optional. Specifies the level of debugging (what is written to the log
file). The default is nothing. See <A
href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> for exact values.
@@ -232,39 +227,32 @@
The possible items for hash of the long form are:
<DL>
-<DT><STRONG><A NAME="inputfile">inputfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="inputfile">inputfile</A></STRONG><DD>
The file which should be used as source. If <STRONG>input</STRONG> is also
specified, this parameter should be given a unique name to identify
the source. Every time Embperl sees the same text in <STRONG>inputfile</STRONG>, it
assumes that you compiled the same source - that means that Embperl
uses the same package name as in your last call, and only recompiles the
code if <STRONG>mtime</STRONG> has changed or is undefined.
-<DT><STRONG><A NAME="sub">sub</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="sub">sub</A></STRONG><DD>
Call the Embperl subroutine named by this <CODE>parameter(see</CODE> also
<STRONG>"[$ sub $]"</STRONG>). Currently the subroutine must be in the same file or if
it's in another
file, the other file has to be imported first.
-<DT><STRONG><A NAME="input">input</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="input">input</A></STRONG><DD>
Reference to a string which contains the source. <STRONG>inputfile</STRONG> must
also be specified to give a name for the source. The name can be any
text.
-<DT><STRONG><A NAME="mtime">mtime</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="mtime">mtime</A></STRONG><DD>
Last modification time of member <STRONG>input</STRONG>. If undef the code passed
by input is always recompiled, else the code is
only recompiled if mtime changes.
-<DT><STRONG><A NAME="outputfile">outputfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="outputfile">outputfile</A></STRONG><DD>
File to which the output should be written. If neither outputfile nor
output is specified, ouput is written to stdout.
-<DT><STRONG><A NAME="output">output</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="output">output</A></STRONG><DD>
Reference to a scalar where the output should be written to.
-<DT><STRONG><A NAME="import">import</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="import">import</A></STRONG><DD>
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>
@@ -278,26 +266,22 @@
<P>
See <STRONG>[$ sub $]</STRONG> metacommand and section about subroutines for more
info.
-<DT><STRONG><A NAME="req_rec">req_rec</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="req_rec">req_rec</A></STRONG><DD>
NOTE: The req_rec parameter isn't necessary anymore in versions >= 1.2b2
<P>
If used under mod_perl, you should set the req_rec parameter to the Apache
request record object provided by mod_perl.
-<DT><STRONG><A NAME="cleanup">cleanup</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="cleanup">cleanup</A></STRONG><DD>
This value specifies if and when the cleanup of the package should be
executed. (See <A href="Embperl.pod.5.html#Variable_scope_and_cleanup">Variable
scope and cleanup</A> below for more information on cleanup)
<DL>
-<DT><STRONG>cleanup = -1</STRONG><DD>
-<P>
+<br> <DT><STRONG>cleanup = -1</STRONG><DD>
Never cleanup the variables
-<DT><STRONG>cleanup = 0 or not specified</STRONG><DD>
-<P>
+<br> <DT><STRONG>cleanup = 0 or not specified</STRONG><DD>
If running under mod_perl, cleanup is delayed until the connection to the
client is closed, so it does not lengthen the response time to the client.
If the Execute function is called more the once before the end of the
@@ -307,13 +291,11 @@
<P>
If running as a CGI or offline, cleanup takes place immediately.
-<DT><STRONG>cleanup = 1</STRONG><DD>
-<P>
+<br> <DT><STRONG>cleanup = 1</STRONG><DD>
Immediate cleanup
</DL>
-<DT><STRONG><A NAME="param">param</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="param">param</A></STRONG><DD>
Can be used to pass parameters to the Embperl document and back. Must
contain a reference to an array.
@@ -328,86 +310,68 @@
The array @param in the Embperl document is setup as an alias to the array. See
eg/x/Excute.pl for a more detailed example.
-<DT><STRONG><A NAME="ffld">ffld and fdat</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="ffld">ffld and fdat</A></STRONG><DD>
Could be used to setup the two Embperl predefined variables.
-<DT><STRONG><A NAME="firstline">firstline</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="firstline">firstline</A></STRONG><DD>
Specifies the first linenumber of the sourcefile (Default: 1)
-<DT><STRONG><A NAME="options">options</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="options">options</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_OPTIONS">EMBPERL_OPTIONS</A> (see
below), except for cleanup.
<P>
<STRONG>NOTE:</STRONG> You should set the <STRONG>optDisableFormData</STRONG> if
you have already read the form data from stdin while in a POST request.
Otherwise Execute will hang and try to read the data a second time.
-<DT><STRONG><A NAME="debug">debug</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="debug">debug</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_DEBUG">EMBPERL_DEBUG</A> (see below).
-<DT><STRONG><A NAME="escmode">escmode</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="escmode">escmode</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_ESCMODE">EMBPERL_ESCMODE</A> (see
below).
-<DT><STRONG><A NAME="package">package</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="package">package</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_PACKAGE">EMBPERL_PACKAGE</A> (see
below).
-<DT><STRONG><A NAME="virtlog">virtlog</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="virtlog">virtlog</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_VIRTLOG">EMBPERL_VIRTLOG</A> (see
below). If <STRONG>virtlog</STRONG> is equal to <STRONG>uri</STRONG> the logfile is
sent.
-<DT><STRONG><A NAME="allow">allow (1.2b10 and above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="allow">allow (1.2b10 and above)</A></STRONG><DD>
Same as <A
href="Embperl.pod.3.html#EMBPERL_ALLOW_only_1_2b10_and_a">"EMBPERL_ALLOW"</A> (see
below)
-<DT><STRONG><A NAME="path">path (1.3b1 and above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="path">path (1.3b1 and above)</A></STRONG><DD>
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>
+<br> <DT><STRONG><A NAME="uri">uri</A></STRONG><DD>
The URI of the request. Only needed for the virtlog feature.
-<DT><STRONG><A NAME="compartment">compartment</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="compartment">compartment</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_COMPARTMENT">EMBPERL_COMPARTMENT</A>
(see below).
-<DT><STRONG><A NAME="input_func">input_func</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="input_func">input_func</A></STRONG><DD>
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>
+<br> <DT><STRONG><A NAME="output_func">output_func</A></STRONG><DD>
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>
-<P>
+<br> <DT><STRONG><A NAME="cookie_name">cookie_name</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_COOKIE_NAME">EMBPERL_COOKIE_NAME</A>
(see below).
-<DT><STRONG><A NAME="cookie_path">cookie_path</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="cookie_path">cookie_path</A></STRONG><DD>
Same as <A href="Embperl.pod.3.html#EMBPERL_COOKIE_PATH">EMBPERL_COOKIE_PATH</A>
(see below).
-<DT><STRONG><A NAME="cookie_domain">cookie_domain</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="cookie_domain">cookie_domain</A></STRONG><DD>
Same as <A
href="Embperl.pod.3.html#EMBPERL_COOKIE_DOMAIN">EMBPERL_COOKIE_DOMAIN</A> (see below).
-<DT><STRONG><A NAME="cookie_expires">cookie_expires</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="cookie_expires">cookie_expires</A></STRONG><DD>
Same as <A
href="Embperl.pod.3.html#EMBPERL_COOKIE_EXPIRES">EMBPERL_COOKIE_EXPIRES</A> (see
below).
-<DT><STRONG><A NAME="errors">errors</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="errors">errors</A></STRONG><DD>
Takes a reference to an array. Upon return, the array will contain a copy
of all errormessages, if any.
@@ -416,8 +380,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Helper_functions_for_Execute">Helper functions for Execute</A></H2>
<DL>
-<DT><STRONG><A NAME="HTML">HTML::Embperl::Init ($Logfile,
$DebugDefault)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="HTML">HTML::Embperl::Init ($Logfile,
$DebugDefault)</A></STRONG><DD>
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>
@@ -427,8 +390,7 @@
<STRONG>NOTE:</STRONG> You do not need to call Init in version >= 0.27. The
initialization of
Embperl takes place automatically when it is loaded.
-<DT><STRONG><A NAME="HTML">HTML::Embperl::ScanEnvironment
(\%params)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="HTML">HTML::Embperl::ScanEnvironment
(\%params)</A></STRONG><DD>
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.
1.23 +47 -94 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.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- Embperl.pod.3.html 2000/12/04 05:40:39 1.22
+++ Embperl.pod.3.html 2000/12/04 07:42:23 1.23
@@ -149,12 +149,10 @@
specify multiple options, simply add the values together.
<DL>
-<DT><STRONG><A NAME="optDisableVarCleanup">optDisableVarCleanup = 1</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableVarCleanup">optDisableVarCleanup =
1</A></STRONG><DD>
Disables the automatic cleanup of variables at the end of each request.
-<DT><STRONG><A NAME="optDisableEmbperlErrorPage">optDisableEmbperlErrorPage =
2</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A
NAME="optDisableEmbperlErrorPage">optDisableEmbperlErrorPage = 2</A></STRONG><DD>
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
@@ -162,8 +160,7 @@
will be a link to the corresponding location in the log file. This option
has no effect if optReturnError is set.
-<DT><STRONG><A NAME="optReturnError">optReturnError = 262144</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optReturnError">optReturnError =
262144</A></STRONG><DD>
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>
@@ -176,20 +173,17 @@
<P>
where $errors</A> is a array reference. (1.3b5+)
-<DT><STRONG><A NAME="optSafeNamespace">optSafeNamespace = 4</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optSafeNamespace">optSafeNamespace =
4</A></STRONG><DD>
Tells Embperl to execute the embedded code in a safe namespace so the code
cannot access data or code in any other package. (See the chapter about <A
href="Embperl.pod.8.html#_Safe_Namespaces_and_opcode_res">(Safe-)Namespaces and opcode
restrictions</A> below for more details.)
-<DT><STRONG><A NAME="optOpcodeMask">optOpcodeMask = 8</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optOpcodeMask">optOpcodeMask = 8</A></STRONG><DD>
Tells Embperl to apply an operator mask. This gives you the chance to
disallow special (unsafe) opcodes. (See the Chapter about
<A href="Embperl.pod.8.html#_Safe_Namespaces_and_opcode_res">(Safe-)Namespaces and
opcode restrictions</A>
below for more details.)
-<DT><STRONG><A NAME="optRawInput">optRawInput = 16</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optRawInput">optRawInput = 16</A></STRONG><DD>
Causes Embperl not to pre-process the source for a Perl expression. (The
only exception is that carriage returns will be removed, as Perl does not
like them.) This option should be set when you are writing your code with
@@ -202,8 +196,7 @@
Embperl will automatically convert the HTML input back to the Perl
expressions as you wrote them.
-<DT><STRONG><A NAME="optEarlyHttpHeader">optEarlyHttpHeader = 64</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optEarlyHttpHeader">optEarlyHttpHeader =
64</A></STRONG><DD>
Normally, HTTP headers are sent after a request is finished without error.
This gives you the chance to set arbitrary HTTP headers within the page,
and gives Embperl the chance to calculate the content length. Also Embperl
@@ -213,87 +206,72 @@
the document. This flag will cause the HTTP headers to be sent before the
script is processed, and the script's output will be sent directly.
-<DT><STRONG><A NAME="optDisableChdir">optDisableChdir = 128</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableChdir">optDisableChdir =
128</A></STRONG><DD>
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>
+<br> <DT><STRONG><A NAME="optDisableFormData">optDisableFormData =
256</A></STRONG><DD>
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>
+<br> <DT><STRONG><A NAME="optDisableHtmlScan">optDisableHtmlScan =
512</A></STRONG><DD>
When set, this option disables the scanning of <STRONG>all</STRONG> html-tags.
Embperl will only look for [+/-/!/$ ... $/!/-/+]. This will
disable dynamic tables, processing of the input data and so on.
-<DT><STRONG><A NAME="optDisableInputScan">optDisableInputScan =
1024</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableInputScan">optDisableInputScan =
1024</A></STRONG><DD>
Disables processing of all input-related tags.
(<INPUT><TEXTAREA><OPTION>)
-<DT><STRONG><A NAME="optDisableTableScan">optDisableTableScan =
2048</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableTableScan">optDisableTableScan =
2048</A></STRONG><DD>
Disables processing of all table-related tags.
(<TABLE><TH><TR><TD><MENU><OL><UL>)
-<DT><STRONG><A NAME="optDisableSelectScan">optDisableSelectScan = 8388608
(0x800000) (only 1.3b7 and above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableSelectScan">optDisableSelectScan = 8388608
(0x800000) (only 1.3b7 and above)</A></STRONG><DD>
Disables processing of the SELECT tag. (<SELECT>)
-<DT><STRONG><A NAME="optDisableMetaScan">optDisableMetaScan = 4096</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optDisableMetaScan">optDisableMetaScan =
4096</A></STRONG><DD>
Disables processing of all meta tags. (<META HTTP-EQUIV>)
-<DT><STRONG><A NAME="optAllFormData">optAllFormData = 8192</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optAllFormData">optAllFormData =
8192</A></STRONG><DD>
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 be absent from
<CODE>%fdat</CODE> and @ffld.
-<DT><STRONG><A NAME="optRedirectStdout">optRedirectStdout = 16384</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optRedirectStdout">optRedirectStdout =
16384</A></STRONG><DD>
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 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>
+<br> <DT><STRONG><A NAME="optUndefToEmptyValue">optUndefToEmptyValue =
32768</A></STRONG><DD>
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.
-<DT><STRONG><A NAME="optNoHiddenEmptyValue">optNoHiddenEmptyValue = 65536 (only
1.2b2 and above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optNoHiddenEmptyValue">optNoHiddenEmptyValue = 65536
(only 1.2b2 and above)</A></STRONG><DD>
Normally, if there is a value defined in <CODE>%fdat</CODE> for a specific
input field, Embperl will output a hidden input element for it when you use
<STRONG>hidden</STRONG>. When this option is set, Embperl will not output a hidden
input element
for this field when the value is a blank string.
-<DT><STRONG><A NAME="optAllowZeroFilesize">optAllowZeroFilesize = 131072 (only
1.2b2 and above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optAllowZeroFilesize">optAllowZeroFilesize = 131072
(only 1.2b2 and above)</A></STRONG><DD>
Normaly Embperl reports NOT_FOUND (404) if a file of length zero is
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>
+<br> <DT><STRONG><A NAME="optKeepSrcInMemory">optKeepSrcInMemory = 524288
(only 1.2b5 and above)</A></STRONG><DD>
Tells Embperl to keep the source file in memory and not reload it on every
request. (The precompiled Perlcode is always kept in memory, regardless of
this flag)
-<DT><STRONG><A NAME="optKeepSpaces">optKeepSpaces = 1048576 (only 1.2b5 and above)
= 0x100000,</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="optKeepSpaces">optKeepSpaces = 1048576 (only 1.2b5
and above) = 0x100000,</A></STRONG><DD>
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>
+<br> <DT><STRONG><A NAME="optOpenLogEarly">optOpenLogEarly = 2097152 (only
1.2b5 and above)</A></STRONG><DD>
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.
@@ -312,67 +290,53 @@
values are defined:
<DL>
-<DT><STRONG><A NAME="dbgStd">dbgStd = 1</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgStd">dbgStd = 1</A></STRONG><DD>
Show minimum information.
-<DT><STRONG><A NAME="dbgMem">dbgMem = 2</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgMem">dbgMem = 2</A></STRONG><DD>
Show memory and scalar value allocation.
-<DT><STRONG><A NAME="dbgEval">dbgEval = 4</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgEval">dbgEval = 4</A></STRONG><DD>
Show arguments to and results of evals.
-<DT><STRONG><A NAME="dbgCmd">dbgCmd = 8</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgCmd">dbgCmd = 8</A></STRONG><DD>
Show metacommands and HTML tags which are processed.
-<DT><STRONG><A NAME="dbgEnv">dbgEnv = 16,</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgEnv">dbgEnv = 16,</A></STRONG><DD>
List every request's environment variables.
-<DT><STRONG><A NAME="dbgForm">dbgForm = 32</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgForm">dbgForm = 32</A></STRONG><DD>
List posted form data.
-<DT><STRONG><A NAME="dbgTab">dbgTab = 64</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgTab">dbgTab = 64</A></STRONG><DD>
Show processing of dynamic tables.
-<DT><STRONG><A NAME="dbgInput">dbgInput = 128</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgInput">dbgInput = 128</A></STRONG><DD>
Show processing of HTML input tags.
-<DT><STRONG><A NAME="dbgFlushOutput">dbgFlushOutput = 256</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgFlushOutput">dbgFlushOutput = 256</A></STRONG><DD>
Flush Embperl's output after every write. This should only be set to help
debug Embperl crashes, as it drastically slows down Embperl's operation.
-<DT><STRONG><A NAME="dbgFlushLog">dbgFlushLog = 512</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgFlushLog">dbgFlushLog = 512</A></STRONG><DD>
Flush Embperl's logfile output after every write. This should only be set
to help debug Embperl crashes, as it drastically slows down Embperl's
operation.
-<DT><STRONG><A NAME="dbgAllCmds">dbgAllCmds = 1024</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgAllCmds">dbgAllCmds = 1024</A></STRONG><DD>
Logs all commands and HTML tags, whether or not they are really excuted or
not. (It logs a `+' or `-' to tell you if they are executed.)
-<DT><STRONG><A NAME="dbgSource">dbgSource = 2048</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgSource">dbgSource = 2048</A></STRONG><DD>
Logs the next piece of the HTML source to be processed. (NOTE: This
generates a lot of output!)
-<DT><STRONG><A NAME="dbgFunc">dbgFunc = 4096</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgFunc">dbgFunc = 4096</A></STRONG><DD>
This is only anvailable when Embperl is compiled with -DEPDEBUGALL, and is
normally only used for debugging Embperl itself. Records all function
entries to the logfile.
-<DT><STRONG><A NAME="dbgLogLink">dbgLogLink = 8192</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgLogLink">dbgLogLink = 8192</A></STRONG><DD>
Inserts a link at the top of each page which can be used to view the log
for the current HTML file. See also <A
href="Embperl.pod.3.html#EMBPERL_VIRTLOG">EMBPERL_VIRTLOG</A>.
@@ -390,30 +354,24 @@
Options ExecCGI
</Location>
</PRE>
-<DT><STRONG><A NAME="dbgDefEval">dbgDefEval = 16384</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgDefEval">dbgDefEval = 16384</A></STRONG><DD>
Shows every time new Perl code is compiled.
-<DT><STRONG><A NAME="dbgHeadersIn">dbgHeadersIn = 262144</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgHeadersIn">dbgHeadersIn = 262144</A></STRONG><DD>
Log all HTTP headers which are sent from the browser.
-<DT><STRONG><A NAME="dbgShowCleanup">dbgShowCleanup = 524288</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgShowCleanup">dbgShowCleanup =
524288</A></STRONG><DD>
Show every variable which is undef'd at the end of the request. For scalar
variables, the value before undef'ing is logged.
-<DT><STRONG><A NAME="dbgProfile">dbgProfile = 1048576 (only 1.2b4 and
above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgProfile">dbgProfile = 1048576 (only 1.2b4 and
above)</A></STRONG><DD>
When set every source line in the log file will also display the time until
request was started. (<STRONG>dbgSource</STRONG> must also be set)
-<DT><STRONG><A NAME="dbgSession">dbgSession = 2097152 (only 1.2b4 and
above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgSession">dbgSession = 2097152 (only 1.2b4 and
above)</A></STRONG><DD>
Enables logging of session transactions.
-<DT><STRONG><A NAME="dbgImport">dbgImport = 4194304 (only 1.2b5 and
above)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="dbgImport">dbgImport = 4194304 (only 1.2b5 and
above)</A></STRONG><DD>
Show how subroutines are imported in other namespaces.
</DL>
@@ -436,12 +394,10 @@
<PRE> InputFunc ($r, $in, $cacheargs, additional parameters...) ;
</PRE>
<DL>
-<DT><STRONG><A NAME="_r">$r</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_r">$r</A></STRONG><DD>
Apache Request Record (see <STRONG>perldoc Apache</STRONG> for details)
-<DT><STRONG><A NAME="_in">$in</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_in">$in</A></STRONG><DD>
a reference to a scalar, to which the input should be returned.
<P>
@@ -453,8 +409,7 @@
$$in = <F> ;
close F ;
</PRE>
-<DT><STRONG><A NAME="_cacheargs">$cacheargs</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_cacheargs">$cacheargs</A></STRONG><DD>
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>
@@ -536,12 +491,10 @@
<PRE> OutputFunc ($r, $out, additional parameters...) ;
</PRE>
<DL>
-<DT><STRONG>$r</STRONG><DD>
-<P>
+<br> <DT><STRONG>$r</STRONG><DD>
Apache Request Record (see <STRONG>perldoc Apache</STRONG> for details)
-<DT><STRONG><A NAME="_out">$out</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_out">$out</A></STRONG><DD>
a reference to a scalar, which contains the output from Embperl
</DL>
1.14 +15 -30 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.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- Embperl.pod.4.html 2000/11/07 19:33:55 1.13
+++ Embperl.pod.4.html 2000/12/04 07:42:23 1.14
@@ -225,8 +225,7 @@
Execute an Embperl metacommand. <STRONG>Cmd</STRONG> can be one of the following.
(<STRONG>Arg</STRONG> varies depending on <Cmd>).
<DL>
-<DT><STRONG><A NAME="if">if, elsif, else, endif</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="if">if, elsif, else, endif</A></STRONG><DD>
Everything following the <STRONG>if</STRONG> metacommand until the
<STRONG>else</STRONG>,
<STRONG>elsif</STRONG>, or <STRONG>endif</STRONG> is only output if the Perl
expression given in
<STRONG>Arg</STRONG> is true. <STRONG>else</STRONG> and <STRONG>elsif</STRONG>
work similarly.
@@ -245,8 +244,7 @@
This will send one of the two sentences to the client, depending on the
request method used to retrieve the document.
-<DT><STRONG><A NAME="while">while, endwhile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="while">while, endwhile</A></STRONG><DD>
Executes a loop until the <STRONG>Arg</STRONG> given to <STRONG>while</STRONG> is
false.
<P>
@@ -266,8 +264,7 @@
NOTE: The `&lt;' is translated to `<' before calling Perl eval,
unless optRawInput is set.
-<DT><STRONG><A NAME="do">do, until</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="do">do, until</A></STRONG><DD>
Executes a loop until the <STRONG>Arg</STRONG> given to <STRONG>until</STRONG> is
true.
<P>
@@ -279,8 +276,7 @@
[+ $i++ +] <BR>
[$ until $i > 10 $]
</PRE>
-<DT><STRONG><A NAME="foreach">foreach, endforeach</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="foreach">foreach, endforeach</A></STRONG><DD>
Executes a loop for each element of the second <STRONG>Arg</STRONG>, setting the
first <STRONG>Arg</STRONG> accordingly.
<P>
@@ -292,8 +288,7 @@
[+ $v +] <BR>
[$ endforeach $]
</PRE>
-<DT><STRONG><A NAME="hidden">hidden</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="hidden">hidden</A></STRONG><DD>
<STRONG>Arg</STRONG> consists of zero, one or two names of hashes (with or without
the leading
%) and an optional array as third parameter. The
<STRONG>hidden</STRONG> metacommand will generate hidden fields for all data
contained in the first
@@ -346,8 +341,7 @@
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>
+<br> <DT><STRONG><A NAME="var">var</A></STRONG><DD>
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 a space-separated list.
@@ -365,8 +359,7 @@
NOTE 1: `use strict' within an Embperl document will only apply to the
block in which it occurs.
-<DT><STRONG><A NAME="sub">sub</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="sub">sub</A></STRONG><DD>
(Only Embperl 1.2b5 and above)
<P>
@@ -429,8 +422,7 @@
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>
-<P>
+<br> <DT><STRONG><A NAME="TABLE">TABLE, /TABLE, TR, /TR</A></STRONG><DD>
Embperl can generate dynamic tables (one- or two-dimensional). You only
need to specify one row or column.
@@ -479,24 +471,21 @@
the result in an array. You may provide as many columns as you need. It is
also possible to call a 'fetch' subroutine in each table row.
-<DT><STRONG><A NAME="TH">TH, /TH</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="TH">TH, /TH</A></STRONG><DD>
The <TH> tag is interpreted as a table heading. If the whole row is
made up of <TH> </TH> instead of <TD> </TD>, it is
treated as a column heading. Everything else will be treated as row
headings in the future, but are not now: everything else is ignored in the
current version.
-<DT><STRONG><A NAME="DIR">DIR, MENU, OL, UL, DL, SELECT, /DIR, /MENU,
+<br> <DT><STRONG><A NAME="DIR">DIR, MENU, OL, UL, DL, SELECT, /DIR, /MENU,
/OL, /UL, /DL, /SELECT</A></STRONG><DD>
-<P>
Lists and dropdowns or list boxes are treated exactly as one- dimensional
tables. Only $row</A>, $maxrow</A>, $col</A>, $maxcol</A> and $tabmode</A>
are honored. <CODE>$col</CODE> and <CODE>$maxcol</CODE> are ignored. See
eg/x/lists.htm for an example.
-<DT><STRONG><A NAME="OPTION">OPTION</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="OPTION">OPTION</A></STRONG><DD>
Embperl checks if there is a value from the form data for a specific option
in a menu. If so, this option will be pre-selected.
@@ -519,8 +508,7 @@
</SELECT></P>
</FORM>
</PRE>
-<DT><STRONG><A NAME="INPUT">INPUT</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="INPUT">INPUT</A></STRONG><DD>
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
@@ -533,12 +521,10 @@
itself, the form will be redisplayed with same values as entered the first
time. (See eg/x/neu.htm for an example.)
-<DT><STRONG><A NAME="TEXTAREA">TEXTAREA, /TEXTAREA</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="TEXTAREA">TEXTAREA, /TEXTAREA</A></STRONG><DD>
The <A href="Embperl.pod.4.html#item_TEXTAREA">TEXTAREA</A> tag is treated exactly
like other input fields.
-<DT><STRONG><A NAME="META">META HTTP-EQUIV=</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="META">META HTTP-EQUIV=</A></STRONG><DD>
<meta http-equiv= ... > will over-ride the corresponding http header.
This keeps Netscape from asking the user to reload the document when the
content-type differs between the http header and the meta http-equiv.
@@ -561,8 +547,7 @@
<P>
<PRE> [- $req_rec ->� header_out("Language" => "DE");
-]
</PRE>
-<DT><STRONG><A NAME="A">A, EMBED, IMG, IFRAME, FRAME, LAYER</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="A">A, EMBED, IMG, IFRAME, FRAME,
LAYER</A></STRONG><DD>
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 references to URL parameter syntax. Example:
1.22 +20 -31 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.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- Embperl.pod.6.html 2000/12/04 05:40:39 1.21
+++ Embperl.pod.6.html 2000/12/04 07:42:23 1.22
@@ -191,20 +191,17 @@
undefined. <CODE>$tabmode</CODE> operates as follows:
<DL>
-<DT><STRONG><A NAME="_tabmode">$tabmode = 1</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_tabmode">$tabmode = 1</A></STRONG><DD>
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 expressions are observed
which contain an access to
the variable $row.
-<DT><STRONG>$tabmode = 2</STRONG><DD>
-<P>
+<br> <DT><STRONG>$tabmode = 2</STRONG><DD>
End when an expression with <CODE>$row</CODE> becomes undefined. The row
containing the undefined expression <STRONG>is</STRONG> displayed.
-<DT><STRONG>$tabmode = 4</STRONG><DD>
-<P>
+<br> <DT><STRONG>$tabmode = 4</STRONG><DD>
End when <CODE>$maxrow</CODE> rows have been displayed.
</DL>
@@ -214,20 +211,17 @@
<DL>
-<DT><STRONG>$tabmode = 16</STRONG><DD>
-<P>
+<br> <DT><STRONG>$tabmode = 16</STRONG><DD>
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 expressions are
observed which contain an access to
the variable $col.
-<DT><STRONG>$tabmode = 32</STRONG><DD>
-<P>
+<br> <DT><STRONG>$tabmode = 32</STRONG><DD>
End when an expression with <CODE>$col</CODE> becomes undefined. The column
containing the undefined expression <STRONG>is</STRONG> displayed.
-<DT><STRONG>$tabmode = 64</STRONG><DD>
-<P>
+<br> <DT><STRONG>$tabmode = 64</STRONG><DD>
End when <CODE>$maxcol</CODE> columns have been displayed.
</DL>
@@ -256,24 +250,20 @@
1.3b6 and above)
<DL>
-<DT><STRONG><A NAME="_escmode">$escmode = 3 (or 7)</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_escmode">$escmode = 3 (or 7)</A></STRONG><DD>
The result of a Perl expression is HTML-escaped (e.g., `>' becomes
`&gt;') in normal text and URL-escaped (e.g., `&' becomes `%26')
within of <A href="Embperl.pod.4.html#item_A">A</A>, <CODE>EMBED</CODE>,
<CODE>IMG</CODE>, <CODE>IFRAME</CODE>, <CODE>FRAME</CODE> and <CODE>LAYER</CODE> tags.
-<DT><STRONG>$escmode = 2 (or 6)</STRONG><DD>
-<P>
+<br> <DT><STRONG>$escmode = 2 (or 6)</STRONG><DD>
The result of a Perl expression is always URL-escaped (e.g., `&'
becomes `%26').
-<DT><STRONG>$escmode = 1 (or 5)</STRONG><DD>
-<P>
+<br> <DT><STRONG>$escmode = 1 (or 5)</STRONG><DD>
The result of a Perl expression is always HTML-escaped (e.g., `>'
becomes `&gt;').
-<DT><STRONG>$escmode = 0</STRONG><DD>
-<P>
+<br> <DT><STRONG>$escmode = 0</STRONG><DD>
No escaping takes place.
</DL>
@@ -361,21 +351,20 @@
of such options must be done via the config-files. Read-only variables are:
<DL>
-<DT><STRONG><A NAME="_optDisableVarCleanup">$optDisableVarCleanup</A></STRONG><DD>
-<DT><STRONG><A NAME="_optSafeNamespace">$optSafeNamespace</A></STRONG><DD>
-<DT><STRONG><A NAME="_optOpcodeMask">$optOpcodeMask</A></STRONG><DD>
-<DT><STRONG><A NAME="_optDisableChdir">$optDisableChdir</A></STRONG><DD>
-<DT><STRONG><A NAME="_optEarlyHttpHeader">$optEarlyHttpHeader</A></STRONG><DD>
-<DT><STRONG><A NAME="_optDisableFormData">$optDisableFormData</A></STRONG><DD>
-<DT><STRONG><A NAME="_optAllFormData">$optAllFormData</A></STRONG><DD>
-<DT><STRONG><A NAME="_optRedirectStdout">$optRedirectStdout</A></STRONG><DD>
-<DT><STRONG><A NAME="_optAllowZeroFilesize">$optAllowZeroFilesize</A></STRONG><DD>
-<DT><STRONG><A NAME="_optKeepSrcInMemory">$optKeepSrcInMemory</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optDisableVarCleanup">$optDisableVarCleanup</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="_optSafeNamespace">$optSafeNamespace</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="_optOpcodeMask">$optOpcodeMask</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="_optDisableChdir">$optDisableChdir</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optEarlyHttpHeader">$optEarlyHttpHeader</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optDisableFormData">$optDisableFormData</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="_optAllFormData">$optAllFormData</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optRedirectStdout">$optRedirectStdout</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optAllowZeroFilesize">$optAllowZeroFilesize</A></STRONG><DD>
+<br> <DT><STRONG><A
NAME="_optKeepSrcInMemory">$optKeepSrcInMemory</A></STRONG><DD>
</DL>
<P>
<HR>
<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 additional variables you can add them
to the hash %CLEANUP, with the key set to the variable name and the value
1.16 +2 -4 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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- Embperl.pod.7.html 2000/12/04 05:40:39 1.15
+++ Embperl.pod.7.html 2000/12/04 07:42:23 1.16
@@ -113,12 +113,10 @@
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>
-<P>
+<br> <DT><STRONG><A NAME="_req_rec">$req_rec</A></STRONG><DD>
Apache request record when running under mod_perl, <CODE>undef</CODE> otherwise.
-<DT><STRONG><A NAME="_Inputfile">$Inputfile</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="_Inputfile">$Inputfile</A></STRONG><DD>
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>
1.6 +5 -10 modperl-site/embperl/EmbperlObject.pod.3.html
Index: EmbperlObject.pod.3.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/EmbperlObject.pod.3.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- EmbperlObject.pod.3.html 2000/08/25 05:31:56 1.5
+++ EmbperlObject.pod.3.html 2000/12/04 07:42:23 1.6
@@ -25,24 +25,19 @@
<CODE>HTML::EmbperlObject::Execute</CODE>. <CODE>Execute</CODE> takes a hashref as
argument, which can contains the same parameters as the
<CODE>HTML::Embperl::Execute</CODE> function. Additionaly you may specify the
following parameters:
<DL>
-<DT><STRONG><A NAME="object_base">object_base</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="object_base">object_base</A></STRONG><DD>
same as $ENV{EMBPERL_OBJECT_BASE}
-<DT><STRONG><A NAME="object_addpath">object_addpath</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="object_addpath">object_addpath</A></STRONG><DD>
same as $ENV{EMBPERL_OBJECT_ADDPATH}
-<DT><STRONG><A NAME="object_stopdir">object_stopdir</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="object_stopdir">object_stopdir</A></STRONG><DD>
same as $ENV{EMBPERL_OBJECT_STOPDIR}
-<DT><STRONG><A NAME="object_fallback">object_fallback</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="object_fallback">object_fallback</A></STRONG><DD>
same as $ENV{EMBPERL_OBJECT_FALLBACK}
-<DT><STRONG><A NAME="object_handler_class">object_handler_class</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A
NAME="object_handler_class">object_handler_class</A></STRONG><DD>
same as $ENV{EMBPERL_OBJECT_HANDLER_CLASS}
</DL>
1.16 +43 -62 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.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- Faq.pod.1.html 2000/10/18 07:34:06 1.15
+++ Faq.pod.1.html 2000/12/04 07:42:23 1.16
@@ -131,14 +131,12 @@
Try:
<OL>
-<LI><STRONG><A NAME="_make_clean">) make clean</A></STRONG>
-<LI><STRONG><A NAME="_perl_Makefile_PL">) perl Makefile.PL</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_make_clean">) make clean</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_perl_Makefile_PL">) perl
Makefile.PL</A></STRONG><br>
NOTE: answer _no_ to mod_perl support. (This is important!)
-<LI><STRONG><A NAME="_make_test">) make test</A></STRONG>
+<br> <LI><STRONG><A NAME="_make_test">) make test</A></STRONG><br>
</OL>
-<P>
If that works, it means that your installation of Embperl is OK, but is
having problems resolving symbols with Apache.
@@ -156,24 +154,20 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_can_I_build_a_statically_lin">How can I build a statically-linked copy of
Embperl with mod_perl
support?</A></H2>
<OL>
-<LI><STRONG><A NAME="_go_to_your_mod_perl_directory_">) go to your mod_perl
directory, change to src/modules/perl and edit the
-Makefile so that it contains the line</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_go_to_your_mod_perl_directory_">) go to your
mod_perl directory, change to src/modules/perl and edit the
+Makefile so that it contains the line</A></STRONG><br>
<PRE> #STATIC_EXTS = Apache Apache::Constants HTML::Embperl
</PRE>
-<LI><STRONG><A NAME="_add_a_definition_for_EPDIR_and">) add a definition for EPDIR
and change the ONJ= line so that it looks
-like this:</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_add_a_definition_for_EPDIR_and">) add a definition
for EPDIR and change the ONJ= line so that it looks
+like this:</A></STRONG><br>
EPDIR=/usr/msrc/embperl OBJS=$(PERLSRC:.c=.o) $(EPDIR)/Embperl.o
$(EPDIR)/epmain.o $(EPDIR)/epio.o (EP DIR)/epeval.o $(EPDIR)/epcmd.o
$(EPDIR)/epchar.o $(EPDIR)/eputil.o
-<LI><STRONG><A NAME="_go_to_the_mod_perl_directory_a">) go to the mod_perl
directory and run</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_go_to_the_mod_perl_directory_a">) go to the
mod_perl directory and run</A></STRONG><br>
<PRE> perl Makefile.PL
</PRE>
-<LI><STRONG><A NAME="_go_to_the_Embperl_directory_an">) go to the Embperl directory
and do</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_go_to_the_Embperl_directory_an">) go to the Embperl
directory and do</A></STRONG><br>
<PRE> make clean
perl Makefule.PL
make
@@ -181,8 +175,7 @@
<P>
(to compile in mod_perl support)
-<LI><STRONG><A NAME="_go_back_to_the_mod_perl_direct">) go back to the mod_perl
directory and remake Apache by typing</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_go_back_to_the_mod_perl_direct">) go back to the
mod_perl directory and remake Apache by typing</A></STRONG><br>
<PRE> make
</PRE>
<P>
@@ -196,22 +189,19 @@
But if you want to run Embperl tests and/or if you want to be able to use
Embperl in offline or ``vanilla'' CGI mode, we need to continue:
-<LI><STRONG><A NAME="_go_back_to_the_Embperl_directo">) go back to the Embperl
directory</A></STRONG>
-<LI><STRONG><A NAME="_backup_the_file_test_conf_conf">) backup the file
test/conf/config.pl</A></STRONG>
-<LI><STRONG><A NAME="_now_build_Embperl_again_but_w">) now build Embperl again but
_without_ mod_perl support</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_go_back_to_the_Embperl_directo">) go back to the
Embperl directory</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_backup_the_file_test_conf_conf">) backup the file
test/conf/config.pl</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_now_build_Embperl_again_but_w">) now build Embperl
again but _without_ mod_perl support</A></STRONG><br>
<PRE> make clean
perl Makefile.PL
make
</PRE>
-<LI><STRONG><A NAME="_restore_your_saved_config_pl_t">) restore your saved
config.pl to test/conf/config.pl</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_restore_your_saved_config_pl_t">) restore your
saved config.pl to test/conf/config.pl</A></STRONG><br>
(without this step, only the offline mode would be tested)
-<LI><STRONG><A NAME="_run_make_test_for_Embperl">) run 'make test' for
Embperl</A></STRONG>
-<LI><STRONG><A NAME="_do_make_install_for_Embperl">) do 'make install' for
Embperl</A></STRONG>
+<br> <LI><STRONG><A NAME="_run_make_test_for_Embperl">) run 'make test' for
Embperl</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_do_make_install_for_Embperl">) do 'make install'
for Embperl</A></STRONG><br>
</OL>
-<P>
NOTE: You should do it in this order, or it may not work.
<P>
@@ -225,12 +215,10 @@
You can load Embperl at server startup by PerlModule or in a startup.pl:
<OL>
-<LI><STRONG><A NAME="_edit_your_srm_conf_file_to_rea">) edit your srm.conf file to
read:</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_edit_your_srm_conf_file_to_rea">) edit your
srm.conf file to read:</A></STRONG><br>
<PRE> PerlModule HTML::Embperl
</PRE>
-<LI><STRONG><A NAME="_edit_your_startup_pl_file_to_r">) edit your startup.pl file
to read:</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_edit_your_startup_pl_file_to_r">) edit your
startup.pl file to read:</A></STRONG><br>
<PRE> use HTML::Embperl
</PRE>
</OL>
@@ -270,12 +258,11 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_do_I_build_Embperl_with_debu">How do I build Embperl with debugging
informations</A></H2>
<DL>
-<DT><STRONG><A NAME="edit">edit the Makefile</A></STRONG><DD>
-<DT><STRONG><A NAME="search">search for the line starting with 'CC = ' add the -g
switch to the end of the line</A></STRONG><DD>
-<DT><STRONG>search for the line starting with 'LDDFLAGS = ' add the -g switch to
the end of the line</STRONG><DD>
-<DT><STRONG><A NAME="type">type make to build Embperl with debugging
infomation</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="edit">edit the Makefile</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="search">search for the line starting with 'CC = '
add the -g switch to the end of the line</A></STRONG><DD>
+<br> <DT><STRONG>search for the line starting with 'LDDFLAGS = ' add the -g
switch to the end of the line</STRONG><DD>
+<br> <DT><STRONG><A NAME="type">type make to build Embperl with debugging
infomation</A></STRONG><DD>
</DL>
-<P>
now start the gdb as decribed before.
<P>
@@ -301,8 +288,7 @@
I done following:
<OL>
-<LI><STRONG><A NAME="_">)</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_">)</A></STRONG><br>
I made HTML-Embperl-1.1.1 with no mod_perl support ( when I builded it with
mod_perl 1.18 I can`t link it because it don`t finds ap_XXX functions. When
I manually insert src/main/libmain.a from Apache 1.3.4 I got message
@@ -310,19 +296,16 @@
). Then I ``make test'' - all tests was O`k. After this I ``make clean'',
``perl Makefile.pl'' with mod_perl support and ``make install''
-<LI><STRONG>)</STRONG>
-<P>
+<br> <LI><STRONG>)</STRONG><br>
I installed mod_perl and ``perl Makefile.PL'', then ``make''
-<LI><STRONG>)</STRONG>
-<P>
+<br> <LI><STRONG>)</STRONG><br>
because I have`nt dynamical loading ( very old and buggy OS ) I had to
manually change src/modules/perl/perlxsi.c to insert bootstraps function`s
and it`s invocations and also /src/Makefile to manually insert libXXX.a
libraries
-<DT><STRONG><A NAME="In">In access.conf I insert code:</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="In">In access.conf I insert code:</A></STRONG><DD>
<PRE> PerlModule HTML::Embperl
<Directory /my_dir>
SetHandler perl-script
@@ -381,30 +364,28 @@
<STRONG>Requirements</STRONG>:
<UL>
-<LI><STRONG><A NAME="At">At least Perl 5.004_04</A></STRONG>
-<LI><STRONG><A NAME="cc">cc or gcc (your isp must give you access to the gcc
compiler)</A></STRONG>
-<LI><STRONG><A NAME="URI">URI</A></STRONG>
-<LI><STRONG><A NAME="MIME">MIME::Base64</A></STRONG>
-<LI><STRONG><A NAME="HTML">HTML::Parser</A></STRONG>
-<LI><STRONG><A NAME="HTML">HTML::HeadParser</A></STRONG>
-<LI><STRONG><A NAME="Digest">Digest::MD5</A></STRONG>
-<LI><STRONG><A NAME="libnet">libnet</A></STRONG>
-<LI><STRONG><A NAME="libwww">libwww</A></STRONG>
-<LI><STRONG><A NAME="File">File::Spec (I believe you may have to install this too
if you are using Perl 5.004_04 as it may not be a standard module)</A></STRONG>
+<br> <LI><STRONG><A NAME="At">At least Perl 5.004_04</A></STRONG><br>
+<br> <LI><STRONG><A NAME="cc">cc or gcc (your isp must give you access to the
gcc compiler)</A></STRONG><br>
+<br> <LI><STRONG><A NAME="URI">URI</A></STRONG><br>
+<br> <LI><STRONG><A NAME="MIME">MIME::Base64</A></STRONG><br>
+<br> <LI><STRONG><A NAME="HTML">HTML::Parser</A></STRONG><br>
+<br> <LI><STRONG><A NAME="HTML">HTML::HeadParser</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Digest">Digest::MD5</A></STRONG><br>
+<br> <LI><STRONG><A NAME="libnet">libnet</A></STRONG><br>
+<br> <LI><STRONG><A NAME="libwww">libwww</A></STRONG><br>
+<br> <LI><STRONG><A NAME="File">File::Spec (I believe you may have to install
this too if you are using Perl 5.004_04 as it may not be a standard
module)</A></STRONG><br>
</UL>
-<P>
<STRONG>Direction</STRONG>:
<UL>
-<LI><STRONG><A NAME="Get">Get your copy of EmbPerl
(HTML-Embperl-x.x.tar.gz)</A></STRONG>
-<LI><STRONG><A NAME="_tar_xvzf_HTML_Embperl_x_x_tar">% tar -xvzf
HTML-Embperl-x.x.tar.gz</A></STRONG>
-<LI><STRONG><A NAME="_cd_HTML_Embperl_x_x">% cd HTML-Embperl-x.x</A></STRONG>
-<LI><STRONG><A NAME="_perl_Makefile_PL_PREFIX_to_yo">% perl Makefile.PL
PREFIX=/to/your/private/dir</A></STRONG>
-<LI><STRONG><A NAME="_make">% make</A></STRONG>
-<LI><STRONG><A NAME="_make_test">% make test</A></STRONG>
-<LI><STRONG><A NAME="_make_install">% make install</A></STRONG>
+<br> <LI><STRONG><A NAME="Get">Get your copy of EmbPerl
(HTML-Embperl-x.x.tar.gz)</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_tar_xvzf_HTML_Embperl_x_x_tar">% tar -xvzf
HTML-Embperl-x.x.tar.gz</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_cd_HTML_Embperl_x_x">% cd
HTML-Embperl-x.x</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_perl_Makefile_PL_PREFIX_to_yo">% perl Makefile.PL
PREFIX=/to/your/private/dir</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_make">% make</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_make_test">% make test</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_make_install">% make install</A></STRONG><br>
</UL>
-<P>
Replace /to/your/private/dir with the path to the directory you want the
module to be placed in. Now preface your CGI scripts with something like
this:
1.15 +7 -10 modperl-site/embperl/Faq.pod.2.html
Index: Faq.pod.2.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.2.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- Faq.pod.2.html 2000/12/04 05:40:39 1.14
+++ Faq.pod.2.html 2000/12/04 07:42:23 1.15
@@ -114,18 +114,17 @@
So what can we do?
<UL>
-<LI><STRONG><A NAME="If">If a module change, simply restart Apache. That's works
always.</A></STRONG>
-<LI><STRONG><A NAME="Use">Use Apache::StatInc. This will do a stat on every loaded
module and compare
+<br> <LI><STRONG><A NAME="If">If a module change, simply restart Apache.
That's works always.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Use">Use Apache::StatInc. This will do a stat on
every loaded module and compare
the modification time. If the source has changed the module is reloaded. This
works most times (but not all modules can be cleanly reloaded) and as the number
of loaded modules increase, your sever will slow down, because of the stat it
-has to do for every module.</A></STRONG>
-<LI><STRONG><A NAME="Use">Use do instead of require. do will execute your file
everytime
+has to do for every module.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Use">Use do instead of require. do will execute your
file everytime
it is used. This also adds overhead, but this may be accpetable for small files
or in a debugging environement. (NOTE: Be sure to check $@ after a do,
-because do works like eval)</A></STRONG>
+because do works like eval)</A></STRONG><br>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Why_doesn_t_the_following_line_w">Why doesn't the following line work?</A></H2>
-<P>
<PRE> [+ $var . "<b>". $foo . "</b>". $bar +]
</PRE>
<P>
@@ -256,8 +255,7 @@
problem:
<OL>
-<LI><STRONG><A NAME="Set_optDisableTableScan">Set optDisableTableScan</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="Set_optDisableTableScan">Set
optDisableTableScan</A></STRONG><br>
This will avoid that Embperl takes any action on tables. You can
disable/enable this (also multiple times) inside the page with
@@ -268,8 +266,7 @@
If you put this at the top of your header/footer which you include with
Execute, then the main page will still process dynamic tables.
-<LI><STRONG><A NAME="Add_a_table_as_comment">Add a <table> as
comment</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="Add_a_table_as_comment">Add a <table> as
comment</A></STRONG><br>
Add the following to the top of the footer document:
<P>
1.17 +19 -25 modperl-site/embperl/Faq.pod.3.html
Index: Faq.pod.3.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.3.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Faq.pod.3.html 2000/08/25 05:31:57 1.16
+++ Faq.pod.3.html 2000/12/04 07:42:23 1.17
@@ -58,22 +58,21 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="I_have_an_HTML_page_which_is_dyn">I have an HTML page which is dynamically
generated at runtime
and should be post-processed by Embperl. How can I do this?</A></H2>
<OL>
-<LI><STRONG><A NAME="_Generate_the_page_within_a_nor">) Generate the page within a
normal CGI/Apache::Registry script and
+<br> <LI><STRONG><A NAME="_Generate_the_page_within_a_nor">) Generate the page
within a normal CGI/Apache::Registry script and
put the result into a scalar - then you can call HTML::Embperl::Execute to
post-process your document. Execute can either send the document to the
-browser or put it into another scalar for further processing.</A></STRONG>
-<LI><STRONG><A NAME="_Use_EMBPERL_INPUT_FUNC_1_1b1_">) Use EMBPERL_INPUT_FUNC
(1.1b1 and above). With this configuration
+browser or put it into another scalar for further processing.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_Use_EMBPERL_INPUT_FUNC_1_1b1_">) Use
EMBPERL_INPUT_FUNC (1.1b1 and above). With this configuration
directive, you can specify a custom input function which reads the
HTML source from the disk or even from a database. Embperl also
provides the function ProxyInput, which allows you to get input from
-another web server altogether.</A></STRONG>
-<LI><STRONG><A NAME="_Look_at_the_module_Apache_Emb">) Look at the module
Apache::EmbperlChain, which is able to chain
-multiple modules, including Embperl, together.</A></STRONG>
+another web server altogether.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_Look_at_the_module_Apache_Emb">) Look at the module
Apache::EmbperlChain, which is able to chain
+multiple modules, including Embperl, together.</A></STRONG><br>
</OL>
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_can_I_customise_the_header_t">How can I customise the header that Embperl is
sending?</A></H2>
-<P>
You can write it as
<P>
@@ -106,16 +105,13 @@
Example Code:
<OL>
-<LI><STRONG><A NAME="_in_documents_add">) in documents, add</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_in_documents_add">) in documents,
add</A></STRONG><br>
<PRE> <META HTTP-EQUIV="Set-Cookie" CONTENT="[+ $cookie +] =
[+ $value +]">
</PRE>
-<LI><STRONG><A NAME="_or_use_http_headers_out">) or use
%http_headers_out</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_or_use_http_headers_out">) or use
%http_headers_out</A></STRONG><br>
<PRE> [- $http_headers_out{'Set-Cookie'} = "$cookie=$value" -]
</PRE>
-<LI><STRONG><A NAME="_or_using_mod_perl_s_function">) or - using mod_perl's
functionality - use</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_or_using_mod_perl_s_function">) or - using
mod_perl's functionality - use</A></STRONG><br>
<PRE> [- $req_rec -> header_out("Set-Cookie" =>
"$cookie=$value"); -]
</PRE>
</OL>
@@ -168,15 +164,14 @@
Here are some ideas:
<OL>
-<LI><STRONG><A NAME="_You_could_include_an_IMG_tag_w">) You could include an IMG
tag which points to your cgi-bin, where
-a regular CGI script serves the graphics.</A></STRONG>
-<LI><STRONG><A NAME="_You_could_be_running_Apache_R">) You could be running
Apache::Registry, which can generate
+<br> <LI><STRONG><A NAME="_You_could_include_an_IMG_tag_w">) You could include
an IMG tag which points to your cgi-bin, where
+a regular CGI script serves the graphics.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_You_could_be_running_Apache_R">) You could be
running Apache::Registry, which can generate
on-the-fly GIFs using GD. (This is just the same as if you were including
the GD image from a static page or from another CGI script, but it allows
all of the appropriate logic to live in a single document, which might be
-appropriate for some Embperl users).</A></STRONG>
+appropriate for some Embperl users).</A></STRONG><br>
</OL>
-<P>
If you think of another way, or come up with some sample code, I'd love to
hear from you, so that I could add it to the FAQ...
@@ -270,21 +265,20 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Why_are_Perl_blocks_broken_up_in">Why are Perl blocks broken up into single
subroutines?</A></H2>
<OL>
-<LI><STRONG><A NAME="_It_makes_it_easier_to_process_">) It makes it easier to
process the HTML tags between the Perl blocks -
-this gives you more control over what's happening</A></STRONG>
-<LI><STRONG><A NAME="_If_you_compiled_everything_t">) If you compiled _everything_
to Perl, you would hold all of the
+<br> <LI><STRONG><A NAME="_It_makes_it_easier_to_process_">) It makes it
easier to process the HTML tags between the Perl blocks -
+this gives you more control over what's happening</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_If_you_compiled_everything_t">) If you compiled
_everything_ to Perl, you would hold all of the
HTML text in memory, and your Apache child processes would grow and
grow... But often-accessed documents are still held in memory by
-your os disk cache, which is much more memory-efficient.</A></STRONG>
-<LI><STRONG><A NAME="_There_is_only_so_far_that_you_">) There is only so far that
you can go with precompiling until you reach
+your os disk cache, which is much more memory-efficient.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_There_is_only_so_far_that_you_">) There is only so
far that you can go with precompiling until you reach
the point of diminishing returns. My guess is that converting dynamic
tables and other HTML processing to Perl at this point in Embperl's
-development would actually slow down operation.</A></STRONG>
+development would actually slow down operation.</A></STRONG><br>
</OL>
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Can_I_pass_QUERY_STRING_informat">Can I pass QUERY_STRING information to an
HTML::Embperl::Execute call?</A></H2>
-<P>
With Embperl 1.0 and higher, you can do this. QUERY_STRING is set as
$ENV{QUERY_STRING} by default. Alternatively, you can use the fdat
parameter to pass values to %fdat.
1.14 +8 -11 modperl-site/embperl/Faq.pod.4.html
Index: Faq.pod.4.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.4.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- Faq.pod.4.html 2000/08/25 05:31:57 1.13
+++ Faq.pod.4.html 2000/12/04 07:42:24 1.14
@@ -68,8 +68,7 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Ways_To_Escape_Input_">Ways To Escape Input:</A></H2>
<OL>
-<LI><STRONG><A NAME="Escape_it_H1_">Escape it -> \<H1></A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="Escape_it_H1_">Escape it ->
\<H1></A></STRONG><br>
NOTE: Inside double quotes you will need to use \\ (double backslash),
since Perl will remove the first Escape itself.
@@ -77,12 +76,11 @@
Example: In most cases '\<tr>' but inside double-quotes
``\\<tr>''
-<LI><STRONG><A NAME="Turn_off_Escaping_for_all_input_">Turn off Escaping for all
input by setting the optRawInput in
-EMBPERL_OPTIONS</A></STRONG>
-<LI><STRONG><A NAME="Learn_to_avoid_using_HTML_tags_i">Learn to avoid using HTML
tags inside Perl code. Once you get the hang
-of it, you'll love it.</A></STRONG>
+<br> <LI><STRONG><A NAME="Turn_off_Escaping_for_all_input_">Turn off Escaping
for all input by setting the optRawInput in
+EMBPERL_OPTIONS</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Learn_to_avoid_using_HTML_tags_i">Learn to avoid
using HTML tags inside Perl code. Once you get the hang
+of it, you'll love it.</A></STRONG><br>
</OL>
-<P>
Here is one example of how to do it:
<P>
@@ -197,13 +195,12 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Ways_To_Escape_Output_">Ways To Escape Output:</A></H2>
<OL>
-<LI><STRONG><A NAME="_Escape_it_H1_">) Escape it -> \\<H1></A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_Escape_it_H1_">) Escape it ->
\\<H1></A></STRONG><br>
<PRE> (You need a double backslash \\, because
the first one is removed by Perl and the second by Embperl.
</PRE>
-<LI><STRONG><A NAME="_set_escmode_0_escmod">) set $escmode = 0 -> [- $escmode =
0 ; -]</A></STRONG>
-<LI><STRONG><A NAME="_set_SetEnv_EMBPERL_ESCMODE_0_i">) set SetEnv EMBPERL_ESCMODE
0 in your srm.conf</A></STRONG>
+<br> <LI><STRONG><A NAME="_set_escmode_0_escmod">) set $escmode = 0 -> [-
$escmode = 0 ; -]</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_set_SetEnv_EMBPERL_ESCMODE_0_i">) set SetEnv
EMBPERL_ESCMODE 0 in your srm.conf</A></STRONG><br>
</OL>
<p>[<a href="" >HOME</a>] [<a
href="Faq.pod.cont.html">CONTENT</a>] [<a href="Faq.pod.3.html">PREV
(Common Questions)</a>] [<a href="Faq.pod.5.html">NEXT
(Debugging)</a>] <br>
<font
color="#808080">___________________________________________________________________________________<br>
1.13 +6 -7 modperl-site/embperl/Faq.pod.5.html
Index: Faq.pod.5.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.5.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- Faq.pod.5.html 2000/08/25 05:31:57 1.12
+++ Faq.pod.5.html 2000/12/04 07:42:24 1.13
@@ -28,7 +28,6 @@
<hr>
<P>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="I_am_having_a_hard_time_debuggin">I am having a hard time debugging Embperl
code</A></H2>
-<P>
Have you, umm, checked the error log? ;)
<P>
@@ -69,17 +68,17 @@
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_can_I_improve_Embperl_s_perf">How can I improve Embperl's
performance?</A></H2>
<OL>
-<LI><STRONG><A NAME="_Load_Embperl_at_server_startup">) Load Embperl at server
startup. This will cause
+<br> <LI><STRONG><A NAME="_Load_Embperl_at_server_startup">) Load Embperl at
server startup. This will cause
UNIX systems to only allocate memory once, and not
for each child process. This reduces memory use,
- especially the need to swap additional memory.</A></STRONG>
-<LI><STRONG><A NAME="_Disable_all_unneeded_debugging">) Disable all unneeded
debugging flags. You should never set
+ especially the need to swap additional memory.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_Disable_all_unneeded_debugging">) Disable all
unneeded debugging flags. You should never set
dbgFlushLog dbgFlushOutput, dbgMem and dbgEvalNoCache in a
- production environment.</A></STRONG>
-<LI><STRONG><A NAME="_You_may_also_want_to_take_a_lo">) You may also want to take a
look at the available options
+ production environment.</A></STRONG><br>
+<br> <LI><STRONG><A NAME="_You_may_also_want_to_take_a_lo">) You may also want
to take a look at the available options
you can set via EMBPERL_OPTIONS. For example optDisableChdir, will
speed up processing because it avoid the change directory before
- every request.</A></STRONG>
+ every request.</A></STRONG><br>
</OL>
<p>[<a href="" >HOME</a>] [<a
href="Faq.pod.cont.html">CONTENT</a>] [<a href="Faq.pod.4.html">PREV
(Escaping & Unescaping)</a>] [<a href="Faq.pod.6.html">NEXT
(Customizing)</a>] <br>
<font
color="#808080">___________________________________________________________________________________<br>
1.14 +4 -7 modperl-site/embperl/Faq.pod.6.html
Index: Faq.pod.6.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Faq.pod.6.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- Faq.pod.6.html 2000/08/25 05:31:58 1.13
+++ Faq.pod.6.html 2000/12/04 07:42:24 1.14
@@ -32,7 +32,6 @@
<P>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="How_can_I_fiddle_with_the_defaul">How can I fiddle with the default values?
How can I override or alter this or that behavior?</A></H2>
-<P>
Usually, defaults are set in a way that is likely to make most sense for a
majority of users. As of version 1.0, Embperl allows much more flexibility
in tweaking your own default values than before. Take a look at
@@ -43,17 +42,15 @@
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="I_d_like_to_temporarily_disabl">I'd like to (temporarily) disable some of
Embperl's features.
What can be customized?</A></H2>
<OL>
-<LI><STRONG><A NAME="_Use_optDisableHtmlScan_to_disa">) Use optDisableHtmlScan to
disable processing of html tags.
+<br> <LI><STRONG><A NAME="_Use_optDisableHtmlScan_to_disa">) Use
optDisableHtmlScan to disable processing of html tags.
If this is set, Embperl will only pay attention to these types of
-constructs:</A></STRONG>
-<P>
+constructs:</A></STRONG><br>
[+/-/!/$ .... $/!/-/+]
-<LI><STRONG><A NAME="_optDisableTableScan_optDisabl">) optDisableTableScan,
optDisableInputScan and optDisableMetaScan can be
-used to disable individual parts of HTML processing.</A></STRONG>
-<P>
+<br> <LI><STRONG><A NAME="_optDisableTableScan_optDisabl">)
optDisableTableScan, optDisableInputScan and optDisableMetaScan can be
+used to disable individual parts of HTML processing.</A></STRONG><br>
You may set these flags in your server config, or at runtime:
<P>
1.6 +17 -34 modperl-site/embperl/Features.pod.1.html
Index: Features.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Features.pod.1.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Features.pod.1.html 2000/08/25 05:31:59 1.5
+++ Features.pod.1.html 2000/12/04 07:42:24 1.6
@@ -21,91 +21,74 @@
[<a href="" >HOME</a>] <br><hr>
<UL>
-<LI>
-<P>
+<br> <LI>
Lets you embed Perl code into HTML documents. Perl code is evaluated at the
server side and the result is sent to the browser.
-<LI>
-<P>
+<br> <LI>
Offers various meta-commands for conditional and loop processing of the
HTML documents.
-<LI>
-<P>
+<br> <LI>
Automatically generates dynamic HTML tables/lists from Perl arrays or
function calls (e.g. DBI fetch)
-<LI>
-<P>
+<br> <LI>
Form data send to your document is placed in a hash
-<LI>
-<P>
+<br> <LI>
Automatically inserts data from the form hash into HTML input, textarea and
select tags
-<LI>
-<P>
+<br> <LI>
Understands HTML and URL escaping and unescaping
-<LI>
-<P>
+<br> <LI>
Handles per-user and per-module persistent session data for you. All you
need to do is store and retrieve them to and from a special hash.
-<LI>
-<P>
+<br> <LI>
Allows you to build your web-site out of components. Frequently used
elements can be defined once and included in every page.
-<LI>
-<P>
+<br> <LI>
<EM>EmbperlObject</EM> allows you to define the standard layout of your site just
once and
includes the neccessary components based on the uri. Your HTML documents
just have to contain the unique stuff and not the common stuff like
headers/footers or navigation bars. Also these common elements can be
overwritten in each subdirectory.
-<LI>
-<P>
+<br> <LI>
Gives you the possibility to build libraries with a set of frequently used
Elements or components, and make them available to the whole web-site in
the same way as Perl modules are - well, modularized.
-<LI>
-<P>
+<br> <LI>
Supports debugging of pages by generating a very detailed log file and
making it accessible via the browser with a single click.
-<LI>
-<P>
+<br> <LI>
Generates verbose error pages in which every error can link to the log
file. This is ideal for debugging.
-<LI>
-<P>
+<br> <LI>
Offers a lot of options for maximum configurability according to your
personal tastes and needs.
-<LI>
-<P>
+<br> <LI>
Fully integrated into Apache and mod_perl to acheive the best performance.
Can also run as a CGI-script, offline or called from another Perl program.
-<LI>
-<P>
+<br> <LI>
The Perl module DBIx::Recordset offers high level, easy to handle database
access for Embperl.
-<LI>
-<P>
+<br> <LI>
If you are concerned about security you can configure Embperl to use
Safe.pm. This way, your documents can run in a safe namespace which can
allow or disallow certain Perl opcodes.
-<LI>
-<P>
+<br> <LI>
<EM>HTML::Embperl::Mail</EM> gives you the possibility to send the result directly
to a email address
</UL>
1.19 +18 -22 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.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- INSTALL.pod.1.html 2000/12/04 05:40:39 1.18
+++ INSTALL.pod.1.html 2000/12/04 07:42:24 1.19
@@ -73,22 +73,20 @@
needs the following modules to work:
<UL>
-<LI><STRONG><A NAME="URI">URI</A></STRONG>
-<LI><STRONG><A NAME="MIME">MIME::Base64</A></STRONG>
-<LI><STRONG><A NAME="HTML">HTML::Parser</A></STRONG>
-<LI><STRONG><A NAME="HTML">HTML::HeadParser</A></STRONG>
-<LI><STRONG><A NAME="Digest">Digest::MD5</A></STRONG>
-<LI><STRONG><A NAME="libnet">libnet</A></STRONG>
-<LI><STRONG><A NAME="libwww">libwww</A></STRONG>
-<LI><STRONG><A NAME="libwin32">libwin32 (only Win32)</A></STRONG>
+<br> <LI><STRONG><A NAME="URI">URI</A></STRONG><br>
+<br> <LI><STRONG><A NAME="MIME">MIME::Base64</A></STRONG><br>
+<br> <LI><STRONG><A NAME="HTML">HTML::Parser</A></STRONG><br>
+<br> <LI><STRONG><A NAME="HTML">HTML::HeadParser</A></STRONG><br>
+<br> <LI><STRONG><A NAME="Digest">Digest::MD5</A></STRONG><br>
+<br> <LI><STRONG><A NAME="libnet">libnet</A></STRONG><br>
+<br> <LI><STRONG><A NAME="libwww">libwww</A></STRONG><br>
+<br> <LI><STRONG><A NAME="libwin32">libwin32 (only Win32)</A></STRONG><br>
</UL>
-<P>
<STRONG>NOTE 3:</STRONG> <EM>EmbperlObject</EM> needs the following modules to
work:
<UL>
-<LI><STRONG><A NAME="File">File::Spec</A></STRONG>
+<br> <LI><STRONG><A NAME="File">File::Spec</A></STRONG><br>
</UL>
-<P>
If you have already successfully build and tested <CODE>mod_perl</CODE> all modules
will already be there.
<P>
@@ -172,22 +170,20 @@
needs the following modules to work:
<UL>
-<LI><STRONG>URI</STRONG>
-<LI><STRONG>MIME::Base64</STRONG>
-<LI><STRONG>HTML::Parser</STRONG>
-<LI><STRONG>HTML::HeadParser</STRONG>
-<LI><STRONG>Digest::MD5</STRONG>
-<LI><STRONG>libnet</STRONG>
-<LI><STRONG>libwww</STRONG>
-<LI><STRONG>libwin32 (only Win32)</STRONG>
+<br> <LI><STRONG>URI</STRONG><br>
+<br> <LI><STRONG>MIME::Base64</STRONG><br>
+<br> <LI><STRONG>HTML::Parser</STRONG><br>
+<br> <LI><STRONG>HTML::HeadParser</STRONG><br>
+<br> <LI><STRONG>Digest::MD5</STRONG><br>
+<br> <LI><STRONG>libnet</STRONG><br>
+<br> <LI><STRONG>libwww</STRONG><br>
+<br> <LI><STRONG>libwin32 (only Win32)</STRONG><br>
</UL>
-<P>
<STRONG>NOTE 3:</STRONG> <EM>EmbperlObject</EM> needs the following modules to
work:
<UL>
-<LI><STRONG>File::Spec</STRONG>
+<br> <LI><STRONG>File::Spec</STRONG><br>
</UL>
-<P>
If you have already successfully build and tested <CODE>mod_perl</CODE> all modules
will already be there.
<P>
1.11 +7 -8 modperl-site/embperl/Intro.pod.7.html
Index: Intro.pod.7.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Intro.pod.7.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Intro.pod.7.html 2000/08/25 05:32:03 1.10
+++ Intro.pod.7.html 2000/12/04 07:42:24 1.11
@@ -34,18 +34,17 @@
Embperl logs the following things:
<DL>
-<DT><STRONG><A NAME="Source">Source</A></STRONG><DD>
-<DT><STRONG><A NAME="Environment">Environment</A></STRONG><DD>
-<DT><STRONG><A NAME="Form">Form data</A></STRONG><DD>
-<DT><STRONG><A NAME="Evals">Evals (Source + Result)</A></STRONG><DD>
-<DT><STRONG><A NAME="Table">Table processing</A></STRONG><DD>
-<DT><STRONG><A NAME="Input">Input tag processing</A></STRONG><DD>
-<DT><STRONG><A NAME="HTTP">HTTP headers</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Source">Source</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Environment">Environment</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Form">Form data</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Evals">Evals (Source + Result)</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Table">Table processing</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="Input">Input tag processing</A></STRONG><DD>
+<br> <DT><STRONG><A NAME="HTTP">HTTP headers</A></STRONG><DD>
</DL>
<P>
<HR>
<H2><img src="sq.gif" width="16" height="16" alt="-"> <A
NAME="Embperl_log_file_can_be_viewed_v">Embperl log file can be viewed via the
browser</A></H2>
-<P>
For debugging, you can tell Embperl to display a link at the top of each
page to your log file. If you follow the link, Embperl will show the
portion of the log file corresponding to that request. The log file lines
1.6 +13 -26 modperl-site/embperl/Mail.pod.1.html
Index: Mail.pod.1.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/Mail.pod.1.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Mail.pod.1.html 2000/08/25 05:32:06 1.5
+++ Mail.pod.1.html 2000/12/04 07:42:24 1.6
@@ -43,65 +43,52 @@
does. Addtionaly the following parameters are recognized:
<DL>
-<DT><STRONG><A NAME="from">from</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="from">from</A></STRONG><DD>
gives the sender e-mail address
-<DT><STRONG><A NAME="to">to</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="to">to</A></STRONG><DD>
gives the recipient <CODE>address(es).</CODE> Multiply addresses can either
be separated by semikolon or given as an array ref.
-<DT><STRONG><A NAME="cc">cc</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="cc">cc</A></STRONG><DD>
gives the recipient <CODE>address(es)</CODE> which should receive a carbon
copy. Multiply addresses can either be separated by semikolon or given as
an array ref.
-<DT><STRONG><A NAME="bcc">bcc</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="bcc">bcc</A></STRONG><DD>
gives the recipient <CODE>address(es)</CODE> which should receive a blind
carbon copy. Multiply addresses can either be separated by semikolon or
given as an array ref.
-<DT><STRONG><A NAME="subject">subject</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="subject">subject</A></STRONG><DD>
gives the subject line
-<DT><STRONG><A NAME="reply">reply-to</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="reply">reply-to</A></STRONG><DD>
the given address is insert as reply address
-<DT><STRONG><A NAME="mailheaders">mailheaders</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="mailheaders">mailheaders</A></STRONG><DD>
Array ref of additional mail headers
-<DT><STRONG><A NAME="mailhost">mailhost</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="mailhost">mailhost</A></STRONG><DD>
Specifies which host to use as SMTP server. Default is <STRONG>localhost</STRONG>.
-<DT><STRONG><A NAME="mailhelo">mailhelo</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="mailhelo">mailhelo</A></STRONG><DD>
Specifies which host/domain to use in the HELO/EHLO command. A reasonable
default is normaly choosen by <EM>Net::SMTP</EM>, but depending on your
installation it may neccessary to set it manualy.
-<DT><STRONG><A NAME="maildebug">maildebug</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="maildebug">maildebug</A></STRONG><DD>
Set to 1 to enable debugging of mail transfer.
-<DT><STRONG><A NAME="options">options</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="options">options</A></STRONG><DD>
If no <A href="Mail.pod.1.html#item_options">options</A> are given the following
are used per default:
<STRONG>optDisableHtmlScan</STRONG>, <STRONG>optRawInput</STRONG>,
<STRONG>optKeepSpaces</STRONG>, <STRONG>optReturnError</STRONG>
-<DT><STRONG><A NAME="escmode">escmode</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="escmode">escmode</A></STRONG><DD>
In contrast to normal <EM>Embperl</EM> escmode defaults to zero (no escape)
-<DT><STRONG><A NAME="errors">errors</A></STRONG><DD>
-<P>
+<br> <DT><STRONG><A NAME="errors">errors</A></STRONG><DD>
As in <CODE>HTML::Embperl::Execute</CODE> you can specify an array ref, which
returns all the error messages from
template processing. If you don't specify this parameter <CODE>Execute</CODE> will
die when an error occurs.
1.115 +26 -26 modperl-site/embperl/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/modperl-site/embperl/index.html,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -r1.114 -r1.115
--- index.html 2000/12/04 05:40:39 1.114
+++ index.html 2000/12/04 07:42:24 1.115
@@ -74,10 +74,10 @@
<td bgcolor="#bFcDdA"> Current Version </td>
</tr>
<tr>
- <td bgcolor="#AFBDCA"> <a href="Embperl.pod.16.html"><code>Stable:
1.2.1</code></a></td>
+ <td bgcolor="#AFBDCA"> <a href="Embperl.pod.16.html"><code>Stable:
1.3.0</code></a></td>
</tr>
<tr>
- <td bgcolor="#bFcDdA"> <a href="Embperl.pod.16.html"><code>Beta:
1.3b7</code></a></td>
+ <td bgcolor="#bFcDdA"> <a href="Embperl.pod.16.html"><code>Beta:
comming soon</code></a></td>
</tr>
<tr>
<td bgcolor="#AFBDCA"><big> </big></td>
@@ -102,7 +102,7 @@
<td width="400" valign="top">Embperl gives you the power to embed Perl
code in your HTML documents
and the ability to build your Web site out of small reusable
objects
in a OO-style. You can also take advantage all available Perl
modules,
- (including DBI for database access) use thier functionality
and easily
+ (including DBI for database access) use their functionality
and easily
include their output into your web pages.<p>
Embperl has several features especially useful for creating
HTML,
@@ -117,16 +117,16 @@
Read the <a href="Intro.pod.cont.html">introduction</a> to get
started.
If you would like to know more about Embperl,
here is the <a href="Embperl.pod.cont.html">full
documentation</a>.
- Creating your website out of website out of small reusable
objects
- is decribed in the documentation for
+ Creating your website out of small reusable objects
+ is described in the documentation for
<a href="EmbperlObject.pod.cont.html">EmbperlObject</a> and
<a href="Mail.pod.cont.html">HTML::Embperl::Mail</a> gives you
the possibility
to send the result pages per email.
A <a href="Faq.pod.cont.html">FAQ list</a> is also available
and the history of
- <a href="Changes.pod.cont.html">Changes</a> can also be found
here. There are also useful
- <a href="Examples.html">examples</a> which show exactly how
Embperl works.<p>
- There is also a module for Database access within Embperl,
look here for an introduction of
- <a href="Intro.pod.8.html#DBIx_Recordset">DBIx::Recordset</a>
<p>
+ <a href="Changes.pod.cont.html">Changes</a> can be found here.
There are some useful
+ <a href="Examples.html">examples</a> which shows how Embperl
works.<p>
+ Addtionaly there is a module for Database access within
Embperl, look at
+ <a href="Intro.pod.8.html#DBIx_Recordset">DBIx::Recordset</a>
and read the introduction.<p>
</td>
</tr>
@@ -144,46 +144,46 @@
</tr>
<tr bgcolor="#AFBDCA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">4. Dec 2000</td>
- <td><font face="Helvetica,Arial" size="2" color="#ff0000">After nearly
a year of beta test, the final 1.3.0 release is out.
+ <td><b>4. Dec 2000</b><br>
+ After nearly a year of beta test, the final <font color="#ff0000">1.3.0
release</font> is out.
Beside a lot of enhancements, EmbperlObject which allows you
to
build your web site out of small reusable objects
in a OO-style, is the main improvement since 1.2.1.
- </font></td>
+ </td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">1. Dec 2000</td>
- <td><font face="Helvetica,Arial" size="2">The slides from my talk on
the
+ <td vAlign="top"><b>1. Dec 2000</b><br>
+ The slides from my talk on the
<a href="http://conferences.oreilly.com/">O'Reilly Open Source
Software Convention</a>
are now available <a
href="http://www.ecos.de/embperl/index.htm/ep/pod/oscon2000/index.html">here</a>.
- </font></td>
+ </td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">15. Nov 2000</td>
- <td><font face="Helvetica,Arial" size="2">Embperl 1.3b7
released</font></td>
+ <td><b>15. Nov 2000</b><br>
+ Embperl 1.3b7 released</font></td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">18. Oct 2000</td>
- <td><font face="Helvetica,Arial" size="2">Embperl 1.3b6
released</font></td>
+ <td><b>18. Oct 2000</b><br>
+ Embperl 1.3b6 released</td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">20. Aug 2000</td>
- <td><font face="Helvetica,Arial" size="2">Embperl 1.3b5
released</font></td>
+ <td><b>20. Aug 2000</b><br>
+ Embperl 1.3b5 released</font></td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">17. July 2000</td>
- <td><font face="Helvetica,Arial" size="2">Embperl 1.3b4
released</font></td>
+ <td><b>17. July 2000</b><br>
+ Embperl 1.3b4 released</font></td>
</tr>
<tr bgcolor="#bFcDdA">
<td vAlign="top"><img height="13" src="bullet.gif" width="13"></td>
- <td vAlign="top">22. Juni 2000<p><a
href="http://conferences.oreilly.com/"><img src="perlconf4_speaker.gif"
- width="130" height="129"></a></td>
- <td>
+ <td><b>22. Juni 2000</b><br
+ <a href="http://conferences.oreilly.com/"><img
src="perlconf4_speaker.gif"
+ width="130" height="129"></a>
On the <a
href="http://conferences.oreilly.com/">O'Reilly Open Source Software Convention</a>
there is again a talk about Embperl<p>
<a
href="http://www.oreillynet.com/pub/e_sess/863">Embperl - From Embedding Perl into
HTML to Objects and XML</a><p>
@@ -209,7 +209,7 @@
<blockquote>
<p><font color="#808080" size=1><hr>
HTML::Embperl - Copyright (c) 1997-2000 Gerald Richter / ECOS
<[EMAIL PROTECTED]>
- Last Update $Id: index.html,v 1.114 2000/12/04 05:40:39 richter Exp $</font></p>
+ Last Update $Id: index.html,v 1.115 2000/12/04 07:42:24 richter Exp $</font></p>
</blockquote>
</td></tr><!--msnavigation--></table></body>
</html>
