Greetings,
The enclosed is the beginnings of a proposed README.txt file for the SQL extension. I think documentation can help minimize newbie frustration and improve GNU APL usage.
The loading instructions, below, will depend on a possible workspace being added to the package. The usage section need to be fleshed out. I can complete this once we settle on the workspace issue.
Thanks.
Blake
-------------------------------
SQL interface for GNU APL
This package provides an SQL interface for GNU APL. It supports Sqlite
and PostgreSQL.
BUILD INSTRUCTIONS
Modify Makefile. Set APL_DIST to point to the location of the GNU APL
source code.
Type: make
A file named "lib_sql.so" will be produced. This is the library file
needed by GNU APL in order to add this functionality.
LOADING
??????
USAGE
db = database handle
db←'sqlite' SQL∆Connect '/path/to/mydatabase.db'
or
db←'postgresql' SQL∆Connect 'host=localhost user=myusername password=mypassword dbname=mydatabase'
...
SQL∆Disconnect db