mirror of
https://github.com/darlinghq/darling-dbuskit.git
synced 2024-11-23 04:09:42 +00:00
66 lines
2.6 KiB
Plaintext
66 lines
2.6 KiB
Plaintext
@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
|
|
|