Merge "[lib-fix] Fixed return value of kdbus_write_msg Change-Id: Ia3a45a6a79b4078929...

[platform/upstream/dbus.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 22beacb..f2f0122 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,8 +4,10 @@
 Quick start
 ===========
 
 Quick start
 ===========
 

-DBus uses GNU AutoTools for its build system, thus the basic install
-procedure can be summarized as:
+DBus could be build with GNU AutoTools or with cmake for its build system,
+thus the basic install procedure can be summarized as:
+
+with autotools:

 
     ./configure --prefix=/usr
     make
 
     ./configure --prefix=/usr
     make


@@ -13,13 +15,29 @@ procedure can be summarized as:
 
 The configure script will automatically determine whether to try and
 build bindings for GLib, Qt, Qt3, Python and Mono based on what tools
 
 The configure script will automatically determine whether to try and
 build bindings for GLib, Qt, Qt3, Python and Mono based on what tools

-are installed on the host system. The default build behaviour can be 
+are installed on the host system. The default build behaviour can be

 overridden using the --enable-XXX/--disable-XXX arguments to configure.
 A typical scenario in which it is desirable to override automatic
 overridden using the --enable-XXX/--disable-XXX arguments to configure.
 A typical scenario in which it is desirable to override automatic

-detection, is during packaging of binary builds, where a predictable 
-dependancy chain is required. For more details on GNU AutoTools 
+detection, is during packaging of binary builds, where a predictable
+dependancy chain is required. For more details on GNU AutoTools

 installation, consult the generic instructions later in this document
 
 installation, consult the generic instructions later in this document
 

+with cmake:
+    mkdir dbus-build-dir
+    cd dbus-build-dir
+    cmake -G <makefile-generator-name> [-D<option>] <dbus-src-root>/cmake
+    make
+    make install
+
+cmake will automatically determine whether to build some features
+based on what tools and/or libraries are installed on the host system. 
+The default build behaviour can be overridden using the 
+-DENABLE_<XXX> arguments to cmake.
+A typical scenario in which it is desirable to override automatic
+detection, is during packaging of binary builds, where a predictable
+dependancy chain is required. For more details on cmake installation, 
+consult http://www.cmake.org/cmake/help/help.html. 
+

 External software dependancies
 ==============================
 
 External software dependancies
 ==============================
 


@@ -33,65 +51,13 @@ Core library
  Requisite:
 
   - Gettext
  Requisite:
 
   - Gettext

-  - expat or libxml-2
-
- NB, expat is the recommended XML parser because it has more robust
- handling of OOM conditions.
-
- Optional:
-
-  - libselinux  (for SELinux integration)
-  - dnotify     (for automatic service file reload)
-  - doxygen     (for API documentation)
-  - xmlto       (for Spec & other XML documentation)
-
-GLib Bindings
--------------
-
- Requisite:
-
-  - GLib >= 2.4
+  - expat

 
  Optional:
 
 
  Optional:
 

-  - GTK+ >= 2.4  (for dbus-viewer tool)
-
-Qt Bindings
------------
-
- Requisite:
-
-  - Qt >= 4.0
-
- Optional:
-
-  - QtTest   (for Qt Unit tests)
-
-Qt 3 Bindings
--------------
-
- Requisite:
-
-  - Qt >= 3.1
-
-Mono Bindings
--------------
-
- Requisite:
-
-  - Mono >= 0.95
-
- Optional:
-
-  - MonoDoc >= 0.16   (for API documentation)
-
-Python Bindings
----------------
-
- Requisite:
-
-  - Python >= 2.4
-  - Pyrex
+  - libselinux           (for SELinux integration)
+  - doxygen              (for API documentation)
+  - xmlto or meinproc4   (for Spec & other XML documentation)

 
 ====================================================================
 
 
 ====================================================================