#1 Installation notes

[J.A]

I need some help understanding what format is appropriate for submitting documentation on installing Qingy from source.

Below is a write-up that I drafted a few weeks ago, and I would appreciate feedback on what needs improvement:

======================
Dependencies:
- DirectFB (be sure to include support for graphic cards and input devices, such as keyboard/mouse.)
- X11 (you might be able to get by with just installing X11 core libraries. YMMV.)
- crypto (not necessary, but strongly recommended. Options include GnuTLS and OpenSSL.)

Installing:

If you intend to install themes, unpack any themes into newly created themes directory
$ mkdir -v /usr/share/qingy/themes
$ tar -xvf /path/to/qingy-themes-tarball -C /usr/share/qingy/themes

Create build directory, and unpack qingy source into build directory
$ mkdir -v qingy-build
$ cd qingy-build
$ tar -xvf /path/to/qingy-source-tarball

Run configuration script with the following options:
$ ./configure --prefix=/usr --sysconfdir=/etc \ --with-themes-dir=/usr/share/qingy/themes \ --enable-crypto=openssl --disable-pam
$ make
$ make install
$ cd .. && rm -vfr qingy-build

NOTE: If you use Pluggable Authentication Modules (PAM) on your system, be sure to remove the `--disable-pam' option.
NOTE: If you use GnuTLS instead of OpenSSL, be sure to modify the crypto option from `--enable-crypto=openssl' to `--enable-crypto=gnutls'
NOTE: The `--sysconfdir=/etc' option ensures that qingy is prevented from being installed into /usr/etc.

Installing DirectFB:
To use Qingy, DirectFB must already exist on the system. DirectFB in turn depends on X11 being present on the system.
Here are instructions to install DirectFB from source:

$ mkdir -v directfb-build
$ ./configure --prefix=/usr --with-inputdrivers=keyboard,ps2mouse \ --with-smooth-scaling --enable-zlib \ --with-gfxdrivers=nvidia
$ make
$ make install
$ cd .. && rm -vfr directfb-build

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

Thanks!