Module Name:	pkgsrc
Committed By:	grant
Date:		Thu Dec  4 15:36:56 UTC 2003

Modified Files:
	pkgsrc/doc: CHANGES TODO

Log Message:
Initial import of p5-CGI-FormBuilder-2.12 into the NetBSD packages
collection.

The goal of CGI::FormBuilder (FormBuilder) is to provide an easy way
for you to generate and process CGI form-based applications. This
module is designed to be smart in that it figures a lot of stuff out
for you. As a result, FormBuilder gives you about a 4:1 ratio of the
code it generates versus what you have to write.

For example, if you have multiple values for a field, it sticks them
in a radio, checkbox, or select group, depending on some factors. It
will also automatically name fields for you in human-readable labels
depending on the field names, and lay everything out in a nicely
formatted table. It will even title the form based on the name of the
script itself (order_form.cgi becomes "Order Form").

Plus, FormBuilder provides you full-blown validation for your fields,
including some useful builtin patterns. It will even generate
JavaScript validation routines on the fly! And, of course, it
maintains state ("stickiness") across submissions, with hooks provided
for you to plugin your own sessionid module such as Apache::Session.

And though it's smart, it allows you to customize it as well. For
example, if you really want something to be a checkbox, you can make
it a checkbox. And, if you really want something to be output a
specific way, you can even specify the name of an HTML::Template or
Template Toolkit (Template) compatible template which will be
automatically filled in, statefully.


To generate a diff of this commit:
cvs rdiff -r1.3969 -r1.3970 pkgsrc/doc/CHANGES
cvs rdiff -r1.1124 -r1.1125 pkgsrc/doc/TODO

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.