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