← Back to branch summary

~ubuntu-branches/ubuntu/quantal/autoconf/quantal

« back to all changes in this revision

Viewing changes to doc/install.texi

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2009-12-22 07:46:47 UTC
  • mfrom: (4.1.10 sid)
  • Revision ID: james.westby@ubuntu.com-20091222074647-fj9atp75eecyx7sp
Tags: 2.65-3ubuntu1
Merge with Debian; remaining changes:

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/install.texi
84
84
 
85
85
@item
86
86
Optionally, type @samp{make installcheck} to repeat any self-tests, but
87
 
this time using the binaries in their final installed location.
 
87
this time using the binaries in their final installed location.  This
 
88
target does not install anything.  Running this target as a regular
 
89
user, particularly if the prior @samp{make install} required root
 
90
privileges, verifies that the installation completed correctly.
88
91
 
89
92
@item
90
93
You can remove the program binaries and object files from the source
169
172
You can specify an
170
173
installation prefix other than @file{/usr/local} by giving
171
174
@command{configure} the option @option{--prefix=@var{prefix}}, where
172
 
@var{prefix} must be an absolute path.
 
175
@var{prefix} must be an absolute file name.
173
176
 
174
177
You can specify separate installation prefixes for architecture-specific
175
178
files and architecture-independent files.  If you pass the option
184
187
the directories you can set and what kinds of files go in them.  In
185
188
general, the default for these options is expressed in terms of
186
189
@samp{$@{prefix@}}, so that specifying just @option{--prefix} will
187
 
affect all of the other directory specifications.
 
190
affect all of the other directory specifications that were not
 
191
explicitly provided.
188
192
 
189
193
The most portable way to affect installation locations is to pass the
190
194
correct locations to @command{configure}; however, many packages provide
194
198
 
195
199
The first method involves providing an override variable for each
196
200
affected directory.  For example, @samp{make install
197
 
prefix=/path/to/alternate} will choose an alternate location, as well as
198
 
influencing all other directory configuration variables that were
199
 
expressed in terms of @samp{$@{prefix@}} (or, put another way, all
200
 
directories specified during @command{configure} but not in terms of the
201
 
common prefix must each be overridden at install time for the entire
202
 
installation to be relocated).  The approach of makefile variable
 
201
prefix=/alternate/directory} will choose an alternate location for all
 
202
directory configuration variables that were expressed in terms of
 
203
@samp{$@{prefix@}}.  Any directories that were specified during
 
204
@command{configure}, but not in terms of @samp{$@{prefix@}}, must each be
 
205
overridden at install time for the entire
 
206
installation to be relocated.  The approach of makefile variable
203
207
overrides for each directory variable is required by the @acronym{GNU}
204
208
Coding Standards, and ideally causes no recompilation.  However, some
205
209
platforms have known limitations with the semantics of shared libraries
207
211
noticeable in packages that use @acronym{GNU} Libtool.
208
212
 
209
213
The second method involves providing the @samp{DESTDIR} variable.  For
210
 
example, @samp{make install DESTDIR=/path/to/alternate} will prepend
211
 
@samp{/path/to/alternate} before all installation paths.  The approach
 
214
example, @samp{make install DESTDIR=/alternate/directory} will prepend
 
215
@samp{/alternate/directory} before all installation names.  The approach
212
216
of @samp{DESTDIR} overrides is not required by the @acronym{GNU} Coding
213
217
Standards, and does not work on platforms that have drive letters.  On
214
218
the other hand, it does better at avoiding recompilation issues, and
215
219
works well even when some directory options were not specified in terms
216
 
of @samp{$@{prefix@}} at @command{configure} time.  For packages which
217
 
support @samp{DESTDIR}, the variable should remain undefined during
218
 
@command{configure} and @samp{make all}, and only be specified during
219
 
@samp{make install}.
 
220
of @samp{$@{prefix@}} at @command{configure} time.
220
221
 
221
222
@node Optional Features
222
223
@section Optional Features