WQDB README.TXT file

Welcome to WQDB. WQDB stands for Windows Quick DataBase, but I'm afraid 
this means quick to write, not quick to use. Probably it should 
have been called QDDB for Quick and Dirty DataBase. However WQDB 
may be attractive for the following reasons: 

1) It's free. 

2) The source code (in C++) is available, and free. 

3) The program runs under Windows and X (xview and 
hopefully xmotif, though I haven't actually tried xmotif yet). 

4) It uses standard dBase III data files (DBF files). 

Note that because WQDB is freeware and written largely for my own 
purposes there is no online-help and the program cannot be used 
intuitively. I know it's 1997, but I'm afraid that in order to 
use this program you will have to read the documentation. Sorry, 
but there you are. 

WQDB essentially consists of form-based facilities to edit data 
and facilities to generate reports using its own (idiosyncratic) 
language. There is provision to import and export data to and 
from text files and other DBF files. WQDB basically works as a 
flat file database, but there is a facility for relational look-
ups into other DBF files which can be used to obtain data in 
reports and in automatically calculated fields. Some aspects of 
WQDB are modelled on Buttonware's PC-File and in some areas there 
is near-compatibility between the programs. 

Note that at present memo fields and files (DBT files) are not 
supported, though may be shortly. Indices are not compatible 
with other database programs. 

The user interface for WQDB is undeniably somewhat quirky. This 
is partly unavoidable due to the constraints of writing source 
that would compile on all three targetted platforms, but very 
largely because I wanted to get something working quickly (hence 
the Q, remember) and used a lot of pre-existing code which was 
only marginally suitable for the purpose. 

Warm acknowledgments are due to Julian Smart for producing and 
making available the wxWindows library and generously providing 
support and advice, and to Marcus Ranum for producing and making 
available the btree routines used for indexing. 


Files distributed with WQDB

WQDB.EXE        - Windows executable

CTL3DV2.DLL     - if you don't have a copy of this already, put it in your
                  WINDOWS or WINDOWS\SYSTEM directory

QDBSRC.ZIP      - zip file containing C++ source code - if you 
                  unzip this on a Unix machine make sure to 
                  convert CR-LF to CR and the filenames to lower 
                  case, e.g. unzip -a -L qdbsrc.zip 

DCPPTSRC.ZIP    - zip file containing C++ used for library 
                  routines needed by QDB

DOSEXAM.ZIP     - DOS example database

UNIXEXAM.ZIP    - Unix example database - differs in that text 
                  files have lines terminated with CR rather 
                  than CR-LF, but binary files are identical

QDB.DOC         - documentation, such as it is

Note that I am no longer supporting a DOS version of QDB, but 
the old version remains available in the qdb16 package at 
http://www.gene.ucl.ac.uk/packages/dcurtis. This contains the 
DOS executable qdb.exe as well as an earlier Windows version of 
wqdb.exe.

I would very much welcome any feedback, suggestions, problems 
and especially offers to take over development!

Dave Curtis    dcurtis@hgmp.mrc.ac.uk 
http://www.gene.ucl.ac.uk/~dcurtis
                                        December 22, 1996

   Joint Academic Department of Psychological Medicine
   St Bartholomew's and Royal London School of Medicine and Dentistry
   3rd Floor Alexandra Wing
   Turner Street
   London E1 2AD


