annotate INSTALL @ 31378:7cbd01b1ed31

propagate from branch 'im.pidgin.pidgin.next.minor' (head 00d82ac80e3aef1bae2cc576f8f909c224c576b4) to branch 'im.pidgin.pidgin' (head f3f071b7cd1383e2303f4b2e04cf11d110da3a78)
author John Bailey <rekkanoryo@rekkanoryo.org>
date Sun, 13 Mar 2011 23:11:32 +0000
parents 5ab7766a6c83
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
1 Basic Installation
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
2 ==================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
3
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
4 These are generic installation instructions.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
5
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
6 The `configure' shell script attempts to guess correct values for
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
7 various system-dependent variables used during compilation. It uses
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
8 those values to create a `Makefile' in each directory of the package.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
9 It may also create one or more `.h' files containing system-dependent
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
10 definitions. Finally, it creates a shell script `config.status' that
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
11 you can run in the future to recreate the current configuration, a file
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
12 `config.cache' that saves the results of its tests to speed up
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
13 reconfiguring, and a file `config.log' containing compiler output
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
14 (useful mainly for debugging `configure').
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
15
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
16 If you need to do unusual things to compile the package, please try
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
17 to figure out how `configure' could check whether to do them, and mail
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
18 diffs or instructions to the address given in the `README' so they can
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
19 be considered for the next release. If at some point `config.cache'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
20 contains results you don't want to keep, you may remove or edit it.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
21
6900
62cafee71373 [gaim-migrate @ 7447]
Luke Schierer <lschiere@pidgin.im>
parents: 0
diff changeset
22 The file `configure.ac' is used to create `configure' by a program
62cafee71373 [gaim-migrate @ 7447]
Luke Schierer <lschiere@pidgin.im>
parents: 0
diff changeset
23 called `autoconf'. You only need `configure.ac' if you want to change
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
24 it or regenerate `configure' using a newer version of `autoconf'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
25
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
26 The simplest way to compile this package is:
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
27
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
28 1. `cd' to the directory containing the package's source code and type
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
29 `./configure' to configure the package for your system. If you're
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
30 using `csh' on an old version of System V, you might need to type
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
31 `sh ./configure' instead to prevent `csh' from trying to execute
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
32 `configure' itself.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
33
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
34 Running `configure' takes awhile. While running, it prints some
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
35 messages telling which features it is checking for. If it finishes
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
36 successfully, it will print out of a summary of the build options.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
37 This summary will also appear in the help->about dialog.
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
38
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
39 2. Type `make' to compile the package. On some systems, you may need
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
40 to use `gmake' instead.
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
41
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
42 3. Optionally, type `make check' to run any self-tests that come with
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
43 the package.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
44
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
45 4. Type `make install' to install the programs and any data files and
20731
712c4b0a4486 provide a hint about needing write access to
Luke Schierer <lschiere@pidgin.im>
parents: 6900
diff changeset
46 documentation. You must have write access to the prefix you are
712c4b0a4486 provide a hint about needing write access to
Luke Schierer <lschiere@pidgin.im>
parents: 6900
diff changeset
47 installing to. See below for more details on the prefix.
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
48
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
49 5. You can remove the program binaries and object files from the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
50 source code directory by typing `make clean'. To also remove the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
51 files that `configure' created (so you can compile the package for
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
52 a different kind of computer), type `make distclean'. There is
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
53 also a `make maintainer-clean' target, but that is intended mainly
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
54 for the package's developers. If you use it, you may have to get
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
55 all sorts of other programs in order to regenerate files that came
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
56 with the distribution.
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
57
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
58 6. If you have *not* run make distclean, you can use the target
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
59 `make uninstall` to remove the files installed by `make install`.
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
60
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
61 Compilers and Options
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
62 =====================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
63
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
64 Some systems require unusual options for compilation or linking that
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
65 the `configure' script does not know about. You can give `configure'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
66 initial values for variables by setting them in the environment. Using
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
67 a Bourne-compatible shell, you can do that on the command line like
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
68 this:
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
69 CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
70
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
71 Or on systems that have the `env' program, you can do it like this:
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
72 env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
73
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
74 Compiling For Multiple Architectures
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
75 ====================================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
76
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
77 You can compile the package for more than one kind of computer at the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
78 same time, by placing the object files for each architecture in their
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
79 own directory. To do this, you must use a version of `make' that
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
80 supports the `VPATH' variable, such as GNU `make'. `cd' to the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
81 directory where you want the object files and executables to go and run
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
82 the `configure' script. `configure' automatically checks for the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
83 source code in the directory that `configure' is in and in `..'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
84
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
85 If you have to use a `make' that does not supports the `VPATH'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
86 variable, you have to compile the package for one architecture at a time
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
87 in the source code directory. After you have installed the package for
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
88 one architecture, use `make distclean' before reconfiguring for another
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
89 architecture.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
90
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
91 Installation Names
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
92 ==================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
93
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
94 By default, `make install' will install the package's files in
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
95 `/usr/local/bin', `/usr/local/man', etc. You can specify an
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
96 installation prefix other than `/usr/local' by giving `configure' the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
97 option `--prefix=PATH'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
98
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
99 You can specify separate installation prefixes for
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
100 architecture-specific files and architecture-independent files. If you
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
101 give `configure' the option `--exec-prefix=PATH', the package will use
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
102 PATH as the prefix for installing programs and libraries.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
103 Documentation and other data files will still use the regular prefix.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
104
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
105 In addition, if you use an unusual directory layout you can give
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
106 options like `--bindir=PATH' to specify different values for particular
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
107 kinds of files. Run `configure --help' for a list of the directories
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
108 you can set and what kinds of files go in them.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
109
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
110 If the package supports it, you can cause programs to be installed
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
111 with an extra prefix or suffix on their names by giving `configure' the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
112 option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
113
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
114 Optional Features
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
115 =================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
116
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
117 Some packages pay attention to `--enable-FEATURE' options to
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
118 `configure', where FEATURE indicates an optional part of the package.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
119 They may also pay attention to `--with-PACKAGE' options, where PACKAGE
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
120 is something like `gnu-as' or `x' (for the X Window System). The
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
121 `README' should mention any `--enable-' and `--with-' options that the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
122 package recognizes.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
123
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
124 For packages that use the X Window System, `configure' can usually
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
125 find the X include and library files automatically, but if it doesn't,
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
126 you can use the `configure' options `--x-includes=DIR' and
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
127 `--x-libraries=DIR' to specify their locations.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
128
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
129 By default both the GTK+ UI (Pidgin) and the ncurses UI (Finch) will be
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
130 built, assuming that configure finds the necessary libraries and headers for
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
131 each. You can disable the GTK+ UI with `--disable-gtkui' and the ncurses UI
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
132 with `--disable-consoleui'.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
133
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
134 `--disable-screensaver' will build libpurple without support for detecting
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
135 when it should mark accounts idle based on mouse or keyboard usage.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
136
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
137 `--disable-sm' will build without support for the X session management.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
138 Doing so will remove the ability to have pidgin start up with your window
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
139 manager.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
140
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
141 `--disable-gtkspell' will remove the ability to highlight misspelled words.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
142
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
143 `--disable-gevolution' will cause the evolution integration plugin not to
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
144 compile.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
145
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
146 `--disable-gstreamer' will build without sound support. This applies to
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
147 *both* Pidgin and Finch.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
148
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
149 `--enable-gnutls=yes,no' will enable or disable the use of gnutls for ssl support. Disabling both gnutls and nss will mean you cannot use either MSN or Google Talk. There is no static option for gnutls at this time.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
150
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
151 `--enable-nss=yes,no,static' will enable or disable the use of nss for ssl support. This is the only option for ssl support if you are attempting to compile a static version of Pidgin or Finch.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
152
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
153 Optional Packages:
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
154
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
155 `--with-silc-includes=DIR' and `--with-silc-libs=DIR' can be used if your silc libraries are installed to a location not in your path.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
156
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
157 `--with-static-prpls' takes a list of comma separated protocols to build in statically (rather than as plugins). Use this with care.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
158
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
159 `--with-dynamic-prpls' takes a list of comma separated protocols also. If used only those listed will be built. If no protocols are listed with either `--with-static-prpls' or with `--with-dynamic-prpls' then Pidgin and Finch will be effectively useless.
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
160
27911
5ab7766a6c83 Add a missing space. I'm sure no one reads this but I noticed it the other day
Etan Reisner <pidgin@unreliablesource.net>
parents: 20764
diff changeset
161 If configure does not find python, it will build without DBUS support. This will disable scripts such as purple-remote and purple-uri-handler, effectively disabling integration with the browser. You can tell configure where your python binary is located with `--with-python=PATH'
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
162
0
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
163 Specifying the System Type
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
164 ==========================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
165
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
166 There may be some features `configure' can not figure out
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
167 automatically, but needs to determine by the type of host the package
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
168 will run on. Usually `configure' can figure that out, but if it prints
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
169 a message saying it can not guess the host type, give it the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
170 `--host=TYPE' option. TYPE can either be a short name for the system
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
171 type, such as `sun4', or a canonical name with three fields:
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
172 CPU-COMPANY-SYSTEM
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
173
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
174 See the file `config.sub' for the possible values of each field. If
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
175 `config.sub' isn't included in this package, then this package doesn't
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
176 need to know the host type.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
177
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
178 If you are building compiler tools for cross-compiling, you can also
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
179 use the `--target=TYPE' option to select the type of system they will
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
180 produce code for and the `--build=TYPE' option to select the type of
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
181 system on which you are compiling the package.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
182
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
183 Sharing Defaults
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
184 ================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
185
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
186 If you want to set default values for `configure' scripts to share,
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
187 you can create a site shell script called `config.site' that gives
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
188 default values for variables like `CC', `cache_file', and `prefix'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
189 `configure' looks for `PREFIX/share/config.site' if it exists, then
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
190 `PREFIX/etc/config.site' if it exists. Or, you can set the
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
191 `CONFIG_SITE' environment variable to the location of the site script.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
192 A warning: not all `configure' scripts look for a site script.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
193
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
194 Operation Controls
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
195 ==================
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
196
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
197 `configure' recognizes the following options to control how it
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
198 operates.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
199
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
200 `--cache-file=FILE'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
201 Use and save the results of the tests in FILE instead of
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
202 `./config.cache'. Set FILE to `/dev/null' to disable caching, for
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
203 debugging `configure'.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
204
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
205 `--help'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
206 Print a summary of the options to `configure', and exit.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
207
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
208 `--quiet'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
209 `--silent'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
210 `-q'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
211 Do not print messages saying which checks are being made. To
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
212 suppress all normal output, redirect it to `/dev/null' (any error
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
213 messages will still be shown).
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
214
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
215 `--srcdir=DIR'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
216 Look for the package's source code in directory DIR. Usually
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
217 `configure' can determine that directory automatically.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
218
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
219 `--version'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
220 Print the version of Autoconf used to generate the `configure'
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
221 script, and exit.
a5ace2e037bc Tailorization
Tailor Script <tailor@pidgin.im>
parents:
diff changeset
222
20764
f46ae7e62d13 I gave up on getting the line widths correct. I also probably have at least one spelling mistake. Still, it might help some over the generic INSTALL we previously had, assuming of course anyone reads it.
Luke Schierer <lschiere@pidgin.im>
parents: 20731
diff changeset
223 `configure' also accepts some other, not widely useful, options. Many of these are related to having various optional libaries installed to locations outside of your path.