You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
67 lines
2.5 KiB
67 lines
2.5 KiB
@c install.texi -- this file is the installation items common to |
|
@c kpathsea-using programs. It's included by kpathsea.texi and dvips.texi. |
|
|
|
@item |
|
@vindex CFLAGS |
|
@flindex paths.make@r{, editing} |
|
Edit the file @file{make/paths.make} if you want to make changes to the |
|
installation directories or paths that will have effect across different |
|
runs of @code{configure}. Alternatively, override the Make variables on |
|
the command line when you run Make. |
|
|
|
@cindex installation directories, changing |
|
Exception: to reliably change the top-level @samp{prefix}, you must give |
|
@samp{configure} the option @samp{-prefix=@var{prefix}}, instead of |
|
changing the value in @file{paths.make}. |
|
|
|
@item |
|
@cindex paths, changing default |
|
Edit @file{kpathsea/texmf.cnf.in} to change the local paths to match your |
|
local setup. @xref{Default paths, , , kpathsea, Kpathsea}, for more |
|
details on changing the paths. A copy is in @file{kpathsea/INSTALL}. |
|
See @file{kpathsea/HIER} for an explanation of the default setup. |
|
|
|
If the paths do not match where the files actually are, the programs |
|
will probably start up Very, Very, Slowly, and/or not be able to find |
|
the fonts or other input files. |
|
|
|
@item |
|
@flindex configure@r{, running} |
|
@flindex CONFIG |
|
@flindex kpathsea/CONFIG |
|
@flindex c-auto.h.in |
|
@flindex Makefile.in |
|
@findex ac_include |
|
@cindex @@@var{var}@@ substitutions |
|
@cindex system dependencies |
|
@code{sh configure} (in the top-level directory). This makes |
|
system-dependent @samp{#define's} in @file{*/c-auto.h} (from the |
|
corresponding @file{c-auto.h.in}) and creates a @file{Makefile} (from |
|
the corresponding @file{Makefile.in}, by doing @samp{@@@var{var}@@} and |
|
@samp{ac_include} substitutions). |
|
|
|
Perhaps the most common desire is to compile with optimization instead |
|
of or as well as debugging. You can change the options passed to the |
|
compiler by changing @samp{CFLAGS}, either for @code{configure} or |
|
@code{make}. For example: |
|
|
|
@example |
|
prompt$ env CFLAGS="-g -O" configure |
|
prompt$ make |
|
@exdent @r{or} |
|
prompt$ configure |
|
prompt$ make CFLAGS="-g -O" |
|
@end example |
|
|
|
@noindent @xref{Invoking configure, , Running @code{configure} scripts, |
|
autoconf, Autoconf}, for detailed @code{configure} options. (A copy is |
|
in @file{kpathsea/CONFIGURE}.) |
|
|
|
@item |
|
@code{make} (still in the top-level directory). Barring configuration |
|
and compiler bugs, this will compile all the programs. @xref{Common |
|
problems, , Common problems, kpathsea, Kpathsea}, for system-dependent |
|
problems (this section is also in @file{kpathsea/INSTALL}). |
|
|
|
This also creates the @file{texmf.cnf} and @file{paths.h} files that |
|
define the default search paths.
|
|
|