~ubuntu-branches/ubuntu/oneiric/gnome-games-extra-data/oneiric

« back to all changes in this revision

Viewing changes to INSTALL

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge, Josselin Mouette, Sebastian Dröge
  • Date: 2008-03-24 17:14:00 UTC
  • mfrom: (1.1.8 upstream) (2.1.2 lenny)
  • Revision ID: james.westby@ubuntu.com-20080324171400-tso6p0ixgvz80q76
Tags: 2.22.0-1
[ Josselin Mouette ]
* Fix watch file. Closes: #450147.

[ Sebastian Dröge ]
* New upstream stable release.
* debian/control.in:
  + Update Standards-Version to 3.7.3, no additional changes needed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Installation Instructions
2
2
*************************
3
3
 
4
 
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005,
5
 
2006 Free Software Foundation, Inc.
 
4
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005 Free
 
5
Software Foundation, Inc.
6
6
 
7
7
This file is free documentation; the Free Software Foundation gives
8
8
unlimited permission to copy, distribute and modify it.
10
10
Basic Installation
11
11
==================
12
12
 
13
 
Briefly, the shell commands `./configure; make; make install' should
14
 
configure, build, and install this package.  The following
15
 
more-detailed instructions are generic; see the `README' file for
16
 
instructions specific to this package.
 
13
These are generic installation instructions.
17
14
 
18
15
   The `configure' shell script attempts to guess correct values for
19
16
various system-dependent variables used during compilation.  It uses
26
23
 
27
24
   It can also use an optional file (typically called `config.cache'
28
25
and enabled with `--cache-file=config.cache' or simply `-C') that saves
29
 
the results of its tests to speed up reconfiguring.  Caching is
 
26
the results of its tests to speed up reconfiguring.  (Caching is
30
27
disabled by default to prevent problems with accidental use of stale
31
 
cache files.
 
28
cache files.)
32
29
 
33
30
   If you need to do unusual things to compile the package, please try
34
31
to figure out how `configure' could check whether to do them, and mail
38
35
may remove or edit it.
39
36
 
40
37
   The file `configure.ac' (or `configure.in') is used to create
41
 
`configure' by a program called `autoconf'.  You need `configure.ac' if
42
 
you want to change it or regenerate `configure' using a newer version
43
 
of `autoconf'.
 
38
`configure' by a program called `autoconf'.  You only need
 
39
`configure.ac' if you want to change it or regenerate `configure' using
 
40
a newer version of `autoconf'.
44
41
 
45
42
The simplest way to compile this package is:
46
43
 
47
44
  1. `cd' to the directory containing the package's source code and type
48
 
     `./configure' to configure the package for your system.
 
45
     `./configure' to configure the package for your system.  If you're
 
46
     using `csh' on an old version of System V, you might need to type
 
47
     `sh ./configure' instead to prevent `csh' from trying to execute
 
48
     `configure' itself.
49
49
 
50
 
     Running `configure' might take a while.  While running, it prints
51
 
     some messages telling which features it is checking for.
 
50
     Running `configure' takes awhile.  While running, it prints some
 
51
     messages telling which features it is checking for.
52
52
 
53
53
  2. Type `make' to compile the package.
54
54
 
78
78
by setting variables in the command line or in the environment.  Here
79
79
is an example:
80
80
 
81
 
     ./configure CC=c99 CFLAGS=-g LIBS=-lposix
 
81
     ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
82
82
 
83
83
   *Note Defining Variables::, for more details.
84
84
 
87
87
 
88
88
You can compile the package for more than one kind of computer at the
89
89
same time, by placing the object files for each architecture in their
90
 
own directory.  To do this, you can use GNU `make'.  `cd' to the
 
90
own directory.  To do this, you must use a version of `make' that
 
91
supports the `VPATH' variable, such as GNU `make'.  `cd' to the
91
92
directory where you want the object files and executables to go and run
92
93
the `configure' script.  `configure' automatically checks for the
93
94
source code in the directory that `configure' is in and in `..'.
94
95
 
95
 
   With a non-GNU `make', it is safer to compile the package for one
96
 
architecture at a time in the source code directory.  After you have
97
 
installed the package for one architecture, use `make distclean' before
98
 
reconfiguring for another architecture.
 
96
   If you have to use a `make' that does not support the `VPATH'
 
97
variable, you have to compile the package for one architecture at a
 
98
time in the source code directory.  After you have installed the
 
99
package for one architecture, use `make distclean' before reconfiguring
 
100
for another architecture.
99
101
 
100
102
Installation Names
101
103
==================
188
190
     ./configure CC=/usr/local2/bin/gcc
189
191
 
190
192
causes the specified `gcc' to be used as the C compiler (unless it is
191
 
overridden in the site shell script).
192
 
 
193
 
Unfortunately, this technique does not work for `CONFIG_SHELL' due to
194
 
an Autoconf bug.  Until the bug is fixed you can use this workaround:
195
 
 
196
 
     CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash
 
193
overridden in the site shell script).  Here is a another example:
 
194
 
 
195
     /bin/bash ./configure CONFIG_SHELL=/bin/bash
 
196
 
 
197
Here the `CONFIG_SHELL=/bin/bash' operand causes subsequent
 
198
configuration-related scripts to be executed by `/bin/bash'.
197
199
 
198
200
`configure' Invocation
199
201
======================