darling-dbuskit/Documentation

@chapter 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. 

@section Build and Install

Please refer to the @samp{INSTALL} file for information about
dependencies and instructions about installing the library.

@section End-User Services

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

@section 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.

@section Test suite
Execute @kbd{make test=yes} to compile and run the test suite. This
requires the UnitKit framework from Étoilé and a working D-Bus
installation.

@section 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 @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 @file{Bundles}, @file{Source},
@file{Headers}, and @file{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 @file{Tools} directories are covered under the GPL. The materials
in the @file{Examples} are licensed according to their respective
COPYING files.

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


@ifinfo
Copyright @copyright{} 2010--2017 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.
@end ifinfo