1Text::Tmpl - Fast templating library.
2
3Copyright
4=========
5
6Copyright (c) 1999 Web Juice, L.L.C.  All rights reserved.  This program is
7free software; you can redistribute it and/or modify it under the same terms
8as Perl itself.
9
10
11Description
12===========
13
14Text::Tmpl is a module for very fast templating. There are dozens of
15templating modules on CPAN, each only a tiny bit different from the
16others. This one is no different - what sets it aside is speed. The
17entire module is implemented as a C library, with only a thin XS/Perl
18layer to make the calls available from Perl. The same templates, then,
19can be used from either Perl or C/C++ programs.
20
21This was originally designed to completely isolate HTML programmers
22from module/CGI programmers, or at least completely separate logic
23from content in dynamic web applications. It is syntactically based on
24a similar system written by a friend of mine, Neil Mix, which was
25proprietary and exclusively written in Perl. It shares no code in
26common with this system, or any other.
27
28
29Prerequisites
30=============
31
32A C compiler and Perl 5.  Unix (and derivative) and Win32 systems are supported
33as of 0.24.
34
35
36Building
37========
38
39  # perl Makefile.PL
40  # make
41
42
43Installing
44==========
45
46  # make test
47  # make install
48
49The C library version is not built or installed by default.  If you want to
50use it, you can build install it by hand.  Something like this ought to work:
51
52  # ar cr libtmpl.a context.o default_tags.o nclist.o parser.o staglist.o \
53          tagplist.o template.o varlist.o tokens.o
54  # ranlib libtmpl.a
55  # cp libtmpl.a /usr/local/lib
56  # cp *.h /usr/local/include
57
58This is only intended as a guide; it may very well require modification for
59use on your system.
60
61
62Additional Information
63======================
64
65If you're using this module, let me know!  It's always fascinating to hear
66what uses people have found for it.
67
68There's a lot of example perl code in the t/ (test scripts) directory in
69this distribution.  There's also a little bit of example C and C++ code in
70the examples/ directory of the distribution.
71
72You can contact me directly at dlowe@saturn5.com.  I'm happy to answer any
73questions you might have.
74
75If there's enough demand, I will create a mailing list for discussion/support.
76Let me know if this interests you.
77