                                 Templedit:
                   Template Editor for moviedb additions

By Philippe Queinnec <queinnec@enseeiht.fr> or <queinnec@dgac.fr> 
Hacked around June 1994

This code is copyrighted Philippe Queinnec, except dbutils.c, dbutils.h and
moviedb.h, copyrighted by Colin Needham <cn@ibmpcug.co.uk>.

This code is somewhat part of the moviedb distribution, but may be
distributed independently. This code is under the same license as the
moviedb distribution. Due to excessive paranoia, this license is also
distributed with templedit, in the file LICENSE.

See COMPILATION below to find how to compile it.

WHAT IS THIS?
-------------

Do `templedit filename', where filename is a file generated by Mark Harding's
'template' program or generated via the movie mail-server's "TEMPL TITLE"
command: To receive a template from the server send e-mail with the subject:

TEMPL TITLE <title>

to <movie@ibmpcug.co.uk>. For example:

TEMPL TITLE Psycho
TEMPL TITLE Terminator, The
TEMPL TITLE Four Weddings and a Funeral

templedit inserts your additions into the input file. The old content is
left in filename.bak. At the end, templedit offers you to launch an editor
so that you can complete some of the missing fields (or correct your
answers).

The edited template file should then be mailed back to the server with the
subject: "UPDATE TITLE" and your data will be added to the queue for
processing.

(and guess what? Template is an example of an input file)

Oh, and I almost forget: M-h calls list on the current name, and M-H calls
ltrace.

REQUIREMENTS
------------

 - an ANSI compiler
 - the readline library. readline is available on prep.ai.mit.edu:/pub/gnu,
   or ftp.cenatls.cena.dgac.fr:/pub/gnu/readline-1.1.tar.gz. It's easy to
   compile.
 - A lot of memory.

Note: You don't need the whole movie database software installed. You can
pick up the ready made data files from:
 cathouse.org in  /pub/cathouse/movies/database/tools/ready-made-data.tar.Z
 ftp.funet.fi in  /pub/culture/tv+film/lists/tools/ready-made-data.tar.gz
unpack them and set DBDIR accordingly.

COMPILATION
-----------

 - Make sure readline has been installed (see the file MACHINES).
 - untar templedit-<version>.tar.Z wherever you want.
 - Configure the variables in Makefile.
   Consult also the file MACHINES.
 - make

Potential problems:
 - if waitpid() does not exist, define NO_WAITPID in exec.c. I don't want to
   be responsible for such crap.

See also MACHINES for specific instructions.


TESTED ON
---------
[ All these machines have VFORK. Its use is highly adviced on DEC and HP. ]
 - sun4, SunOS 4.1.3, gcc 2.5.8
 - DEC Alpha OSF/1, DEC OSF/1 AXP Compiler Driver 3.11
 - sun4, solaris 2.2, gcc 2.5.8
 - HP9000, HP/UX 9.1, HP cc  (*)
 - PC386, Linux 0.99.13, gcc 2.4.5  (*)

(*) means see MACHINES for specific instructions.

I'll be glad to hear about other ports.

TODO
----
[ Due to excessive length, the current todo list is not distributed.
         -- The Management
]
[ That's wrong, there are only four lines in it!
         -- The Programmer
]

WHERE IS THE NEW VERSION?
-------------------------

The newest version can always be found on ftp.cenatls.cena.dgac.fr,
/pub/export/templedit-<version-number>.tar.Z. This version may be unstable.

Working version (that is, a version tested by at least two persons) is in
the standard moviedb archives.
