Files
harbour-core/harbour/examples/hbsqlit2
Viktor Szakats 1b5ddd6c72 2010-07-17 21:50 UTC+0200 Viktor Szakats (harbour.01 syenar.hu)
* contrib/Makefile
    + Enabled to build all contribs using hbmk2 from now on.

      This is huge step, but in fact a zillion little ones in
      the last 2 years, and it means that contribs now rely on
      hbmk2 and hbmk2 make files (.hbp and .hbc) to be build and
      used respectively. For implibs, .hbi is used. The whole
      process is orchestrated by a script written in Harbour: make.hbs. 
      With this change GNU Make is retired when it comes to contrib
      area. This new hbmk2 based system gives us much flexibility,
      many complicated build situations can now be potentially
      handled, while also making the contrib area fully modular,
      since they don't depend even on /config GNU Make system anymore.
      This means that any external contribs having hbmk2 make files
      are easy to import and any Harbour contribs are easy to detach 
      from our SVN. It also allows to include more features (f.e. 
      executables) in final distros. Executables hosted in the 
      contrib area have the great advantage that they can use any 
      other contrib libs (so far we were limited to core features 
      for exes). It also allows to dynamically add extra contribs 
      (or delete existing ones) on a per distro basis, so f.e. 
      certain builders can create their own binary distro with 
      a standard core and extra set of contribs. New system also 
      makes it possible to build dynamic libs from contribs. It's 
      also easier to move locally hosted external projects inside 
      the contrib tree, even as a subdir inside the contrib that 
      requires it (f.e. minizip, bz2 or sqlite). This can make 
      these projects fully self-contained.

      Some things are not perfect yet, f.e. I'm still fighting
      with cmdline length (relevant in MS-DOS) and the "in-place"
      build (I call "in-place" build when you build only one
      contrib at a time, like when issuing win-make inside a
      contrib subdir) will certainly need some getting used to,
      and maybe even some refinement in make.hbs. I've yet to
      implement automatic dependency detection and tree-sorting
      so that everything automatically builds in right order of
      dependency. Such thing can even be added for "in-place"
      build mode, and f.e. building hbide can automatically
      launch hbqt and hbxbp builds. BTW I retained the 
      "header-copy-on-install" method, but I'm not sure it's 
      right solution, anyhow we still have time to think about 
      a better one.

      If everything goes fine, the GNU Makefiles in contrib
      area will be gone, so there won't be any redundancy again.

  * utils/hbmk2/hbmk2.pt_BR.po
  * utils/hbmk2/hbmk2.hu_HU.po
  * utils/hbmk2/hbmk2.prg
    + -stop cmdline option now accepts a message it displays before stopping.
    + skip= .hbc command will now stop if there is text in its parameter.
      INCOMPATIBLE: So far -skip only skipped if 'on' was passed as value,
      now it will always skip. This means this command always has to be used
      along a filter. If the filter evaluates, skip will happen, if not it
      won't.
    + Added stop= .hbc command which will halt complete build process,
      similarly to -stop cmdline option. It also supports text to be
      displayed.

  * contrib/hbqt/hbqt.hbc
    + Will now stop with a screen message if this component is tried
      to be used on unsupported platform.

  * contrib/hbwin/hbolesrv.hbc
  * examples/hbsqlit2/hbsqlit2.hbp
  * examples/gtwvw/gtwvw.hbp
    * Changed to use new hbmk2 -stop facilities.

  * src/rtl/filesys.c
    + Missed two casts from previous commit.

  - examples/gtwvw/Makefile
    - Deleted.
2010-07-17 19:51:18 +00:00
..

/*
 * $Id$
 */

/*
 *------------------------------------------------------------------------
 *                  HARBOUR INTERFACE for SQLITE  
 *------------------------------------------------------------------------
 *
 * Copyright 2003 Alejandro de Garate <alex_degarate@hotmail.com>
 *
 * License: General Public License or for short GPL (GNU)
 * 
 * Developed using:
 *     Harbour 0.42 or upper 
 *     Borland C++ BCC 5.5.1 
 *
 */

 Requirements
 ------------
 Any windows platform W95, W98, W98SE or NT family 
 A C++ compiler, if you use other than Borland some minor changes could
 be required. 


 The program
 -----------
 The source program is quite small (about 50 Kbytes) and a litle basic, 
 but gives an easy way of accessing a SQL Database, like SQLite.
 Inside the prg you can find several C functions used to connect to the 
 database, and Clipper/Harbour code used for calling C functions.
 Most of the code is commented and is easy to follow.
 Of course many enhancement would be done, I will do if I found spare 
 time :)
 The library that come with the program it's based in the SQLite version
 2.8.6


 Purpose
 -------
 To access a sqlite database using Clipper/Harbour language.


 Use
 ---
 This program is mostly self-contained.
 For using you needs:
  1- Borland C++ Compiler BCC 5.5 or upper   (working)
  2- Harbour version 0.42 or upper  (working)
  3- hbsqlite.prg (main program /front end)
  4- hbsqlite.ch  (some defines)
  5- sqlite.lib   (library builded for BCC55 and windows platform)
  6- sqlite.h     (include file for sqlite code)
  7- sqliteInt.h  (include file for sqlite code)
  8- example.db   (a simple sqlite database for testings )

 Steps:
 1.- Unzip the package to the target directory (ie.: \sqlite)

 2.- Keep the zip file at safe place :)

 3.- Add sqlite.lib to the list of libraries 
     You also needs to add sqlite.lib to the list of libraries inside 
     the build.bat file at harbour\bin directory.

 4.- Move the static library sqlite.lib to the harbour\lib directory.

 5.- If you have (1) & (2) working, just compile hbsqlite.prg using:
      bld_b32 hbsqlite   // without extension


 Information about SQLITE
 ------------------------
 1. web site at www.sqlite.org

 2. User list for sqlite (do not ask about harbour stuffs) 
    subscribe at:
 <sqlite-users-subscribe@sqlite.org>         (one by one)

 <sqlite-users-digest-subscribe@sqlite.org>  (digest mode)


 What is inside the source package ?
 -----------------------------------
 Inside the hbsqlite_src.zip file you will find:

    File               Size     Description
 --------------------------------------------------------------------------
 1- hbsqlite.prg       46.401   (main program /front end)
 2- hbsqlite.ch         3.369   (some defines)
 3- sqlite.lib        352.256   (lib builded for BCC55 and windows platform)
 4- sqlite.h           31.222   (include file for sqlite code)
 5- sqliteInt.h        53.893   (include file for sqlite code)
 6- gpl.txt            17.989   (a copy of GPL license)
 7- todo.txt                    (a list of pending things )
 8- readme_en.txt               (this readme)

 Note:
 You may want also the sqlite manager and the sample database, in that 
 case you must download the binary package.


 What is inside the binary package ?
 -----------------------------------
 Inside the hbsqlite_bin.zip file you will find:

    File               Size     Description
 --------------------------------------------------------------------------
 1- hbsqlite.exe      741.376   (harbour front end to sqlite)
 2- sqlite.exe        285.444   (a comand-line Sqlite manager) 
 3- example.db         77.824   (a simple sqlite database for testings)
 4- test.db                     (another sqlite database for testings)
 5- readme_en.txt               (this readme)

 Final comments
 --------------
 You can adapt the program to your needs, but if you made any 
 improvements, fixes or found any error, let me know so I can add it
 to the program.
 Anyway if you want to ask something, or think a feature is missing
 send me a mail.

 Enjoy it!
 
 Alejandro