[Bug-apl] Beginnings of a README.txt file for the SQL library

[Blake McBride]

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

Elias Mårtenson <address@hidden>

This package provides an SQL interface for GNU APL.  It supports Sqlite

and PostgreSQL.

GIT Repository located at:  https://github.com/lokedhs/apl-sqlite.git

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