README 2.4 KB
Newer Older
Rodrigo Moya's avatar
Rodrigo Moya committed
1 2 3 4 5 6 7 8
README file for libgda
======================

GNU Data Access (GDA) is an attempt to provide uniform access to 
different kinds
of data sources (databases, information servers, mail spools, etc).
It is a complete architecture that provides all you need to access
your data.
Rodrigo Moya's avatar
Rodrigo Moya committed
9
It is defined by a set of plugin APIs as generic as possible
Rodrigo Moya's avatar
Rodrigo Moya committed
10 11 12 13
(but very powerful at the same time) so that any kind of data source
can be accessed through them.

libgda is an interface to the GDA architecture, providing a nice
Rodrigo Moya's avatar
Rodrigo Moya committed
14
wrapper around the GDA interfaces, for both the client and the server
Rodrigo Moya's avatar
Rodrigo Moya committed
15 16
parts. It also provides a bunch of tools to help you both in the
development and management of your data sources, all done through
Rodrigo Moya's avatar
Rodrigo Moya committed
17
the GDA model's interfaces.
Rodrigo Moya's avatar
Rodrigo Moya committed
18 19 20 21

libgda was part of the GNOME-DB project (http://www.gnome.org/projects/gnome-db),
but has been separated from it to allow non-GNOME applications to be
developed based on it.
Rodrigo Moya's avatar
Rodrigo Moya committed
22

23 24
The libgda library is released under the terms of the LGPL license,  which
allows for commercial applications to be developed based on libgda. Its 
25
command-line and UI tools are under the GPL.
26

27 28 29 30
See COPYING for the GPL license.
See COPYING.LIB for the LGPL license.


Rodrigo Moya's avatar
Rodrigo Moya committed
31 32 33
Dependencies
------------
To compile libgda, you must have the following packages installed:
Rodrigo Moya's avatar
Rodrigo Moya committed
34
glib 2.0 or newer
35 36
gnome-xml
You can get all these packages from ftp.gnome.org.
Rodrigo Moya's avatar
Rodrigo Moya committed
37 38 39 40

Subdirectories
--------------
doc: the libgda api documentation
Rodrigo Moya's avatar
Rodrigo Moya committed
41
libgda: the actual libgda library
Rodrigo Moya's avatar
Rodrigo Moya committed
42 43 44 45 46
po: translation files for other languages than English
providers: some GDA service providers
tools: useful helper programs
testing: tools for testing and test programs

Rodrigo Moya's avatar
Rodrigo Moya committed
47 48 49 50 51 52 53 54 55 56
Checking your Installation
--------------------------
libgda comes with a test program (gda-test, under the testing/ directory)
which can be used to see if libgda and the providers work correctly. It
is going to be a complete test suite for the libgda installation, and a
diagnostic system that even tells you some hints on how to proceed if an
error occurs.
Use it if, after a successful installation, you're having problems making
libgda work.

Rodrigo Moya's avatar
Rodrigo Moya committed
57 58 59 60 61
Further information
-------------------
libgda comes with a automatic installation tool. For a guide on how to
install libgda, see the file named INSTALL.

62 63 64
Please note that if you use the Git repository the INSTALL file doesn't exist
before you run the autogen.sh script.

Rodrigo Moya's avatar
Rodrigo Moya committed
65
For errors you find in the code or the documentation, please contact
Rodrigo Moya's avatar
Rodrigo Moya committed
66 67
gnome-db-list@gnome.org or the author of the file.