INSTALL

   1 -- INSTALL for Idesk
   2
   3 Compilation and Installation:
   4 --------------------------------
   5
   6 The simplest way to compile this package is:
   7
   8  $ ./configure
   9  $ make
  10  $ make install
  11
  12    The `configure' shell script attempts to guess correct values for
  13 various system-dependent variables used during compilation.  It uses
  14 those values to create a `Makefile' in the directory src.
  15
  16 Finally, it creates a shell script `config.status' that you can run
  17 in the future to recreate the current configuration, a file
  18 `config.cache' that saves the results of its tests to speed up
  19 reconfiguring, and a file `config.log' containing compiler output
  20 (useful mainly for debugging `configure').
  21
  22    If you need to do unusual things to compile Idesk please try
  23 to figure out how `configure' could check whether to do them, and mail
  24 diffs or instructions to idesk-developers list (see idesk.sourceforge.net)
  25 so they can be considered for the next release.  If at some point
  26 `config.cache' contains results you don't want to keep, you may remove
  27 or edit it.
  28
  29    The file `configure.in' is used to create `configure' by a program
  30 called `autoconf'.  You only need `configure.in' if you want to change
  31 it or regenerate `configure' using a newer version of `autoconf'.
  32
  33 The completed process is:
  34
  35   1. `cd' to the directory containing the package's source code and type
  36      `./configure' to configure the package for your system.  If you're
  37      using `csh' on an old version of System V, you might need to type
  38      `sh ./configure' instead to prevent `csh' from trying to execute
  39      `configure' itself.
  40
  41      Running `configure' takes awhile.  While running, it prints some
  42      messages telling which features it is checking for.
  43
  44   2. Type `make' to compile the package.
  45
  46   3. Type `make install' to install the programs and any data files and
  47      documentation.
  48
  49   4. You can remove the program binaries and object files from the
  50      source code directory by typing `make clean'.  To also remove the
  51      files that `configure' created (so you can compile the package for
  52      a different kind of computer), type `make distclean'.
  53
  54
  55 Compilers and Options:
  56 ----------------------
  57    Some systems require unusual options for compilation or linking that
  58 the `configure' script does not know about.  You can give `configure'
  59 initial values for variables by setting them in the environment.  Using
  60 a Bourne-compatible shell, you can do that on the command line like
  61 this:
  62      CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
  63
  64 Or on systems that have the `env' program, you can do it like this:
  65      env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
  66
  67
  68 Optional Features:
  69 ------------------
  70   Idesk supports the XShape extension of X11R6.  This support is enabled by
  71 default, but may be overridden by specifying `--disable-shape' on the configure
  72 script's command line.
  73
  74   Idesk provides startup notification support. This change the default X cursor for a clock cursor (in wait form), when you click an icon and the application launch, the cursor change and wait for application finished for startup. You need the libraries for startup notification, you can download that from:
  75
  76  http://www.freedesktop.org/software/startup-notification
  77
  78 It is disabled by default, but may be overridden by specifying
  79 '--enable-libsn' on the configure script's command line.
  80
  81 Please read the README file also.