        Name: ODBCLib
        Type: Library
     Purpose: Library for linking to ODBC client applications that
              communicates with the ODBC driver manager to execute queries.
Requirements: Acorn C compiler
              Acorn libfile
              Acorn C library
              OSLib (for headers)
              
A stubs library to link to applications that makes calls to the ODBC module.
The actual technicalities are a little complicated for what should be a
simple task. Basically:

- Application makes ODBC call to this library
- Library interogates module for free slot
- Once free slot found ODBC call is made to store parameters
- Library waits until driver manager has picked up call and executed it
- ODBC call is made to retrieve any results

This has the following side effects:

- ODBC calls can cause your application to multitask

- This library will handle basic wimp_poll requests - just enough to
  keep the Desktop going
  
- Instead of a poll loop like this:

  while (not_quit == TRUE)
      {
      eventpoll();
      
      /* any other business */
      }
      
  You would have this:
  
  ODBCLibLoop(pollfunction);
  
  Where pollfunction() would be a function similar to:
  
  int pollfunction(void)
      {
      if (not_quit == FALSE)
          {
          return 1; /* Causes ODBCLibLoop() to exit */
          }
          
      eventpoll();
      
      /* any other business */
      
      return 0;
      }

  ie ODBCLibLoop() will call your poll function but also handles other
  things for you that may occur due to the multitasking nature of the
  ODBC library.

- ODBC clients must be WIMP based applications
 