Path: usenet.cise.ufl.edu!newsfeeds.nerdc.ufl.edu!news-dc-2.sprintlink.net!news-east1.sprintlink.net!news-peer1.sprintlink.net!news.sprintlink.net!news.maxwell.syr.edu!newsfeed.corridex.com!nntp2.savvis.net!inetarena.com!not-for-mail
From: Joern Reder <
[email protected]>
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: CIPP-1.90
Followup-To: comp.lang.perl.modules
Date: 11 Mar 1999 18:39:04 GMT
Organization: dimedis GmbH
Lines: 140
Approved:
[email protected] (comp.lang.perl.announce)
Message-ID: <
[email protected]>
NNTP-Posting-Host: halfdome.holdit.com
X-Disclaimer: The "Approved" header verifies header information for article transmission and does not imply approval of content.
Xref: usenet.cise.ufl.edu comp.lang.perl.announce:252 comp.lang.perl.modules:9194
file: $CPAN/authors/id/J/JR/JRED/CIPP-1.90.tar.gz
size: 34972 bytes
md5: 8e8feafcd8f59a0f0d69796897108f5e
CIPP - CgI Perl Preprocessor by Joern Reder
Copyright (c) 1997-1999 dimedis GmbH, Germany
This library ist free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
$Id: README,v 1.4 1999/01/18 14:47:15 joern Exp $
WHAT IS CIPP?
CIPP is a perl module for translating CIPP sources to pure perl
programs. CIPP defines a HTML embedding language called CIPP
which has powerful features for CGI and database developers.
Many standard CGI- and database operations (and much more)
are covered by CIPP, so the developer has no need to code
them again and again.
CIPP is useful in two ways. One aproach is to let CIPP generate
standalone CGI scripts, which only need a little environment to
run (some configuration files). If you want to use CIPP in this
way: there is a complete development environment called spirit
which supports you in many ways, to develop such CGI programms
with CIPP. spirit can be downloaded from CPAN, but is only free
for non commercial usage.
The second is to use the Apache::CIPP_Handler module. This module
defines an Apache request handler for CIPP sources, so they will
be executed in an Apache environment on the fly, with a two-level
cache and great performance. The Apache::CIPP_Handler module
is free software.
WHAT DO YOU NEED TO USE CIPP
CIPP itself needs perl 5.004_01 or better. To use its database
interface you must have installed the DBI module (somewhat
better than version 0.97) and a DBD-module for your database
system.
CIPP is a pure perl module, so you need no C compiler.
WHICH PLATFORMS ARE SUPPORTED
CIPP runs on any Unix system with a perl interpreter.
The Win32 platforms are not tested yet very well but most
functions should run ok.
DOWNLOAD CIPP
CIPP (and also spirit mentioned above) can be downloaded
from CPAN
$CPAN/authors/id/J/JR/JRED
or (in future) from the spirit website.
http://spirit.dimedis.de/
(this site will start March 1999)
INSTALLING CIPP
perl Makefile.PL
make
make install
DOCUMENTATION
Technical information about the usage of the CIPP.pm module
is embedded as POD in CIPP.pm and can be retrieved with
"perldoc CIPP". You will not need this information, if you
use CIPP either with Apache::CIPP_Handler or spirit.
The CIPP language reference manual can be downloaded from CPAN as
an extra package. This is usefull, because the format of the
documentation is PDF and the uncompressed file has more than 500kb.
Also not every modification of CIPP leads to modification of
the documentation.
SUPPORTED LANGUAGES
When the development of CIPP started (spring 1997), there was no
idea to publish it, as it was designed for spirit, and spirit
was intended for internal use only.
So the documentation and all CIPP messages are in german language.
As soon as possible we want to provide an english version, too.
SIMPLE EXAMPLE
Here is a simple example of using CIPP in an HTML source to
retrieve some information from a database. Think this as a
HTML page which will be executed on the fly in an Apache
environment or will be converted to a standalone CGI script.
Note: there is no code to connect to the database. This is
done implicitely. The configuration is taken from Apache
or from an external configuration file, if you use the CGI
standalone version of CIPP.
<HTML>
<HEAD><TITLE>tiny litte CIPP example</TITLE></HEAD>
<BODY>
<H1>tiny litte CIPP example</H1>
<P>
<TABLE BORDER=1>
<TR><TD>Name</TD><TD>Adress</TD><TD>Phone</TD></TR>
<?SQL SQL="select name, adress, phone from people"
MY VAR="$n, $a, $p">
<TR><TD>$n</TD><TD>$a</TD><TD>$p</TD></TR>
<?/SQL>
</TABLE>
</BODY>
</HTML>
BUG REPORTING
Please send any bug reports or comments to
[email protected]
or use the bug report formular on the spirit website
http://spirit.dimedis.de/
(this site will start March 1999)
You can speak german with us, but we understand english, too ;)