The DBusKit framework provides Objective-C applications with bindings for the D-Bus inter-process communication system.
Go to file
2020-09-01 10:04:34 -04:00
Bundles Release preparations 2017-06-13 00:35:51 +02:00
Documentation Release preparations 2017-06-13 00:35:51 +02:00
Examples Release preparations 2017-06-13 00:35:51 +02:00
Headers Darling build 2020-04-16 14:38:18 +03:00
include Darling build 2020-04-16 14:38:18 +03:00
m4 Fixes to link libgcc for atomic operations when needed. 2011-02-28 16:04:54 +00:00
Source Darling build 2020-04-16 14:38:18 +03:00
Tests Format string safety fixes, test case for NSData<->D-Bus byte arrays 2014-01-08 18:27:35 +00:00
Tools Build compatibility tweaks. 2012-08-16 18:37:50 +00:00
.gitignore Darling build 2020-04-16 14:38:18 +03:00
aclocal.m4 Small type safety improvements 2017-05-15 20:24:48 +00:00
ChangeLog * Source/DKArgument.m, 2018-07-27 10:16:41 +02:00
CMakeLists.txt Enable OBJC_OLD_DISPATCH_PROTOTYPES 2020-09-01 10:04:34 -04:00
CODEOWNERS introduce codeowners 2019-11-26 14:28:28 +01:00
config.guess Fixes to link libgcc for atomic operations when needed. 2011-02-28 16:04:54 +00:00
config.make.in Bundle building improvements 2017-05-23 07:05:20 +00:00
config.sub Fixes to link libgcc for atomic operations when needed. 2011-02-28 16:04:54 +00:00
configure Add DBusMenu to the default build if -gui is installed 2017-05-23 18:19:26 +00:00
configure.ac Add DBusMenu to the default build if -gui is installed 2017-05-23 18:19:26 +00:00
COPYING * COPYING: Add LGPL. 2010-08-16 13:47:57 +00:00
GNUmakefile Add DBusMenu to the default build if -gui is installed 2017-05-23 18:19:26 +00:00
GNUmakefile.postamble Reorganise the project so that the tests are built as a separate subproject and 2010-07-14 10:46:23 +00:00
GNUmakefile.preamble Thread safety fixes, started working on generating D-Bus XML introspection data. 2011-05-12 20:32:15 +00:00
INSTALL Release preparations 2017-06-13 00:35:51 +02:00
install-sh Fixes to link libgcc for atomic operations when needed. 2011-02-28 16:04:54 +00:00
ltmain.sh Fixes to link libgcc for atomic operations when needed. 2011-02-28 16:04:54 +00:00
README Release preparations 2017-06-13 00:35:51 +02:00

1 Readme
********

The DBusKit framework provides Objective-C applications with bindings
for the D-Bus inter-process communication system.  It allows Objective-C
applications to transparently access services exposed via D-Bus.

1.1 Build and Install
=====================

Please refer to the 'INSTALL' file for information about dependencies
and instructions about installing the library.

1.2 End-User Services
=====================

Apart from the developer oriented parts, DBusKit ships with two
dynamically loadable bundles that provide interesting services for
desktop systems.  The 'DKUserNotification' bundle is loaded
automatically by the gnustep-base library to integrate with the D-Bus
based desktop notification system.  The 'DBusMenu' bundle is used by the
Gtk theme and allows GNUstep applications to leverage the global menu
bar provided by Ubuntu.

1.3 Mac OS X Support
====================

DBusKit makes use of the typed selectors feature of the Objective-C
runtime.  Since typed selectors are not available in Apple's libobjc,
Mac OS X is not supported by DBusKit.

1.4 Test suite
==============

Execute 'make test=yes' to compile and run the test suite.  This
requires the UnitKit framework from Étoilé and a working D-Bus
installation.

1.5 License
===========

The DBusKit library is covered under the GNU Lesser Public License.
This means you can use it in any program (even non-free programs).  If
you distribute the library along with your program, you must make the
improvements you have made freely available.  You should read the
COPYING file in the root directory of the framework distribution for
more information.  The file 'Source/type_encoding_cases.h' is originally
part of the GNUstep Objective-C runtime and licensed under the MIT
license.  All other files in the 'Bundles', 'Source', 'Headers', and
'Tests' directories are covered under the LGPL.

   The associated tools and examples are covered under the GNU Public
License.  This means if you make changes to these programs, you cannot
charge a fee, other than distribution fees, for others to use the
program.  You should read the COPYING file for more information.  All
files in the 'Examples' and 'Tools' directories are covered under the
GPL.

   The documentation is, unless noted otherwise, licensed under the GNU
Free Documentation License (with no Invariant Sections or Cover Texts).

   Copyright (C) 2010-2014 Free Software Foundation

   Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.