Copyright (C) 2004, 2008, Karl O. Pinc

   This file is part of Gombe-MI.

   Gombe-MI is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with Gombe-MI.  If not, see <http://www.gnu.org/licenses/>.

Karl O. Pinc <kop@meme.com>

Directory for database functions (stored procedures).

All functions beginning with _ are internal and are not called by
users.  Nobody is granted privlidges to execute these as they are
executed from functions which run as SECURITY DEFINER.

All functions should m4 include constants.m4 because they might
someday need them and this will catch any conflicts.  In practice,
this is moot as the build process crams everything together into a
single output file anyhow so long as the first file includes
constants.m4 all the files see the constants.

All the functions are broken out into their own files because it got
to take _way_ too long to install them all at once into Postgresql.
This way they can be debugged and installed individually.  For this
reason too, the standard for functions is to use CREATE OR REPLACE
FUNCTION instead of just CREATE FUNCTION.

As Postgresql functions pass arguments by value, when a function needs
to return more than one value a Postgresql datatype (not the same as
an SQL datatype) is declared for use as the functions return value.
These can be found in the maketypes.m4 file.