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>