<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>HTML::Merge - Embedded HTML/SQL/Perl system.</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body style="background-color: white">
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#installation">INSTALLATION</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#files">FILES</a></li>
<li><a href="#author">AUTHOR</a></li>
<li><a href="#copyright">COPYRIGHT</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>HTML::Merge - Embedded HTML/SQL/Perl system.</p>
<p>
</p>
<hr />
<h1><a name="installation">INSTALLATION</a></h1>
<p>After installing the package, activate <strong>mergecreateinstance</strong> to create an instance in your cgi-bin (or mod_perl) directory.
Follow the directions you get from <strong>mergecreateinstance</strong> in order to configure
your web server.</p>
<p>You must edit the merge.conf created for you.</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
<HTML>
<$RQ.'SELECT * FROM customers WHERE customer_id=<$RVAR.cust_id>'>
<$RLOOP>
<$RSQL.name> owes <$RSQL.debt><BR>
</$RLOOP>
<A HREF="/cgi-bin/merge.pl?template=main_menu.html">
</HTML></pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>Merge is an embedded HTML/Perl/SQL tool for creating dynamic web content.
merge.pl compiles HTML with embeded Perl to Perl CGI programs and run them.</p>
<p>All Merge pages are referred to by <strong>cgi-bin-dir</strong>/merge.pl?template=<strong>file.html</strong></p>
<p>(Important: file.html is a HTML template that located in a directory you choose
and name it on the merge.conf file. Notice for better security, the web server
must not be able to display the templates dirctory).
although on CGI mode you can define merge.pl as an handler with the Action
directive in Apache.</p>
<p>Using merge.pl under Apache::Registry will utilize Perl's built-in caching to
cache pages using the <strong>do</strong> command.</p>
<p>Merge uses a configuration file to retrieve information about paths, database
connectivity and debugging. It has an embedded debugging tool and on-line
configuration. To turn that option on, set DEVELOPMENT to 1 in the
configuration file. Don't forget to set it off before deployment.</p>
<p>Configuration can be changed during development using the toolkit menues,
toolkit menues apear as popup windows on your web browser when you open
a URL of mrege.pl.
</p>
<pre>
Alternate configuration files can appear in B</etc/merge.conf> and B<$HOME/.merge>.</pre>
<p>As described in the INSTALL document you <strong>must</strong> set your web server for
each appliaction and copy (or create) links to merge.pl and <strong>PUBLIC</strong> files
and templates and create system database tables. If you are using a UNIX
system you can use <strong>mergecreateinstance</strong> that will do thoes tasks for you.</p>
<p>
</p>
<hr />
<h1><a name="files">FILES</a></h1>
<pre>
B<merge.pl> Main script, usually a symbolic link to each instance.</pre>
<pre>
B<merge.conf> Configuration, unique per each instance.</pre>
<pre>
B<$PREFIX/share/merge/private> Internal scripts.</pre>
<pre>
B<$PREFIX/bin/merge.cgi> Main script, central.</pre>
<pre>
B<$PREFIX/bin/merge.conf> Template for configuration files.</pre>
<pre>
B<$PREFIX/bin/mergecreateinstance> Instance creating script.</pre>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<ul>
<li>
<p>Design by Oded S. Resnik.</p>
</li>
<li>
<p>Versions 1,2,3.35 - 3.45 written by Roi Illouz.</p>
<p>Versions 3.46 - manitained by Oded resnik and Gabor Szabo.</p>
</li>
<li>
<p>Version 3 written by Ariel Brosh RIP (till ver 3.34).</p>
</li>
<li>
<p>Toolbox written by Eial Solodki.</p>
<p>Testing & documentation by Noam cassif.</p>
<p>New test & version 3.46 - Gabor Szabo and Oded Resnik.</p>
</li>
</ul>
<p>
</p>
<hr />
<h1><a name="copyright">COPYRIGHT</a></h1>
<p>Copyright (c) 1999 - 2006 Raz Information Systems Ltd.
<a href="http://www.raz.co.il">http://www.raz.co.il</a></p>
<p>This package is distributed under the same terms as Perl itself, see the
Artistic License on Perl's home page.</p>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p>perl(1), <a href="Tags.html">the HTML::Merge::Tags manpage</a>, <a href="Ext.html">the HTML::Merge::Ext manpage</a>.</p>
</body>
</html>