.TH FFWCGI 1 "7. Fabruary 1995"

.SH NAME

ffwcgi, ffwcgidate \- ffw CGI script interface programs

.SH SYNOPSIS

.B ffwcgi
.br
.B ffwcgidate

.SH DESCRIPTION

ffwcgi connects the ffwsearch(1) program to the CGI interface in a Web 
server. ffwcgi will provide a Web user interface to the freetext search 
facilities provided by ffw. 

ffwcgidate is a version of ffwcgi that in addition provides access to the 
mechanism for searching for documents between given dates.

ffwcgi and ffwcgidate is written in Perl and can be easily adapted to different
languages and applications. They are intended as generic interfaces to 
ffwsearch and provides starting points for writing application-specific
interfaces to ffw.

.SH INSTALLATION and USE

The ffwcgi and ffwcgidate must be adapted to each installation 
by setting parameters at
the top of the script giving the location of index files and binaries, 
the maximum size of the working lists, and maximum number of documents output.

ffwcgi and ffwcgidate will be called as 
.IP
http://www.some.where/cgi-bin/\fI<scriptname>\fP/\fI<indexlist>\fP.
.LP
where
.TP 15
.B <scriptname>
is the name of the ffwcgi script, for instance ffwcgi.no or ffwcgidate.en.
.TP 15
.B <indexlist>
is the list of indexes to be searched separated by /, for instance
"index1/index2/index3" to search in three indexes given. The directory
containing the index files must be configured into the script itself.
.LP
If ffwcgi or ffwcgidate is called with no search argument it will display 
a generic front
page, if a search argument is present it will search the given indexes.

With search argument the call to ffwcgi will be
.IP
http://www/cgi-bin/\fI<script>\fP/\fI<index>\fP?key=\fI<search term>\fP
.LP
where
.TP 15
.B <search term>
is a search expression passed to ffwsearch, encoded according to URL rules.
.LP
The search call to ffwcgidate in addition takes parameters giving the 
date limits for the search, see the script for details.

.SH AUTHOR

\fBffwcgi\fP and \fBffwcgidate\fP were developed by Bard Hafjeld at 
Telenor R&D. This manpage is written by Bard Hafjeld at Telenor R&D.

.SH SEE ALSO

ffwsearch(1), ffwindex(1), ffwmerge(1) and ffwstat(1)