|
2331
|
1 @c install.texi -- this file is the installation items common to |
|
|
2 @c kpathsea-using programs. It's included by kpathsea.texi and dvips.texi. |
|
|
3 |
|
|
4 @item |
|
|
5 @vindex CFLAGS |
|
|
6 @flindex paths.make@r{, editing} |
|
|
7 Edit the file @file{make/paths.make} if you want to make changes to the |
|
|
8 installation directories or paths that will have effect across different |
|
|
9 runs of @code{configure}. Alternatively, override the Make variables on |
|
|
10 the command line when you run Make. |
|
|
11 |
|
|
12 @cindex installation directories, changing |
|
|
13 Exception: to reliably change the top-level @samp{prefix}, you must give |
|
|
14 @samp{configure} the option @samp{-prefix=@var{prefix}}, instead of |
|
|
15 changing the value in @file{paths.make}. |
|
|
16 |
|
|
17 @item |
|
|
18 @cindex paths, changing default |
|
|
19 Edit @file{kpathsea/texmf.cnf.in} to change the local paths to match your |
|
|
20 local setup. @xref{Default paths, , , kpathsea, Kpathsea}, for more |
|
|
21 details on changing the paths. A copy is in @file{kpathsea/INSTALL}. |
|
|
22 See @file{kpathsea/HIER} for an explanation of the default setup. |
|
|
23 |
|
|
24 If the paths do not match where the files actually are, the programs |
|
|
25 will probably start up Very, Very, Slowly, and/or not be able to find |
|
|
26 the fonts or other input files. |
|
|
27 |
|
|
28 @item |
|
|
29 @flindex configure@r{, running} |
|
|
30 @flindex CONFIG |
|
|
31 @flindex kpathsea/CONFIG |
|
|
32 @flindex c-auto.h.in |
|
|
33 @flindex Makefile.in |
|
|
34 @findex ac_include |
|
|
35 @cindex @@@var{var}@@ substitutions |
|
|
36 @cindex system dependencies |
|
|
37 @code{sh configure} (in the top-level directory). This makes |
|
|
38 system-dependent @samp{#define's} in @file{*/c-auto.h} (from the |
|
|
39 corresponding @file{c-auto.h.in}) and creates a @file{Makefile} (from |
|
|
40 the corresponding @file{Makefile.in}, by doing @samp{@@@var{var}@@} and |
|
|
41 @samp{ac_include} substitutions). |
|
|
42 |
|
|
43 Perhaps the most common desire is to compile with optimization instead |
|
|
44 of or as well as debugging. You can change the options passed to the |
|
|
45 compiler by changing @samp{CFLAGS}, either for @code{configure} or |
|
|
46 @code{make}. For example: |
|
|
47 |
|
|
48 @example |
|
|
49 prompt$ env CFLAGS="-g -O" configure |
|
|
50 prompt$ make |
|
|
51 @exdent @r{or} |
|
|
52 prompt$ configure |
|
|
53 prompt$ make CFLAGS="-g -O" |
|
|
54 @end example |
|
|
55 |
|
|
56 @noindent @xref{Invoking configure, , Running @code{configure} scripts, |
|
|
57 autoconf, Autoconf}, for detailed @code{configure} options. (A copy is |
|
|
58 in @file{kpathsea/CONFIGURE}.) |
|
|
59 |
|
|
60 @item |
|
|
61 @code{make} (still in the top-level directory). Barring configuration |
|
|
62 and compiler bugs, this will compile all the programs. @xref{Common |
|
|
63 problems, , Common problems, kpathsea, Kpathsea}, for system-dependent |
|
|
64 problems (this section is also in @file{kpathsea/INSTALL}). |
|
|
65 |
|
|
66 This also creates the @file{texmf.cnf} and @file{paths.h} files that |
|
|
67 define the default search paths. |
