*TODO: write docs

Compose the FROM list of an SQL SELECT statement for a convenience view of this entity within this application, recursively. top-level? should be set only on first invocation.

Compose an SQL WHERE clause for a convenience view of this entity within this application. TODO: does not correctly compose links at one stage down the tree. See lv_electors, lv_followuprequests for examples of the problem.

Create a dummy property for a link-table referencing this entity, in order that the field generation functions already defined may be applied to it.

Emit all SQL declarations required to initialise a Postgres database for this application.

*TODO: write docs

Emit a convenience view of this entity of this application for use in generating lists, menus, et cetera.

Generate appropriate field type and constraints for this property given this typedef.

Emit an appropriate field type for this property, expected to reference an entity, in this application.

Emit an appropriate field type for this property, expected to belong to this entity within this application.

Generate an appropriate file header for the Postgres initialisation script for this application.

Emit a declaration for this authorisation group.

Emit an appropriate link field for this property of this entity within this application.

Emit a link table for the specified property of the entity e1 within this application, provided that such a table has not already been emitted from the other end. The argument emitted-link-tables contains an atom which references a set of the names of all those link tables which have already been emitted, and this is modified in the execution of this function.

Emit all required link tables for this entity within this application, given these emitted-link-tables which have already been emitted.

Emit an appropriate grant of permissions on this table-name at this privilege level given these permissions. privilege is expected to be one of #{:SELECT :INSERT :UPDATE :DELETE}. TODO: more thought needed here.

Emit a field declaration representing this property of this entity within this application.

Emit a referential integrity link for this property of the entity nearside within this application.

Emit all appropriate referential integrity links for this entity within this application.

Emit a table declaration for this entity of this application, documented with this doc-comment if specified.

Return the appropriate field name for this property. TODO: really belongs in adl-support.utils.

Generate a complete Postgres database initialisation script for this application.