Recreating the Configure Script
-------------------------------

If you need to recreate the configure script, run the bootstrap
script found in the top level directory.  This script will run the
appropriate "auto" tool-chain commands.  Note that this is only
necessary if you modify lower level files such as configure.ac.

Configure Script Options for Development
----------------------------------------

You can use the following options with the configure script during
development:

  ./configure --enable-debug --enable-standards --enable-extra-strict

The --enable-standards and --enable-extra-strict options will add
flags/warnings to the compiler for improved code standards checking.
They are disabled by default to avoid issues due to variations in
compiler versions.  Regardless of the state of these configure script
options, source code files are always compiled with -Wall.

The --enable-extra-standards option (also disabled by default)
provides additional compiler options for code standards checking, but
can generate false positives.  Used sparingly, though, this option may
be helpful.

Debian Packaging
----------------

The directory debian under the top level directory contains files
which will build Debian packages for Kinetophone (currently i386 and
amd64 architectures are supported).  Although the current
configuration will not pass all lintian checks and is not suitable for
use in a repository, it is good enough to generate a precompiled
binary Debian package.  Of course, you must have the appropriate
Debian packaging tools installed to create packages.

To build a binary package use the command:

  debuild -i -us -uc -b -d

To build a source package use the command:

  debuild -i -us -uc -S -d

If you add dependencies to the code, you will need to update the
control file.  To determine dependencies run:

  objdump -p /usr/local/bin/kinetophone_console | grep NEEDED

then for each library listed run:

  dpkg -S libfoo.so.6

Put an entry for each (-dev) package in the Build-Depends field
of the control file.

Experimental DBus Support
-------------------------

You can configure Kinetophone to build an experimental DBus server,
kinetophone_dbus_server, which adds embedded sound recording and
narration capabilities to an application which uses DBus.  The server
supports activation, which you can enable by building and installing
the server.  Currently, there is no movie builder support for DBus.

See the ./src/dbus directory in the distribution's source code for
sample client code and tests of the Kinetophone DBus functionality.

----

Copyright 2011-2012 Roan Trail, Inc.

This file is part of Kinetophone.

Kinetophone is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 2 of the License,
or (at your option) any later version.

Kinetophone is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.  You should have received
a copy of the GNU General Public License along with Kinetophone. If
not, see <http://www.gnu.org/licenses/>.
