Ensure function installation into the db is before comment generation

Function signatures cannot be obtained until after functions are
put into the database.  This means that comment SQL cannot be generated
before functions go in.  Alter the big install/re-install targets to
be sure that things happen in the right order.

The user can still invoke the "installcomments" target without having
all the functions installed.  In this case comment installation fails.
It is up to the user to install things in the proper order, as with
tables and views, when invoking targets that install piecemeal.

Be consistent with PSQL_DEPENDS dependency placement

Fix install target docs

Remove <schema>/comments/ with clean-db

Document default pg host

Improve DATABASE TARGETS docs

Name the devloper's database "sokwedb_dev", not "sokwedb_copy"

Add user management commands: sokwedb-user-add, sokwedb-user-delete

Remove unnecessary program

Much improve the build system's performance

Have make cache the creation of targets that:
  Put things in the database.
    No point in connecting to the db all the time when
    we don't need to.
  Create directories.
    There are separate targets for directory creation dependencies
    so that adding to/deleting from directories themselves don't
    change the dependent timestamp.
  Create complex targets.
    Some targets build things that are too complex to easily
    test, in a later make run, that the target has been successfully
    completed.

In all the above cases the build system used to go ahead and do the
extra work. But now, gen_comments.py takes a long time to run
and it's really annoying to wait all the time.

Fix to cleanup comment sql

Fix indentation

Run comments taken from the docs through Sphinx to make the in-db text

Fix trigger RETURN statements

Better sentence

All non-html formats have the same epilog

Fix to capture comments at the end of a file

Technically, this shouldn't be necessary because the convention is to
declare the comment and then use it.  So no comment replacment text
should be at the end of the file.  But having a function makes
the code more clear and no harm in having code that always works.

Empty lines do not end indent blocks

Trigger functions must RETURN

Simplify logic

Reformat with black

Move make documentation above make db

This is necessary or making the db comments won't work, they depend
on $(HTML_RST_FILES) being defined when the comments are collected.

Directories must exist before the RST can

Put dependencies in the right order

Move secondexpansion make code into it's own file

Put cluster creation stuff in it's own file

Give the database connection variables their own doc heading

Add dependencies everywhere psql is called

Add db comments for columns

Column names should not contain underscores

Basics of putting comments into the db

Put julian_to() into it's own file

The db commenting build system requires a file per function name.

Use make function instead of shell function

Fix removal of leading empty lines

Better function documentation

Provide overview of how to use the make system

Add table of contents to the doc's readme

There is no master shell script to make and configure databases

Reformat with black

Build triggers after views

That way we can put triggers on views in the triggers directory.
We could have a separate "catagory" just for triggers on views,
but that introduces complication for no real benefit.

Move generated doc files into sphinx-doc directory

Support including view definitions into the documentation

Combine 2 targets into one line

Variable for latex (pdf) prerequeistes

Improve cluster creation docs after review with Stevan

Make doc indentation consistant

fix: ensure consistent db config file sorting

fix: spacing

fix: configuration name default_transaction_isolation

Add comments to explain what's generated

Fix line length

Do not alter the stored configurations on error

Commit the expected Azure server configs to revision control

New targets for comparing Azure PG server configuration

Improve config diff docs

Commit expected PG Azure db settings to revision control

Fix compare-db-settings to work with Azure

For some reason on Azure's Postgres flexible-server PGv15 the
SQL

SELECT name, setting, unit, pending_restart \
                     FROM pg_settings \
                     ORDER BY name;

Does not return a consistent ordering when run on different databases
on the same PG server.  So run the output through `sort`.

Add pending_restart column to compare-db-settings

Fix use of psql_setup.sh

New targets for comparing db configurations

Documentation formatting

Add targets for building cluster hosts on Azure

Fix footnote numbering

Fix punctuation

Set the default transaction isolation to serializable

Avoid hardcoding in Makefiles

Set default time zone in cluster setup

Better comment

Drop the PUBLIC schema with a cluster initialization target

Add comments to SokweDB group roles

Better superuser docs

Improve docs

Better docs for macro

Avoid spurious newlines in generated RST

Remove files used in attempt to match input lines with lines reported in pl/pgsql errors

Require new databases have a commnt

Make all the group-ish roles during cluster setup

Adjust permission system for Azure's lack of the SUPERUSER role property

Kludge to work-around lack of SUPERUSER role properties when vacuuming

Document date input and output formats

Grant permissions to sequences

Remove unused (macro) types

The unknown individual can't be deleted or altered by regular users

Improve description

Fix link anchors

Give macros dealing with speical values better names

Fix connection db in hint

Fix column name in error message

Add create-adminuser-root target to build system

Add set-password build target

Beginnings of a cluster initialization build setup

Change variable name from SOKWEDB_DB to TARGET_DB

Qualify the login with a (short) hostname for azure

No reason to expand PSQL_ARGS_MINIMAL dynamically

Fix spelling of azure pg host

Take $(ORDER) out of the dependencies

No point.  Plus some schemas don't yet exist under revision control.

Initial database construction

This includes creation of a build system as well as tables, triggers, etc.
that create some initial demographic database objects.  Also included
are some changes to the documentation which include additional database
validation rules.

Fiddle with m4 include path resolution

Use $CMD_TARGETS instead of $TARGETS for uniqueness among include files

Explain the use of PEOPLE.Active