/ 
roads-v2.3
/ cgi-bin/tempbyhand.pl

NAME

cgi-bin/tempbyhand.pl - given a template handle, render it as HTML

SYNOPSIS

cgi-bin/tempbyhand.pl [-d databases] [-C charset]
  [-f form] [-L language] [-o protocols] [-u url] 
  [-w waylay_url] [-v view]

DESCRIPTION

The tempbyhand.pl program is a Common Gateway Interface (CGI) program used to return a template to an end user given the handle of the template. It is called from the search.pl and admin.pl to display the full details from a template when the user has selected the titles only option.

tempbyhand.pl actually carries out a WHOIS++ search behind the scenes.

OPTIONS

These options are intended for debugging use only.

-d databases

File containing list of databases to use.

-C charset

The character set to use.

-f form

HTML form to return to the end user if no handle to lookup is supplied.

-L language

The language to use.

-o protocols

URL protocol schemes to override, e.g. wais. See "waylay.pl" in cgi-bin for more information.

-u myurl

The URL of this program, if not passed as CGI variable - default is tempbyhand.pl in the nominated CGI executables directory.

-w waylay_url

The URL of the program to use when "waylaying" URLs which are odd or unusual. See "waylay.pl" in cgi-bin for more information.

CGI VARIABLES

The tempbyhand.pl program uses two CGI parameters to determine which template to display:

charset

Character set to use.

database

This is the name of the database from which the template is to be retieved. This may be a local or remote WHOIS++ database - but it must be listed by name in the file config/databases.

form

HTML form to return to the end user.

language

Language to use.

query

This is a WHOIS++ query to send, usually simply "handle=", followed by the handle of the template to display.

FILES

config/databases - list of servers and databases.

config/multilingual/*/tempbyhand/baddbase.html - the database requested couldn't be found.

config/multilingual/*/tempbyhand/nohandle.html - the handle requested couldn't be found.

config/multilingual/*/tempbyhand/noconnect.html - the WHOIS++ server couldn't be contacted.

config/multilingual/*/tempbyhand/nohits.html - there were no hits in the WHOIS++ server.

config/multilingual/*/tempbyhand/tempbyhand.html - the HTML form returned by default to the end user when no handle is supplied.

config/multilingual/*/tempbyhand-views/* - HTML rendering rules for lookup results.

SEE ALSO

"admin.pl" in admin-cgi, "search.pl" in cgi-bin

COPYRIGHT

Copyright (c) 1988, Martin Hamilton <martinh@gnu.org> and Jon Knight <jon@net.lut.ac.uk>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

It was developed by the Department of Computer Studies at Loughborough University of Technology, as part of the ROADS project. ROADS is funded under the UK Electronic Libraries Programme (eLib), the European Commission Telematics for Research Programme, and the TERENA development programme.

AUTHOR

Jon Knight <jon@net.lut.ac.uk>, Martin Hamilton <martinh@gnu.org>