/ Hex Artifact Content
Login

Artifact 83e4a25da9fd053c7b3665eaaaf7919707915903:


0000: 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 49 6e 73  Installation Ins
0010: 74 72 75 63 74 69 6f 6e 73 0a 2a 2a 2a 2a 2a 2a  tructions.******
0020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0030: 2a 2a 2a 0a 0a 43 6f 70 79 72 69 67 68 74 20 28  ***..Copyright (
0040: 43 29 20 31 39 39 34 2d 31 39 39 36 2c 20 31 39  C) 1994-1996, 19
0050: 39 39 2d 32 30 30 32 2c 20 32 30 30 34 2d 32 30  99-2002, 2004-20
0060: 31 31 20 46 72 65 65 20 53 6f 66 74 77 61 72 65  11 Free Software
0070: 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 0a 49 6e 63   Foundation,.Inc
0080: 2e 0a 0a 20 20 20 43 6f 70 79 69 6e 67 20 61 6e  ...   Copying an
0090: 64 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 6f  d distribution o
00a0: 66 20 74 68 69 73 20 66 69 6c 65 2c 20 77 69 74  f this file, wit
00b0: 68 20 6f 72 20 77 69 74 68 6f 75 74 20 6d 6f 64  h or without mod
00c0: 69 66 69 63 61 74 69 6f 6e 2c 0a 61 72 65 20 70  ification,.are p
00d0: 65 72 6d 69 74 74 65 64 20 69 6e 20 61 6e 79 20  ermitted in any 
00e0: 6d 65 64 69 75 6d 20 77 69 74 68 6f 75 74 20 72  medium without r
00f0: 6f 79 61 6c 74 79 20 70 72 6f 76 69 64 65 64 20  oyalty provided 
0100: 74 68 65 20 63 6f 70 79 72 69 67 68 74 0a 6e 6f  the copyright.no
0110: 74 69 63 65 20 61 6e 64 20 74 68 69 73 20 6e 6f  tice and this no
0120: 74 69 63 65 20 61 72 65 20 70 72 65 73 65 72 76  tice are preserv
0130: 65 64 2e 20 20 54 68 69 73 20 66 69 6c 65 20 69  ed.  This file i
0140: 73 20 6f 66 66 65 72 65 64 20 61 73 2d 69 73 2c  s offered as-is,
0150: 0a 77 69 74 68 6f 75 74 20 77 61 72 72 61 6e 74  .without warrant
0160: 79 20 6f 66 20 61 6e 79 20 6b 69 6e 64 2e 0a 0a  y of any kind...
0170: 42 61 73 69 63 20 49 6e 73 74 61 6c 6c 61 74 69  Basic Installati
0180: 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  on.=============
0190: 3d 3d 3d 3d 3d 0a 0a 20 20 20 42 72 69 65 66 6c  =====..   Briefl
01a0: 79 2c 20 74 68 65 20 73 68 65 6c 6c 20 63 6f 6d  y, the shell com
01b0: 6d 61 6e 64 73 20 60 2e 2f 63 6f 6e 66 69 67 75  mands `./configu
01c0: 72 65 3b 20 6d 61 6b 65 3b 20 6d 61 6b 65 20 69  re; make; make i
01d0: 6e 73 74 61 6c 6c 27 20 73 68 6f 75 6c 64 0a 63  nstall' should.c
01e0: 6f 6e 66 69 67 75 72 65 2c 20 62 75 69 6c 64 2c  onfigure, build,
01f0: 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 74 68 69   and install thi
0200: 73 20 70 61 63 6b 61 67 65 2e 20 20 54 68 65 20  s package.  The 
0210: 66 6f 6c 6c 6f 77 69 6e 67 0a 6d 6f 72 65 2d 64  following.more-d
0220: 65 74 61 69 6c 65 64 20 69 6e 73 74 72 75 63 74  etailed instruct
0230: 69 6f 6e 73 20 61 72 65 20 67 65 6e 65 72 69 63  ions are generic
0240: 3b 20 73 65 65 20 74 68 65 20 60 52 45 41 44 4d  ; see the `READM
0250: 45 27 20 66 69 6c 65 20 66 6f 72 0a 69 6e 73 74  E' file for.inst
0260: 72 75 63 74 69 6f 6e 73 20 73 70 65 63 69 66 69  ructions specifi
0270: 63 20 74 6f 20 74 68 69 73 20 70 61 63 6b 61 67  c to this packag
0280: 65 2e 20 20 53 6f 6d 65 20 70 61 63 6b 61 67 65  e.  Some package
0290: 73 20 70 72 6f 76 69 64 65 20 74 68 69 73 0a 60  s provide this.`
02a0: 49 4e 53 54 41 4c 4c 27 20 66 69 6c 65 20 62 75  INSTALL' file bu
02b0: 74 20 64 6f 20 6e 6f 74 20 69 6d 70 6c 65 6d 65  t do not impleme
02c0: 6e 74 20 61 6c 6c 20 6f 66 20 74 68 65 20 66 65  nt all of the fe
02d0: 61 74 75 72 65 73 20 64 6f 63 75 6d 65 6e 74 65  atures documente
02e0: 64 0a 62 65 6c 6f 77 2e 20 20 54 68 65 20 6c 61  d.below.  The la
02f0: 63 6b 20 6f 66 20 61 6e 20 6f 70 74 69 6f 6e 61  ck of an optiona
0300: 6c 20 66 65 61 74 75 72 65 20 69 6e 20 61 20 67  l feature in a g
0310: 69 76 65 6e 20 70 61 63 6b 61 67 65 20 69 73 20  iven package is 
0320: 6e 6f 74 0a 6e 65 63 65 73 73 61 72 69 6c 79 20  not.necessarily 
0330: 61 20 62 75 67 2e 20 20 4d 6f 72 65 20 72 65 63  a bug.  More rec
0340: 6f 6d 6d 65 6e 64 61 74 69 6f 6e 73 20 66 6f 72  ommendations for
0350: 20 47 4e 55 20 70 61 63 6b 61 67 65 73 20 63 61   GNU packages ca
0360: 6e 20 62 65 20 66 6f 75 6e 64 0a 69 6e 20 2a 6e  n be found.in *n
0370: 6f 74 65 20 4d 61 6b 65 66 69 6c 65 20 43 6f 6e  ote Makefile Con
0380: 76 65 6e 74 69 6f 6e 73 3a 20 28 73 74 61 6e 64  ventions: (stand
0390: 61 72 64 73 29 4d 61 6b 65 66 69 6c 65 20 43 6f  ards)Makefile Co
03a0: 6e 76 65 6e 74 69 6f 6e 73 2e 0a 0a 20 20 20 54  nventions...   T
03b0: 68 65 20 60 63 6f 6e 66 69 67 75 72 65 27 20 73  he `configure' s
03c0: 68 65 6c 6c 20 73 63 72 69 70 74 20 61 74 74 65  hell script atte
03d0: 6d 70 74 73 20 74 6f 20 67 75 65 73 73 20 63 6f  mpts to guess co
03e0: 72 72 65 63 74 20 76 61 6c 75 65 73 20 66 6f 72  rrect values for
03f0: 0a 76 61 72 69 6f 75 73 20 73 79 73 74 65 6d 2d  .various system-
0400: 64 65 70 65 6e 64 65 6e 74 20 76 61 72 69 61 62  dependent variab
0410: 6c 65 73 20 75 73 65 64 20 64 75 72 69 6e 67 20  les used during 
0420: 63 6f 6d 70 69 6c 61 74 69 6f 6e 2e 20 20 49 74  compilation.  It
0430: 20 75 73 65 73 0a 74 68 6f 73 65 20 76 61 6c 75   uses.those valu
0440: 65 73 20 74 6f 20 63 72 65 61 74 65 20 61 20 60  es to create a `
0450: 4d 61 6b 65 66 69 6c 65 27 20 69 6e 20 65 61 63  Makefile' in eac
0460: 68 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74  h directory of t
0470: 68 65 20 70 61 63 6b 61 67 65 2e 0a 49 74 20 6d  he package..It m
0480: 61 79 20 61 6c 73 6f 20 63 72 65 61 74 65 20 6f  ay also create o
0490: 6e 65 20 6f 72 20 6d 6f 72 65 20 60 2e 68 27 20  ne or more `.h' 
04a0: 66 69 6c 65 73 20 63 6f 6e 74 61 69 6e 69 6e 67  files containing
04b0: 20 73 79 73 74 65 6d 2d 64 65 70 65 6e 64 65 6e   system-dependen
04c0: 74 0a 64 65 66 69 6e 69 74 69 6f 6e 73 2e 20 20  t.definitions.  
04d0: 46 69 6e 61 6c 6c 79 2c 20 69 74 20 63 72 65 61  Finally, it crea
04e0: 74 65 73 20 61 20 73 68 65 6c 6c 20 73 63 72 69  tes a shell scri
04f0: 70 74 20 60 63 6f 6e 66 69 67 2e 73 74 61 74 75  pt `config.statu
0500: 73 27 20 74 68 61 74 0a 79 6f 75 20 63 61 6e 20  s' that.you can 
0510: 72 75 6e 20 69 6e 20 74 68 65 20 66 75 74 75 72  run in the futur
0520: 65 20 74 6f 20 72 65 63 72 65 61 74 65 20 74 68  e to recreate th
0530: 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 66 69 67  e current config
0540: 75 72 61 74 69 6f 6e 2c 20 61 6e 64 20 61 0a 66  uration, and a.f
0550: 69 6c 65 20 60 63 6f 6e 66 69 67 2e 6c 6f 67 27  ile `config.log'
0560: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 6f 6d 70   containing comp
0570: 69 6c 65 72 20 6f 75 74 70 75 74 20 28 75 73 65  iler output (use
0580: 66 75 6c 20 6d 61 69 6e 6c 79 20 66 6f 72 0a 64  ful mainly for.d
0590: 65 62 75 67 67 69 6e 67 20 60 63 6f 6e 66 69 67  ebugging `config
05a0: 75 72 65 27 29 2e 0a 0a 20 20 20 49 74 20 63 61  ure')...   It ca
05b0: 6e 20 61 6c 73 6f 20 75 73 65 20 61 6e 20 6f 70  n also use an op
05c0: 74 69 6f 6e 61 6c 20 66 69 6c 65 20 28 74 79 70  tional file (typ
05d0: 69 63 61 6c 6c 79 20 63 61 6c 6c 65 64 20 60 63  ically called `c
05e0: 6f 6e 66 69 67 2e 63 61 63 68 65 27 0a 61 6e 64  onfig.cache'.and
05f0: 20 65 6e 61 62 6c 65 64 20 77 69 74 68 20 60 2d   enabled with `-
0600: 2d 63 61 63 68 65 2d 66 69 6c 65 3d 63 6f 6e 66  -cache-file=conf
0610: 69 67 2e 63 61 63 68 65 27 20 6f 72 20 73 69 6d  ig.cache' or sim
0620: 70 6c 79 20 60 2d 43 27 29 20 74 68 61 74 20 73  ply `-C') that s
0630: 61 76 65 73 0a 74 68 65 20 72 65 73 75 6c 74 73  aves.the results
0640: 20 6f 66 20 69 74 73 20 74 65 73 74 73 20 74 6f   of its tests to
0650: 20 73 70 65 65 64 20 75 70 20 72 65 63 6f 6e 66   speed up reconf
0660: 69 67 75 72 69 6e 67 2e 20 20 43 61 63 68 69 6e  iguring.  Cachin
0670: 67 20 69 73 0a 64 69 73 61 62 6c 65 64 20 62 79  g is.disabled by
0680: 20 64 65 66 61 75 6c 74 20 74 6f 20 70 72 65 76   default to prev
0690: 65 6e 74 20 70 72 6f 62 6c 65 6d 73 20 77 69 74  ent problems wit
06a0: 68 20 61 63 63 69 64 65 6e 74 61 6c 20 75 73 65  h accidental use
06b0: 20 6f 66 20 73 74 61 6c 65 0a 63 61 63 68 65 20   of stale.cache 
06c0: 66 69 6c 65 73 2e 0a 0a 20 20 20 49 66 20 79 6f  files...   If yo
06d0: 75 20 6e 65 65 64 20 74 6f 20 64 6f 20 75 6e 75  u need to do unu
06e0: 73 75 61 6c 20 74 68 69 6e 67 73 20 74 6f 20 63  sual things to c
06f0: 6f 6d 70 69 6c 65 20 74 68 65 20 70 61 63 6b 61  ompile the packa
0700: 67 65 2c 20 70 6c 65 61 73 65 20 74 72 79 0a 74  ge, please try.t
0710: 6f 20 66 69 67 75 72 65 20 6f 75 74 20 68 6f 77  o figure out how
0720: 20 60 63 6f 6e 66 69 67 75 72 65 27 20 63 6f 75   `configure' cou
0730: 6c 64 20 63 68 65 63 6b 20 77 68 65 74 68 65 72  ld check whether
0740: 20 74 6f 20 64 6f 20 74 68 65 6d 2c 20 61 6e 64   to do them, and
0750: 20 6d 61 69 6c 0a 64 69 66 66 73 20 6f 72 20 69   mail.diffs or i
0760: 6e 73 74 72 75 63 74 69 6f 6e 73 20 74 6f 20 74  nstructions to t
0770: 68 65 20 61 64 64 72 65 73 73 20 67 69 76 65 6e  he address given
0780: 20 69 6e 20 74 68 65 20 60 52 45 41 44 4d 45 27   in the `README'
0790: 20 73 6f 20 74 68 65 79 20 63 61 6e 0a 62 65 20   so they can.be 
07a0: 63 6f 6e 73 69 64 65 72 65 64 20 66 6f 72 20 74  considered for t
07b0: 68 65 20 6e 65 78 74 20 72 65 6c 65 61 73 65 2e  he next release.
07c0: 20 20 49 66 20 79 6f 75 20 61 72 65 20 75 73 69    If you are usi
07d0: 6e 67 20 74 68 65 20 63 61 63 68 65 2c 20 61 6e  ng the cache, an
07e0: 64 20 61 74 0a 73 6f 6d 65 20 70 6f 69 6e 74 20  d at.some point 
07f0: 60 63 6f 6e 66 69 67 2e 63 61 63 68 65 27 20 63  `config.cache' c
0800: 6f 6e 74 61 69 6e 73 20 72 65 73 75 6c 74 73 20  ontains results 
0810: 79 6f 75 20 64 6f 6e 27 74 20 77 61 6e 74 20 74  you don't want t
0820: 6f 20 6b 65 65 70 2c 20 79 6f 75 0a 6d 61 79 20  o keep, you.may 
0830: 72 65 6d 6f 76 65 20 6f 72 20 65 64 69 74 20 69  remove or edit i
0840: 74 2e 0a 0a 20 20 20 54 68 65 20 66 69 6c 65 20  t...   The file 
0850: 60 63 6f 6e 66 69 67 75 72 65 2e 61 63 27 20 28  `configure.ac' (
0860: 6f 72 20 60 63 6f 6e 66 69 67 75 72 65 2e 69 6e  or `configure.in
0870: 27 29 20 69 73 20 75 73 65 64 20 74 6f 20 63 72  ') is used to cr
0880: 65 61 74 65 0a 60 63 6f 6e 66 69 67 75 72 65 27  eate.`configure'
0890: 20 62 79 20 61 20 70 72 6f 67 72 61 6d 20 63 61   by a program ca
08a0: 6c 6c 65 64 20 60 61 75 74 6f 63 6f 6e 66 27 2e  lled `autoconf'.
08b0: 20 20 59 6f 75 20 6e 65 65 64 20 60 63 6f 6e 66    You need `conf
08c0: 69 67 75 72 65 2e 61 63 27 20 69 66 0a 79 6f 75  igure.ac' if.you
08d0: 20 77 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 20   want to change 
08e0: 69 74 20 6f 72 20 72 65 67 65 6e 65 72 61 74 65  it or regenerate
08f0: 20 60 63 6f 6e 66 69 67 75 72 65 27 20 75 73 69   `configure' usi
0900: 6e 67 20 61 20 6e 65 77 65 72 20 76 65 72 73 69  ng a newer versi
0910: 6f 6e 0a 6f 66 20 60 61 75 74 6f 63 6f 6e 66 27  on.of `autoconf'
0920: 2e 0a 0a 20 20 20 54 68 65 20 73 69 6d 70 6c 65  ...   The simple
0930: 73 74 20 77 61 79 20 74 6f 20 63 6f 6d 70 69 6c  st way to compil
0940: 65 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 69  e this package i
0950: 73 3a 0a 0a 20 20 31 2e 20 60 63 64 27 20 74 6f  s:..  1. `cd' to
0960: 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 63   the directory c
0970: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 70 61  ontaining the pa
0980: 63 6b 61 67 65 27 73 20 73 6f 75 72 63 65 20 63  ckage's source c
0990: 6f 64 65 20 61 6e 64 20 74 79 70 65 0a 20 20 20  ode and type.   
09a0: 20 20 60 2e 2f 63 6f 6e 66 69 67 75 72 65 27 20    `./configure' 
09b0: 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65  to configure the
09c0: 20 70 61 63 6b 61 67 65 20 66 6f 72 20 79 6f 75   package for you
09d0: 72 20 73 79 73 74 65 6d 2e 0a 0a 20 20 20 20 20  r system...     
09e0: 52 75 6e 6e 69 6e 67 20 60 63 6f 6e 66 69 67 75  Running `configu
09f0: 72 65 27 20 6d 69 67 68 74 20 74 61 6b 65 20 61  re' might take a
0a00: 20 77 68 69 6c 65 2e 20 20 57 68 69 6c 65 20 72   while.  While r
0a10: 75 6e 6e 69 6e 67 2c 20 69 74 20 70 72 69 6e 74  unning, it print
0a20: 73 0a 20 20 20 20 20 73 6f 6d 65 20 6d 65 73 73  s.     some mess
0a30: 61 67 65 73 20 74 65 6c 6c 69 6e 67 20 77 68 69  ages telling whi
0a40: 63 68 20 66 65 61 74 75 72 65 73 20 69 74 20 69  ch features it i
0a50: 73 20 63 68 65 63 6b 69 6e 67 20 66 6f 72 2e 0a  s checking for..
0a60: 0a 20 20 32 2e 20 54 79 70 65 20 60 6d 61 6b 65  .  2. Type `make
0a70: 27 20 74 6f 20 63 6f 6d 70 69 6c 65 20 74 68 65  ' to compile the
0a80: 20 70 61 63 6b 61 67 65 2e 0a 0a 20 20 33 2e 20   package...  3. 
0a90: 4f 70 74 69 6f 6e 61 6c 6c 79 2c 20 74 79 70 65  Optionally, type
0aa0: 20 60 6d 61 6b 65 20 63 68 65 63 6b 27 20 74 6f   `make check' to
0ab0: 20 72 75 6e 20 61 6e 79 20 73 65 6c 66 2d 74 65   run any self-te
0ac0: 73 74 73 20 74 68 61 74 20 63 6f 6d 65 20 77 69  sts that come wi
0ad0: 74 68 0a 20 20 20 20 20 74 68 65 20 70 61 63 6b  th.     the pack
0ae0: 61 67 65 2c 20 67 65 6e 65 72 61 6c 6c 79 20 75  age, generally u
0af0: 73 69 6e 67 20 74 68 65 20 6a 75 73 74 2d 62 75  sing the just-bu
0b00: 69 6c 74 20 75 6e 69 6e 73 74 61 6c 6c 65 64 20  ilt uninstalled 
0b10: 62 69 6e 61 72 69 65 73 2e 0a 0a 20 20 34 2e 20  binaries...  4. 
0b20: 54 79 70 65 20 60 6d 61 6b 65 20 69 6e 73 74 61  Type `make insta
0b30: 6c 6c 27 20 74 6f 20 69 6e 73 74 61 6c 6c 20 74  ll' to install t
0b40: 68 65 20 70 72 6f 67 72 61 6d 73 20 61 6e 64 20  he programs and 
0b50: 61 6e 79 20 64 61 74 61 20 66 69 6c 65 73 20 61  any data files a
0b60: 6e 64 0a 20 20 20 20 20 64 6f 63 75 6d 65 6e 74  nd.     document
0b70: 61 74 69 6f 6e 2e 20 20 57 68 65 6e 20 69 6e 73  ation.  When ins
0b80: 74 61 6c 6c 69 6e 67 20 69 6e 74 6f 20 61 20 70  talling into a p
0b90: 72 65 66 69 78 20 6f 77 6e 65 64 20 62 79 20 72  refix owned by r
0ba0: 6f 6f 74 2c 20 69 74 20 69 73 0a 20 20 20 20 20  oot, it is.     
0bb0: 72 65 63 6f 6d 6d 65 6e 64 65 64 20 74 68 61 74  recommended that
0bc0: 20 74 68 65 20 70 61 63 6b 61 67 65 20 62 65 20   the package be 
0bd0: 63 6f 6e 66 69 67 75 72 65 64 20 61 6e 64 20 62  configured and b
0be0: 75 69 6c 74 20 61 73 20 61 20 72 65 67 75 6c 61  uilt as a regula
0bf0: 72 0a 20 20 20 20 20 75 73 65 72 2c 20 61 6e 64  r.     user, and
0c00: 20 6f 6e 6c 79 20 74 68 65 20 60 6d 61 6b 65 20   only the `make 
0c10: 69 6e 73 74 61 6c 6c 27 20 70 68 61 73 65 20 65  install' phase e
0c20: 78 65 63 75 74 65 64 20 77 69 74 68 20 72 6f 6f  xecuted with roo
0c30: 74 0a 20 20 20 20 20 70 72 69 76 69 6c 65 67 65  t.     privilege
0c40: 73 2e 0a 0a 20 20 35 2e 20 4f 70 74 69 6f 6e 61  s...  5. Optiona
0c50: 6c 6c 79 2c 20 74 79 70 65 20 60 6d 61 6b 65 20  lly, type `make 
0c60: 69 6e 73 74 61 6c 6c 63 68 65 63 6b 27 20 74 6f  installcheck' to
0c70: 20 72 65 70 65 61 74 20 61 6e 79 20 73 65 6c 66   repeat any self
0c80: 2d 74 65 73 74 73 2c 20 62 75 74 0a 20 20 20 20  -tests, but.    
0c90: 20 74 68 69 73 20 74 69 6d 65 20 75 73 69 6e 67   this time using
0ca0: 20 74 68 65 20 62 69 6e 61 72 69 65 73 20 69 6e   the binaries in
0cb0: 20 74 68 65 69 72 20 66 69 6e 61 6c 20 69 6e 73   their final ins
0cc0: 74 61 6c 6c 65 64 20 6c 6f 63 61 74 69 6f 6e 2e  talled location.
0cd0: 0a 20 20 20 20 20 54 68 69 73 20 74 61 72 67 65  .     This targe
0ce0: 74 20 64 6f 65 73 20 6e 6f 74 20 69 6e 73 74 61  t does not insta
0cf0: 6c 6c 20 61 6e 79 74 68 69 6e 67 2e 20 20 52 75  ll anything.  Ru
0d00: 6e 6e 69 6e 67 20 74 68 69 73 20 74 61 72 67 65  nning this targe
0d10: 74 20 61 73 20 61 0a 20 20 20 20 20 72 65 67 75  t as a.     regu
0d20: 6c 61 72 20 75 73 65 72 2c 20 70 61 72 74 69 63  lar user, partic
0d30: 75 6c 61 72 6c 79 20 69 66 20 74 68 65 20 70 72  ularly if the pr
0d40: 69 6f 72 20 60 6d 61 6b 65 20 69 6e 73 74 61 6c  ior `make instal
0d50: 6c 27 20 72 65 71 75 69 72 65 64 0a 20 20 20 20  l' required.    
0d60: 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73   root privileges
0d70: 2c 20 76 65 72 69 66 69 65 73 20 74 68 61 74 20  , verifies that 
0d80: 74 68 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e  the installation
0d90: 20 63 6f 6d 70 6c 65 74 65 64 0a 20 20 20 20 20   completed.     
0da0: 63 6f 72 72 65 63 74 6c 79 2e 0a 0a 20 20 36 2e  correctly...  6.
0db0: 20 59 6f 75 20 63 61 6e 20 72 65 6d 6f 76 65 20   You can remove 
0dc0: 74 68 65 20 70 72 6f 67 72 61 6d 20 62 69 6e 61  the program bina
0dd0: 72 69 65 73 20 61 6e 64 20 6f 62 6a 65 63 74 20  ries and object 
0de0: 66 69 6c 65 73 20 66 72 6f 6d 20 74 68 65 0a 20  files from the. 
0df0: 20 20 20 20 73 6f 75 72 63 65 20 63 6f 64 65 20      source code 
0e00: 64 69 72 65 63 74 6f 72 79 20 62 79 20 74 79 70  directory by typ
0e10: 69 6e 67 20 60 6d 61 6b 65 20 63 6c 65 61 6e 27  ing `make clean'
0e20: 2e 20 20 54 6f 20 61 6c 73 6f 20 72 65 6d 6f 76  .  To also remov
0e30: 65 20 74 68 65 0a 20 20 20 20 20 66 69 6c 65 73  e the.     files
0e40: 20 74 68 61 74 20 60 63 6f 6e 66 69 67 75 72 65   that `configure
0e50: 27 20 63 72 65 61 74 65 64 20 28 73 6f 20 79 6f  ' created (so yo
0e60: 75 20 63 61 6e 20 63 6f 6d 70 69 6c 65 20 74 68  u can compile th
0e70: 65 20 70 61 63 6b 61 67 65 20 66 6f 72 0a 20 20  e package for.  
0e80: 20 20 20 61 20 64 69 66 66 65 72 65 6e 74 20 6b     a different k
0e90: 69 6e 64 20 6f 66 20 63 6f 6d 70 75 74 65 72 29  ind of computer)
0ea0: 2c 20 74 79 70 65 20 60 6d 61 6b 65 20 64 69 73  , type `make dis
0eb0: 74 63 6c 65 61 6e 27 2e 20 20 54 68 65 72 65 20  tclean'.  There 
0ec0: 69 73 0a 20 20 20 20 20 61 6c 73 6f 20 61 20 60  is.     also a `
0ed0: 6d 61 6b 65 20 6d 61 69 6e 74 61 69 6e 65 72 2d  make maintainer-
0ee0: 63 6c 65 61 6e 27 20 74 61 72 67 65 74 2c 20 62  clean' target, b
0ef0: 75 74 20 74 68 61 74 20 69 73 20 69 6e 74 65 6e  ut that is inten
0f00: 64 65 64 20 6d 61 69 6e 6c 79 0a 20 20 20 20 20  ded mainly.     
0f10: 66 6f 72 20 74 68 65 20 70 61 63 6b 61 67 65 27  for the package'
0f20: 73 20 64 65 76 65 6c 6f 70 65 72 73 2e 20 20 49  s developers.  I
0f30: 66 20 79 6f 75 20 75 73 65 20 69 74 2c 20 79 6f  f you use it, yo
0f40: 75 20 6d 61 79 20 68 61 76 65 20 74 6f 20 67 65  u may have to ge
0f50: 74 0a 20 20 20 20 20 61 6c 6c 20 73 6f 72 74 73  t.     all sorts
0f60: 20 6f 66 20 6f 74 68 65 72 20 70 72 6f 67 72 61   of other progra
0f70: 6d 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 72  ms in order to r
0f80: 65 67 65 6e 65 72 61 74 65 20 66 69 6c 65 73 20  egenerate files 
0f90: 74 68 61 74 20 63 61 6d 65 0a 20 20 20 20 20 77  that came.     w
0fa0: 69 74 68 20 74 68 65 20 64 69 73 74 72 69 62 75  ith the distribu
0fb0: 74 69 6f 6e 2e 0a 0a 20 20 37 2e 20 4f 66 74 65  tion...  7. Ofte
0fc0: 6e 2c 20 79 6f 75 20 63 61 6e 20 61 6c 73 6f 20  n, you can also 
0fd0: 74 79 70 65 20 60 6d 61 6b 65 20 75 6e 69 6e 73  type `make unins
0fe0: 74 61 6c 6c 27 20 74 6f 20 72 65 6d 6f 76 65 20  tall' to remove 
0ff0: 74 68 65 20 69 6e 73 74 61 6c 6c 65 64 0a 20 20  the installed.  
1000: 20 20 20 66 69 6c 65 73 20 61 67 61 69 6e 2e 20     files again. 
1010: 20 49 6e 20 70 72 61 63 74 69 63 65 2c 20 6e 6f   In practice, no
1020: 74 20 61 6c 6c 20 70 61 63 6b 61 67 65 73 20 68  t all packages h
1030: 61 76 65 20 74 65 73 74 65 64 20 74 68 61 74 0a  ave tested that.
1040: 20 20 20 20 20 75 6e 69 6e 73 74 61 6c 6c 61 74       uninstallat
1050: 69 6f 6e 20 77 6f 72 6b 73 20 63 6f 72 72 65 63  ion works correc
1060: 74 6c 79 2c 20 65 76 65 6e 20 74 68 6f 75 67 68  tly, even though
1070: 20 69 74 20 69 73 20 72 65 71 75 69 72 65 64 20   it is required 
1080: 62 79 20 74 68 65 0a 20 20 20 20 20 47 4e 55 20  by the.     GNU 
1090: 43 6f 64 69 6e 67 20 53 74 61 6e 64 61 72 64 73  Coding Standards
10a0: 2e 0a 0a 20 20 38 2e 20 53 6f 6d 65 20 70 61 63  ...  8. Some pac
10b0: 6b 61 67 65 73 2c 20 70 61 72 74 69 63 75 6c 61  kages, particula
10c0: 72 6c 79 20 74 68 6f 73 65 20 74 68 61 74 20 75  rly those that u
10d0: 73 65 20 41 75 74 6f 6d 61 6b 65 2c 20 70 72 6f  se Automake, pro
10e0: 76 69 64 65 20 60 6d 61 6b 65 0a 20 20 20 20 20  vide `make.     
10f0: 64 69 73 74 63 68 65 63 6b 27 2c 20 77 68 69 63  distcheck', whic
1100: 68 20 63 61 6e 20 62 79 20 75 73 65 64 20 62 79  h can by used by
1110: 20 64 65 76 65 6c 6f 70 65 72 73 20 74 6f 20 74   developers to t
1120: 65 73 74 20 74 68 61 74 20 61 6c 6c 20 6f 74 68  est that all oth
1130: 65 72 0a 20 20 20 20 20 74 61 72 67 65 74 73 20  er.     targets 
1140: 6c 69 6b 65 20 60 6d 61 6b 65 20 69 6e 73 74 61  like `make insta
1150: 6c 6c 27 20 61 6e 64 20 60 6d 61 6b 65 20 75 6e  ll' and `make un
1160: 69 6e 73 74 61 6c 6c 27 20 77 6f 72 6b 20 63 6f  install' work co
1170: 72 72 65 63 74 6c 79 2e 0a 20 20 20 20 20 54 68  rrectly..     Th
1180: 69 73 20 74 61 72 67 65 74 20 69 73 20 67 65 6e  is target is gen
1190: 65 72 61 6c 6c 79 20 6e 6f 74 20 72 75 6e 20 62  erally not run b
11a0: 79 20 65 6e 64 20 75 73 65 72 73 2e 0a 0a 43 6f  y end users...Co
11b0: 6d 70 69 6c 65 72 73 20 61 6e 64 20 4f 70 74 69  mpilers and Opti
11c0: 6f 6e 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ons.============
11d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 53 6f  =========..   So
11e0: 6d 65 20 73 79 73 74 65 6d 73 20 72 65 71 75 69  me systems requi
11f0: 72 65 20 75 6e 75 73 75 61 6c 20 6f 70 74 69 6f  re unusual optio
1200: 6e 73 20 66 6f 72 20 63 6f 6d 70 69 6c 61 74 69  ns for compilati
1210: 6f 6e 20 6f 72 20 6c 69 6e 6b 69 6e 67 20 74 68  on or linking th
1220: 61 74 0a 74 68 65 20 60 63 6f 6e 66 69 67 75 72  at.the `configur
1230: 65 27 20 73 63 72 69 70 74 20 64 6f 65 73 20 6e  e' script does n
1240: 6f 74 20 6b 6e 6f 77 20 61 62 6f 75 74 2e 20 20  ot know about.  
1250: 52 75 6e 20 60 2e 2f 63 6f 6e 66 69 67 75 72 65  Run `./configure
1260: 20 2d 2d 68 65 6c 70 27 0a 66 6f 72 20 64 65 74   --help'.for det
1270: 61 69 6c 73 20 6f 6e 20 73 6f 6d 65 20 6f 66 20  ails on some of 
1280: 74 68 65 20 70 65 72 74 69 6e 65 6e 74 20 65 6e  the pertinent en
1290: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
12a0: 6c 65 73 2e 0a 0a 20 20 20 59 6f 75 20 63 61 6e  les...   You can
12b0: 20 67 69 76 65 20 60 63 6f 6e 66 69 67 75 72 65   give `configure
12c0: 27 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 73  ' initial values
12d0: 20 66 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69   for configurati
12e0: 6f 6e 20 70 61 72 61 6d 65 74 65 72 73 0a 62 79  on parameters.by
12f0: 20 73 65 74 74 69 6e 67 20 76 61 72 69 61 62 6c   setting variabl
1300: 65 73 20 69 6e 20 74 68 65 20 63 6f 6d 6d 61 6e  es in the comman
1310: 64 20 6c 69 6e 65 20 6f 72 20 69 6e 20 74 68 65  d line or in the
1320: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e 20 20 48   environment.  H
1330: 65 72 65 0a 69 73 20 61 6e 20 65 78 61 6d 70 6c  ere.is an exampl
1340: 65 3a 0a 0a 20 20 20 20 20 2e 2f 63 6f 6e 66 69  e:..     ./confi
1350: 67 75 72 65 20 43 43 3d 63 39 39 20 43 46 4c 41  gure CC=c99 CFLA
1360: 47 53 3d 2d 67 20 4c 49 42 53 3d 2d 6c 70 6f 73  GS=-g LIBS=-lpos
1370: 69 78 0a 0a 20 20 20 2a 4e 6f 74 65 20 44 65 66  ix..   *Note Def
1380: 69 6e 69 6e 67 20 56 61 72 69 61 62 6c 65 73 3a  ining Variables:
1390: 3a 2c 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61  :, for more deta
13a0: 69 6c 73 2e 0a 0a 43 6f 6d 70 69 6c 69 6e 67 20  ils...Compiling 
13b0: 46 6f 72 20 4d 75 6c 74 69 70 6c 65 20 41 72 63  For Multiple Arc
13c0: 68 69 74 65 63 74 75 72 65 73 0a 3d 3d 3d 3d 3d  hitectures.=====
13d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
13e0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a  ===============.
13f0: 0a 20 20 20 59 6f 75 20 63 61 6e 20 63 6f 6d 70  .   You can comp
1400: 69 6c 65 20 74 68 65 20 70 61 63 6b 61 67 65 20  ile the package 
1410: 66 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e  for more than on
1420: 65 20 6b 69 6e 64 20 6f 66 20 63 6f 6d 70 75 74  e kind of comput
1430: 65 72 20 61 74 20 74 68 65 0a 73 61 6d 65 20 74  er at the.same t
1440: 69 6d 65 2c 20 62 79 20 70 6c 61 63 69 6e 67 20  ime, by placing 
1450: 74 68 65 20 6f 62 6a 65 63 74 20 66 69 6c 65 73  the object files
1460: 20 66 6f 72 20 65 61 63 68 20 61 72 63 68 69 74   for each archit
1470: 65 63 74 75 72 65 20 69 6e 20 74 68 65 69 72 0a  ecture in their.
1480: 6f 77 6e 20 64 69 72 65 63 74 6f 72 79 2e 20 20  own directory.  
1490: 54 6f 20 64 6f 20 74 68 69 73 2c 20 79 6f 75 20  To do this, you 
14a0: 63 61 6e 20 75 73 65 20 47 4e 55 20 60 6d 61 6b  can use GNU `mak
14b0: 65 27 2e 20 20 60 63 64 27 20 74 6f 20 74 68 65  e'.  `cd' to the
14c0: 0a 64 69 72 65 63 74 6f 72 79 20 77 68 65 72 65  .directory where
14d0: 20 79 6f 75 20 77 61 6e 74 20 74 68 65 20 6f 62   you want the ob
14e0: 6a 65 63 74 20 66 69 6c 65 73 20 61 6e 64 20 65  ject files and e
14f0: 78 65 63 75 74 61 62 6c 65 73 20 74 6f 20 67 6f  xecutables to go
1500: 20 61 6e 64 20 72 75 6e 0a 74 68 65 20 60 63 6f   and run.the `co
1510: 6e 66 69 67 75 72 65 27 20 73 63 72 69 70 74 2e  nfigure' script.
1520: 20 20 60 63 6f 6e 66 69 67 75 72 65 27 20 61 75    `configure' au
1530: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 68 65 63  tomatically chec
1540: 6b 73 20 66 6f 72 20 74 68 65 0a 73 6f 75 72 63  ks for the.sourc
1550: 65 20 63 6f 64 65 20 69 6e 20 74 68 65 20 64 69  e code in the di
1560: 72 65 63 74 6f 72 79 20 74 68 61 74 20 60 63 6f  rectory that `co
1570: 6e 66 69 67 75 72 65 27 20 69 73 20 69 6e 20 61  nfigure' is in a
1580: 6e 64 20 69 6e 20 60 2e 2e 27 2e 20 20 54 68 69  nd in `..'.  Thi
1590: 73 0a 69 73 20 6b 6e 6f 77 6e 20 61 73 20 61 20  s.is known as a 
15a0: 22 56 50 41 54 48 22 20 62 75 69 6c 64 2e 0a 0a  "VPATH" build...
15b0: 20 20 20 57 69 74 68 20 61 20 6e 6f 6e 2d 47 4e     With a non-GN
15c0: 55 20 60 6d 61 6b 65 27 2c 20 69 74 20 69 73 20  U `make', it is 
15d0: 73 61 66 65 72 20 74 6f 20 63 6f 6d 70 69 6c 65  safer to compile
15e0: 20 74 68 65 20 70 61 63 6b 61 67 65 20 66 6f 72   the package for
15f0: 20 6f 6e 65 0a 61 72 63 68 69 74 65 63 74 75 72   one.architectur
1600: 65 20 61 74 20 61 20 74 69 6d 65 20 69 6e 20 74  e at a time in t
1610: 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 64  he source code d
1620: 69 72 65 63 74 6f 72 79 2e 20 20 41 66 74 65 72  irectory.  After
1630: 20 79 6f 75 20 68 61 76 65 0a 69 6e 73 74 61 6c   you have.instal
1640: 6c 65 64 20 74 68 65 20 70 61 63 6b 61 67 65 20  led the package 
1650: 66 6f 72 20 6f 6e 65 20 61 72 63 68 69 74 65 63  for one architec
1660: 74 75 72 65 2c 20 75 73 65 20 60 6d 61 6b 65 20  ture, use `make 
1670: 64 69 73 74 63 6c 65 61 6e 27 20 62 65 66 6f 72  distclean' befor
1680: 65 0a 72 65 63 6f 6e 66 69 67 75 72 69 6e 67 20  e.reconfiguring 
1690: 66 6f 72 20 61 6e 6f 74 68 65 72 20 61 72 63 68  for another arch
16a0: 69 74 65 63 74 75 72 65 2e 0a 0a 20 20 20 4f 6e  itecture...   On
16b0: 20 4d 61 63 4f 53 20 58 20 31 30 2e 35 20 61 6e   MacOS X 10.5 an
16c0: 64 20 6c 61 74 65 72 20 73 79 73 74 65 6d 73 2c  d later systems,
16d0: 20 79 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20   you can create 
16e0: 6c 69 62 72 61 72 69 65 73 20 61 6e 64 0a 65 78  libraries and.ex
16f0: 65 63 75 74 61 62 6c 65 73 20 74 68 61 74 20 77  ecutables that w
1700: 6f 72 6b 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20  ork on multiple 
1710: 73 79 73 74 65 6d 20 74 79 70 65 73 2d 2d 6b 6e  system types--kn
1720: 6f 77 6e 20 61 73 20 22 66 61 74 22 20 6f 72 0a  own as "fat" or.
1730: 22 75 6e 69 76 65 72 73 61 6c 22 20 62 69 6e 61  "universal" bina
1740: 72 69 65 73 2d 2d 62 79 20 73 70 65 63 69 66 79  ries--by specify
1750: 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 60 2d 61  ing multiple `-a
1760: 72 63 68 27 20 6f 70 74 69 6f 6e 73 20 74 6f 20  rch' options to 
1770: 74 68 65 0a 63 6f 6d 70 69 6c 65 72 20 62 75 74  the.compiler but
1780: 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 60   only a single `
1790: 2d 61 72 63 68 27 20 6f 70 74 69 6f 6e 20 74 6f  -arch' option to
17a0: 20 74 68 65 20 70 72 65 70 72 6f 63 65 73 73 6f   the preprocesso
17b0: 72 2e 20 20 4c 69 6b 65 0a 74 68 69 73 3a 0a 0a  r.  Like.this:..
17c0: 20 20 20 20 20 2e 2f 63 6f 6e 66 69 67 75 72 65       ./configure
17d0: 20 43 43 3d 22 67 63 63 20 2d 61 72 63 68 20 69   CC="gcc -arch i
17e0: 33 38 36 20 2d 61 72 63 68 20 78 38 36 5f 36 34  386 -arch x86_64
17f0: 20 2d 61 72 63 68 20 70 70 63 20 2d 61 72 63 68   -arch ppc -arch
1800: 20 70 70 63 36 34 22 20 5c 0a 20 20 20 20 20 20   ppc64" \.      
1810: 20 20 20 20 20 20 20 20 20 20 20 43 58 58 3d 22             CXX="
1820: 67 2b 2b 20 2d 61 72 63 68 20 69 33 38 36 20 2d  g++ -arch i386 -
1830: 61 72 63 68 20 78 38 36 5f 36 34 20 2d 61 72 63  arch x86_64 -arc
1840: 68 20 70 70 63 20 2d 61 72 63 68 20 70 70 63 36  h ppc -arch ppc6
1850: 34 22 20 5c 0a 20 20 20 20 20 20 20 20 20 20 20  4" \.           
1860: 20 20 20 20 20 20 43 50 50 3d 22 67 63 63 20 2d        CPP="gcc -
1870: 45 22 20 43 58 58 43 50 50 3d 22 67 2b 2b 20 2d  E" CXXCPP="g++ -
1880: 45 22 0a 0a 20 20 20 54 68 69 73 20 69 73 20 6e  E"..   This is n
1890: 6f 74 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f  ot guaranteed to
18a0: 20 70 72 6f 64 75 63 65 20 77 6f 72 6b 69 6e 67   produce working
18b0: 20 6f 75 74 70 75 74 20 69 6e 20 61 6c 6c 20 63   output in all c
18c0: 61 73 65 73 2c 20 79 6f 75 0a 6d 61 79 20 68 61  ases, you.may ha
18d0: 76 65 20 74 6f 20 62 75 69 6c 64 20 6f 6e 65 20  ve to build one 
18e0: 61 72 63 68 69 74 65 63 74 75 72 65 20 61 74 20  architecture at 
18f0: 61 20 74 69 6d 65 20 61 6e 64 20 63 6f 6d 62 69  a time and combi
1900: 6e 65 20 74 68 65 20 72 65 73 75 6c 74 73 0a 75  ne the results.u
1910: 73 69 6e 67 20 74 68 65 20 60 6c 69 70 6f 27 20  sing the `lipo' 
1920: 74 6f 6f 6c 20 69 66 20 79 6f 75 20 68 61 76 65  tool if you have
1930: 20 70 72 6f 62 6c 65 6d 73 2e 0a 0a 49 6e 73 74   problems...Inst
1940: 61 6c 6c 61 74 69 6f 6e 20 4e 61 6d 65 73 0a 3d  allation Names.=
1950: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
1960: 3d 0a 0a 20 20 20 42 79 20 64 65 66 61 75 6c 74  =..   By default
1970: 2c 20 60 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 27  , `make install'
1980: 20 69 6e 73 74 61 6c 6c 73 20 74 68 65 20 70 61   installs the pa
1990: 63 6b 61 67 65 27 73 20 63 6f 6d 6d 61 6e 64 73  ckage's commands
19a0: 20 75 6e 64 65 72 0a 60 2f 75 73 72 2f 6c 6f 63   under.`/usr/loc
19b0: 61 6c 2f 62 69 6e 27 2c 20 69 6e 63 6c 75 64 65  al/bin', include
19c0: 20 66 69 6c 65 73 20 75 6e 64 65 72 20 60 2f 75   files under `/u
19d0: 73 72 2f 6c 6f 63 61 6c 2f 69 6e 63 6c 75 64 65  sr/local/include
19e0: 27 2c 20 65 74 63 2e 20 20 59 6f 75 0a 63 61 6e  ', etc.  You.can
19f0: 20 73 70 65 63 69 66 79 20 61 6e 20 69 6e 73 74   specify an inst
1a00: 61 6c 6c 61 74 69 6f 6e 20 70 72 65 66 69 78 20  allation prefix 
1a10: 6f 74 68 65 72 20 74 68 61 6e 20 60 2f 75 73 72  other than `/usr
1a20: 2f 6c 6f 63 61 6c 27 20 62 79 20 67 69 76 69 6e  /local' by givin
1a30: 67 0a 60 63 6f 6e 66 69 67 75 72 65 27 20 74 68  g.`configure' th
1a40: 65 20 6f 70 74 69 6f 6e 20 60 2d 2d 70 72 65 66  e option `--pref
1a50: 69 78 3d 50 52 45 46 49 58 27 2c 20 77 68 65 72  ix=PREFIX', wher
1a60: 65 20 50 52 45 46 49 58 20 6d 75 73 74 20 62 65  e PREFIX must be
1a70: 20 61 6e 0a 61 62 73 6f 6c 75 74 65 20 66 69 6c   an.absolute fil
1a80: 65 20 6e 61 6d 65 2e 0a 0a 20 20 20 59 6f 75 20  e name...   You 
1a90: 63 61 6e 20 73 70 65 63 69 66 79 20 73 65 70 61  can specify sepa
1aa0: 72 61 74 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f  rate installatio
1ab0: 6e 20 70 72 65 66 69 78 65 73 20 66 6f 72 0a 61  n prefixes for.a
1ac0: 72 63 68 69 74 65 63 74 75 72 65 2d 73 70 65 63  rchitecture-spec
1ad0: 69 66 69 63 20 66 69 6c 65 73 20 61 6e 64 20 61  ific files and a
1ae0: 72 63 68 69 74 65 63 74 75 72 65 2d 69 6e 64 65  rchitecture-inde
1af0: 70 65 6e 64 65 6e 74 20 66 69 6c 65 73 2e 20 20  pendent files.  
1b00: 49 66 20 79 6f 75 0a 70 61 73 73 20 74 68 65 20  If you.pass the 
1b10: 6f 70 74 69 6f 6e 20 60 2d 2d 65 78 65 63 2d 70  option `--exec-p
1b20: 72 65 66 69 78 3d 50 52 45 46 49 58 27 20 74 6f  refix=PREFIX' to
1b30: 20 60 63 6f 6e 66 69 67 75 72 65 27 2c 20 74 68   `configure', th
1b40: 65 20 70 61 63 6b 61 67 65 20 75 73 65 73 0a 50  e package uses.P
1b50: 52 45 46 49 58 20 61 73 20 74 68 65 20 70 72 65  REFIX as the pre
1b60: 66 69 78 20 66 6f 72 20 69 6e 73 74 61 6c 6c 69  fix for installi
1b70: 6e 67 20 70 72 6f 67 72 61 6d 73 20 61 6e 64 20  ng programs and 
1b80: 6c 69 62 72 61 72 69 65 73 2e 0a 44 6f 63 75 6d  libraries..Docum
1b90: 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 6f 74 68  entation and oth
1ba0: 65 72 20 64 61 74 61 20 66 69 6c 65 73 20 73 74  er data files st
1bb0: 69 6c 6c 20 75 73 65 20 74 68 65 20 72 65 67 75  ill use the regu
1bc0: 6c 61 72 20 70 72 65 66 69 78 2e 0a 0a 20 20 20  lar prefix...   
1bd0: 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 69 66 20  In addition, if 
1be0: 79 6f 75 20 75 73 65 20 61 6e 20 75 6e 75 73 75  you use an unusu
1bf0: 61 6c 20 64 69 72 65 63 74 6f 72 79 20 6c 61 79  al directory lay
1c00: 6f 75 74 20 79 6f 75 20 63 61 6e 20 67 69 76 65  out you can give
1c10: 0a 6f 70 74 69 6f 6e 73 20 6c 69 6b 65 20 60 2d  .options like `-
1c20: 2d 62 69 6e 64 69 72 3d 44 49 52 27 20 74 6f 20  -bindir=DIR' to 
1c30: 73 70 65 63 69 66 79 20 64 69 66 66 65 72 65 6e  specify differen
1c40: 74 20 76 61 6c 75 65 73 20 66 6f 72 20 70 61 72  t values for par
1c50: 74 69 63 75 6c 61 72 0a 6b 69 6e 64 73 20 6f 66  ticular.kinds of
1c60: 20 66 69 6c 65 73 2e 20 20 52 75 6e 20 60 63 6f   files.  Run `co
1c70: 6e 66 69 67 75 72 65 20 2d 2d 68 65 6c 70 27 20  nfigure --help' 
1c80: 66 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 74 68  for a list of th
1c90: 65 20 64 69 72 65 63 74 6f 72 69 65 73 0a 79 6f  e directories.yo
1ca0: 75 20 63 61 6e 20 73 65 74 20 61 6e 64 20 77 68  u can set and wh
1cb0: 61 74 20 6b 69 6e 64 73 20 6f 66 20 66 69 6c 65  at kinds of file
1cc0: 73 20 67 6f 20 69 6e 20 74 68 65 6d 2e 20 20 49  s go in them.  I
1cd0: 6e 20 67 65 6e 65 72 61 6c 2c 20 74 68 65 0a 64  n general, the.d
1ce0: 65 66 61 75 6c 74 20 66 6f 72 20 74 68 65 73 65  efault for these
1cf0: 20 6f 70 74 69 6f 6e 73 20 69 73 20 65 78 70 72   options is expr
1d00: 65 73 73 65 64 20 69 6e 20 74 65 72 6d 73 20 6f  essed in terms o
1d10: 66 20 60 24 7b 70 72 65 66 69 78 7d 27 2c 20 73  f `${prefix}', s
1d20: 6f 20 74 68 61 74 0a 73 70 65 63 69 66 79 69 6e  o that.specifyin
1d30: 67 20 6a 75 73 74 20 60 2d 2d 70 72 65 66 69 78  g just `--prefix
1d40: 27 20 77 69 6c 6c 20 61 66 66 65 63 74 20 61 6c  ' will affect al
1d50: 6c 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 64  l of the other d
1d60: 69 72 65 63 74 6f 72 79 0a 73 70 65 63 69 66 69  irectory.specifi
1d70: 63 61 74 69 6f 6e 73 20 74 68 61 74 20 77 65 72  cations that wer
1d80: 65 20 6e 6f 74 20 65 78 70 6c 69 63 69 74 6c 79  e not explicitly
1d90: 20 70 72 6f 76 69 64 65 64 2e 0a 0a 20 20 20 54   provided...   T
1da0: 68 65 20 6d 6f 73 74 20 70 6f 72 74 61 62 6c 65  he most portable
1db0: 20 77 61 79 20 74 6f 20 61 66 66 65 63 74 20 69   way to affect i
1dc0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 6c 6f 63 61  nstallation loca
1dd0: 74 69 6f 6e 73 20 69 73 20 74 6f 20 70 61 73 73  tions is to pass
1de0: 20 74 68 65 0a 63 6f 72 72 65 63 74 20 6c 6f 63   the.correct loc
1df0: 61 74 69 6f 6e 73 20 74 6f 20 60 63 6f 6e 66 69  ations to `confi
1e00: 67 75 72 65 27 3b 20 68 6f 77 65 76 65 72 2c 20  gure'; however, 
1e10: 6d 61 6e 79 20 70 61 63 6b 61 67 65 73 20 70 72  many packages pr
1e20: 6f 76 69 64 65 20 6f 6e 65 20 6f 72 0a 62 6f 74  ovide one or.bot
1e30: 68 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69  h of the followi
1e40: 6e 67 20 73 68 6f 72 74 63 75 74 73 20 6f 66 20  ng shortcuts of 
1e50: 70 61 73 73 69 6e 67 20 76 61 72 69 61 62 6c 65  passing variable
1e60: 20 61 73 73 69 67 6e 6d 65 6e 74 73 20 74 6f 20   assignments to 
1e70: 74 68 65 0a 60 6d 61 6b 65 20 69 6e 73 74 61 6c  the.`make instal
1e80: 6c 27 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20  l' command line 
1e90: 74 6f 20 63 68 61 6e 67 65 20 69 6e 73 74 61 6c  to change instal
1ea0: 6c 61 74 69 6f 6e 20 6c 6f 63 61 74 69 6f 6e 73  lation locations
1eb0: 20 77 69 74 68 6f 75 74 0a 68 61 76 69 6e 67 20   without.having 
1ec0: 74 6f 20 72 65 63 6f 6e 66 69 67 75 72 65 20 6f  to reconfigure o
1ed0: 72 20 72 65 63 6f 6d 70 69 6c 65 2e 0a 0a 20 20  r recompile...  
1ee0: 20 54 68 65 20 66 69 72 73 74 20 6d 65 74 68 6f   The first metho
1ef0: 64 20 69 6e 76 6f 6c 76 65 73 20 70 72 6f 76 69  d involves provi
1f00: 64 69 6e 67 20 61 6e 20 6f 76 65 72 72 69 64 65  ding an override
1f10: 20 76 61 72 69 61 62 6c 65 20 66 6f 72 20 65 61   variable for ea
1f20: 63 68 0a 61 66 66 65 63 74 65 64 20 64 69 72 65  ch.affected dire
1f30: 63 74 6f 72 79 2e 20 20 46 6f 72 20 65 78 61 6d  ctory.  For exam
1f40: 70 6c 65 2c 20 60 6d 61 6b 65 20 69 6e 73 74 61  ple, `make insta
1f50: 6c 6c 0a 70 72 65 66 69 78 3d 2f 61 6c 74 65 72  ll.prefix=/alter
1f60: 6e 61 74 65 2f 64 69 72 65 63 74 6f 72 79 27 20  nate/directory' 
1f70: 77 69 6c 6c 20 63 68 6f 6f 73 65 20 61 6e 20 61  will choose an a
1f80: 6c 74 65 72 6e 61 74 65 20 6c 6f 63 61 74 69 6f  lternate locatio
1f90: 6e 20 66 6f 72 20 61 6c 6c 0a 64 69 72 65 63 74  n for all.direct
1fa0: 6f 72 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f  ory configuratio
1fb0: 6e 20 76 61 72 69 61 62 6c 65 73 20 74 68 61 74  n variables that
1fc0: 20 77 65 72 65 20 65 78 70 72 65 73 73 65 64 20   were expressed 
1fd0: 69 6e 20 74 65 72 6d 73 20 6f 66 0a 60 24 7b 70  in terms of.`${p
1fe0: 72 65 66 69 78 7d 27 2e 20 20 41 6e 79 20 64 69  refix}'.  Any di
1ff0: 72 65 63 74 6f 72 69 65 73 20 74 68 61 74 20 77  rectories that w
2000: 65 72 65 20 73 70 65 63 69 66 69 65 64 20 64 75  ere specified du
2010: 72 69 6e 67 20 60 63 6f 6e 66 69 67 75 72 65 27  ring `configure'
2020: 2c 0a 62 75 74 20 6e 6f 74 20 69 6e 20 74 65 72  ,.but not in ter
2030: 6d 73 20 6f 66 20 60 24 7b 70 72 65 66 69 78 7d  ms of `${prefix}
2040: 27 2c 20 6d 75 73 74 20 65 61 63 68 20 62 65 20  ', must each be 
2050: 6f 76 65 72 72 69 64 64 65 6e 20 61 74 20 69 6e  overridden at in
2060: 73 74 61 6c 6c 0a 74 69 6d 65 20 66 6f 72 20 74  stall.time for t
2070: 68 65 20 65 6e 74 69 72 65 20 69 6e 73 74 61 6c  he entire instal
2080: 6c 61 74 69 6f 6e 20 74 6f 20 62 65 20 72 65 6c  lation to be rel
2090: 6f 63 61 74 65 64 2e 20 20 54 68 65 20 61 70 70  ocated.  The app
20a0: 72 6f 61 63 68 20 6f 66 0a 6d 61 6b 65 66 69 6c  roach of.makefil
20b0: 65 20 76 61 72 69 61 62 6c 65 20 6f 76 65 72 72  e variable overr
20c0: 69 64 65 73 20 66 6f 72 20 65 61 63 68 20 64 69  ides for each di
20d0: 72 65 63 74 6f 72 79 20 76 61 72 69 61 62 6c 65  rectory variable
20e0: 20 69 73 20 72 65 71 75 69 72 65 64 20 62 79 0a   is required by.
20f0: 74 68 65 20 47 4e 55 20 43 6f 64 69 6e 67 20 53  the GNU Coding S
2100: 74 61 6e 64 61 72 64 73 2c 20 61 6e 64 20 69 64  tandards, and id
2110: 65 61 6c 6c 79 20 63 61 75 73 65 73 20 6e 6f 20  eally causes no 
2120: 72 65 63 6f 6d 70 69 6c 61 74 69 6f 6e 2e 0a 48  recompilation..H
2130: 6f 77 65 76 65 72 2c 20 73 6f 6d 65 20 70 6c 61  owever, some pla
2140: 74 66 6f 72 6d 73 20 68 61 76 65 20 6b 6e 6f 77  tforms have know
2150: 6e 20 6c 69 6d 69 74 61 74 69 6f 6e 73 20 77 69  n limitations wi
2160: 74 68 20 74 68 65 20 73 65 6d 61 6e 74 69 63 73  th the semantics
2170: 20 6f 66 0a 73 68 61 72 65 64 20 6c 69 62 72 61   of.shared libra
2180: 72 69 65 73 20 74 68 61 74 20 65 6e 64 20 75 70  ries that end up
2190: 20 72 65 71 75 69 72 69 6e 67 20 72 65 63 6f 6d   requiring recom
21a0: 70 69 6c 61 74 69 6f 6e 20 77 68 65 6e 20 75 73  pilation when us
21b0: 69 6e 67 20 74 68 69 73 0a 6d 65 74 68 6f 64 2c  ing this.method,
21c0: 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 6e 6f   particularly no
21d0: 74 69 63 65 61 62 6c 65 20 69 6e 20 70 61 63 6b  ticeable in pack
21e0: 61 67 65 73 20 74 68 61 74 20 75 73 65 20 47 4e  ages that use GN
21f0: 55 20 4c 69 62 74 6f 6f 6c 2e 0a 0a 20 20 20 54  U Libtool...   T
2200: 68 65 20 73 65 63 6f 6e 64 20 6d 65 74 68 6f 64  he second method
2210: 20 69 6e 76 6f 6c 76 65 73 20 70 72 6f 76 69 64   involves provid
2220: 69 6e 67 20 74 68 65 20 60 44 45 53 54 44 49 52  ing the `DESTDIR
2230: 27 20 76 61 72 69 61 62 6c 65 2e 20 20 46 6f 72  ' variable.  For
2240: 0a 65 78 61 6d 70 6c 65 2c 20 60 6d 61 6b 65 20  .example, `make 
2250: 69 6e 73 74 61 6c 6c 20 44 45 53 54 44 49 52 3d  install DESTDIR=
2260: 2f 61 6c 74 65 72 6e 61 74 65 2f 64 69 72 65 63  /alternate/direc
2270: 74 6f 72 79 27 20 77 69 6c 6c 20 70 72 65 70 65  tory' will prepe
2280: 6e 64 0a 60 2f 61 6c 74 65 72 6e 61 74 65 2f 64  nd.`/alternate/d
2290: 69 72 65 63 74 6f 72 79 27 20 62 65 66 6f 72 65  irectory' before
22a0: 20 61 6c 6c 20 69 6e 73 74 61 6c 6c 61 74 69 6f   all installatio
22b0: 6e 20 6e 61 6d 65 73 2e 20 20 54 68 65 20 61 70  n names.  The ap
22c0: 70 72 6f 61 63 68 20 6f 66 0a 60 44 45 53 54 44  proach of.`DESTD
22d0: 49 52 27 20 6f 76 65 72 72 69 64 65 73 20 69 73  IR' overrides is
22e0: 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 62 79   not required by
22f0: 20 74 68 65 20 47 4e 55 20 43 6f 64 69 6e 67 20   the GNU Coding 
2300: 53 74 61 6e 64 61 72 64 73 2c 20 61 6e 64 0a 64  Standards, and.d
2310: 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 6f 6e 20  oes not work on 
2320: 70 6c 61 74 66 6f 72 6d 73 20 74 68 61 74 20 68  platforms that h
2330: 61 76 65 20 64 72 69 76 65 20 6c 65 74 74 65 72  ave drive letter
2340: 73 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72  s.  On the other
2350: 20 68 61 6e 64 2c 0a 69 74 20 64 6f 65 73 20 62   hand,.it does b
2360: 65 74 74 65 72 20 61 74 20 61 76 6f 69 64 69 6e  etter at avoidin
2370: 67 20 72 65 63 6f 6d 70 69 6c 61 74 69 6f 6e 20  g recompilation 
2380: 69 73 73 75 65 73 2c 20 61 6e 64 20 77 6f 72 6b  issues, and work
2390: 73 20 77 65 6c 6c 20 65 76 65 6e 0a 77 68 65 6e  s well even.when
23a0: 20 73 6f 6d 65 20 64 69 72 65 63 74 6f 72 79 20   some directory 
23b0: 6f 70 74 69 6f 6e 73 20 77 65 72 65 20 6e 6f 74  options were not
23c0: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 65   specified in te
23d0: 72 6d 73 20 6f 66 20 60 24 7b 70 72 65 66 69 78  rms of `${prefix
23e0: 7d 27 0a 61 74 20 60 63 6f 6e 66 69 67 75 72 65  }'.at `configure
23f0: 27 20 74 69 6d 65 2e 0a 0a 4f 70 74 69 6f 6e 61  ' time...Optiona
2400: 6c 20 46 65 61 74 75 72 65 73 0a 3d 3d 3d 3d 3d  l Features.=====
2410: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20  ============..  
2420: 20 49 66 20 74 68 65 20 70 61 63 6b 61 67 65 20   If the package 
2430: 73 75 70 70 6f 72 74 73 20 69 74 2c 20 79 6f 75  supports it, you
2440: 20 63 61 6e 20 63 61 75 73 65 20 70 72 6f 67 72   can cause progr
2450: 61 6d 73 20 74 6f 20 62 65 20 69 6e 73 74 61 6c  ams to be instal
2460: 6c 65 64 0a 77 69 74 68 20 61 6e 20 65 78 74 72  led.with an extr
2470: 61 20 70 72 65 66 69 78 20 6f 72 20 73 75 66 66  a prefix or suff
2480: 69 78 20 6f 6e 20 74 68 65 69 72 20 6e 61 6d 65  ix on their name
2490: 73 20 62 79 20 67 69 76 69 6e 67 20 60 63 6f 6e  s by giving `con
24a0: 66 69 67 75 72 65 27 20 74 68 65 0a 6f 70 74 69  figure' the.opti
24b0: 6f 6e 20 60 2d 2d 70 72 6f 67 72 61 6d 2d 70 72  on `--program-pr
24c0: 65 66 69 78 3d 50 52 45 46 49 58 27 20 6f 72 20  efix=PREFIX' or 
24d0: 60 2d 2d 70 72 6f 67 72 61 6d 2d 73 75 66 66 69  `--program-suffi
24e0: 78 3d 53 55 46 46 49 58 27 2e 0a 0a 20 20 20 53  x=SUFFIX'...   S
24f0: 6f 6d 65 20 70 61 63 6b 61 67 65 73 20 70 61 79  ome packages pay
2500: 20 61 74 74 65 6e 74 69 6f 6e 20 74 6f 20 60 2d   attention to `-
2510: 2d 65 6e 61 62 6c 65 2d 46 45 41 54 55 52 45 27  -enable-FEATURE'
2520: 20 6f 70 74 69 6f 6e 73 20 74 6f 0a 60 63 6f 6e   options to.`con
2530: 66 69 67 75 72 65 27 2c 20 77 68 65 72 65 20 46  figure', where F
2540: 45 41 54 55 52 45 20 69 6e 64 69 63 61 74 65 73  EATURE indicates
2550: 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 70 61 72   an optional par
2560: 74 20 6f 66 20 74 68 65 20 70 61 63 6b 61 67 65  t of the package
2570: 2e 0a 54 68 65 79 20 6d 61 79 20 61 6c 73 6f 20  ..They may also 
2580: 70 61 79 20 61 74 74 65 6e 74 69 6f 6e 20 74 6f  pay attention to
2590: 20 60 2d 2d 77 69 74 68 2d 50 41 43 4b 41 47 45   `--with-PACKAGE
25a0: 27 20 6f 70 74 69 6f 6e 73 2c 20 77 68 65 72 65  ' options, where
25b0: 20 50 41 43 4b 41 47 45 0a 69 73 20 73 6f 6d 65   PACKAGE.is some
25c0: 74 68 69 6e 67 20 6c 69 6b 65 20 60 67 6e 75 2d  thing like `gnu-
25d0: 61 73 27 20 6f 72 20 60 78 27 20 28 66 6f 72 20  as' or `x' (for 
25e0: 74 68 65 20 58 20 57 69 6e 64 6f 77 20 53 79 73  the X Window Sys
25f0: 74 65 6d 29 2e 20 20 54 68 65 0a 60 52 45 41 44  tem).  The.`READ
2600: 4d 45 27 20 73 68 6f 75 6c 64 20 6d 65 6e 74 69  ME' should menti
2610: 6f 6e 20 61 6e 79 20 60 2d 2d 65 6e 61 62 6c 65  on any `--enable
2620: 2d 27 20 61 6e 64 20 60 2d 2d 77 69 74 68 2d 27  -' and `--with-'
2630: 20 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 74 68   options that th
2640: 65 0a 70 61 63 6b 61 67 65 20 72 65 63 6f 67 6e  e.package recogn
2650: 69 7a 65 73 2e 0a 0a 20 20 20 46 6f 72 20 70 61  izes...   For pa
2660: 63 6b 61 67 65 73 20 74 68 61 74 20 75 73 65 20  ckages that use 
2670: 74 68 65 20 58 20 57 69 6e 64 6f 77 20 53 79 73  the X Window Sys
2680: 74 65 6d 2c 20 60 63 6f 6e 66 69 67 75 72 65 27  tem, `configure'
2690: 20 63 61 6e 20 75 73 75 61 6c 6c 79 0a 66 69 6e   can usually.fin
26a0: 64 20 74 68 65 20 58 20 69 6e 63 6c 75 64 65 20  d the X include 
26b0: 61 6e 64 20 6c 69 62 72 61 72 79 20 66 69 6c 65  and library file
26c0: 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2c  s automatically,
26d0: 20 62 75 74 20 69 66 20 69 74 20 64 6f 65 73 6e   but if it doesn
26e0: 27 74 2c 0a 79 6f 75 20 63 61 6e 20 75 73 65 20  't,.you can use 
26f0: 74 68 65 20 60 63 6f 6e 66 69 67 75 72 65 27 20  the `configure' 
2700: 6f 70 74 69 6f 6e 73 20 60 2d 2d 78 2d 69 6e 63  options `--x-inc
2710: 6c 75 64 65 73 3d 44 49 52 27 20 61 6e 64 0a 60  ludes=DIR' and.`
2720: 2d 2d 78 2d 6c 69 62 72 61 72 69 65 73 3d 44 49  --x-libraries=DI
2730: 52 27 20 74 6f 20 73 70 65 63 69 66 79 20 74 68  R' to specify th
2740: 65 69 72 20 6c 6f 63 61 74 69 6f 6e 73 2e 0a 0a  eir locations...
2750: 20 20 20 53 6f 6d 65 20 70 61 63 6b 61 67 65 73     Some packages
2760: 20 6f 66 66 65 72 20 74 68 65 20 61 62 69 6c 69   offer the abili
2770: 74 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20  ty to configure 
2780: 68 6f 77 20 76 65 72 62 6f 73 65 20 74 68 65 0a  how verbose the.
2790: 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 60 6d 61  execution of `ma
27a0: 6b 65 27 20 77 69 6c 6c 20 62 65 2e 20 20 46 6f  ke' will be.  Fo
27b0: 72 20 74 68 65 73 65 20 70 61 63 6b 61 67 65 73  r these packages
27c0: 2c 20 72 75 6e 6e 69 6e 67 20 60 2e 2f 63 6f 6e  , running `./con
27d0: 66 69 67 75 72 65 0a 2d 2d 65 6e 61 62 6c 65 2d  figure.--enable-
27e0: 73 69 6c 65 6e 74 2d 72 75 6c 65 73 27 20 73 65  silent-rules' se
27f0: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 74  ts the default t
2800: 6f 20 6d 69 6e 69 6d 61 6c 20 6f 75 74 70 75 74  o minimal output
2810: 2c 20 77 68 69 63 68 20 63 61 6e 20 62 65 0a 6f  , which can be.o
2820: 76 65 72 72 69 64 64 65 6e 20 77 69 74 68 20 60  verridden with `
2830: 6d 61 6b 65 20 56 3d 31 27 3b 20 77 68 69 6c 65  make V=1'; while
2840: 20 72 75 6e 6e 69 6e 67 20 60 2e 2f 63 6f 6e 66   running `./conf
2850: 69 67 75 72 65 0a 2d 2d 64 69 73 61 62 6c 65 2d  igure.--disable-
2860: 73 69 6c 65 6e 74 2d 72 75 6c 65 73 27 20 73 65  silent-rules' se
2870: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 74  ts the default t
2880: 6f 20 76 65 72 62 6f 73 65 2c 20 77 68 69 63 68  o verbose, which
2890: 20 63 61 6e 20 62 65 0a 6f 76 65 72 72 69 64 64   can be.overridd
28a0: 65 6e 20 77 69 74 68 20 60 6d 61 6b 65 20 56 3d  en with `make V=
28b0: 30 27 2e 0a 0a 50 61 72 74 69 63 75 6c 61 72 20  0'...Particular 
28c0: 73 79 73 74 65 6d 73 0a 3d 3d 3d 3d 3d 3d 3d 3d  systems.========
28d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 4f  ==========..   O
28e0: 6e 20 48 50 2d 55 58 2c 20 74 68 65 20 64 65 66  n HP-UX, the def
28f0: 61 75 6c 74 20 43 20 63 6f 6d 70 69 6c 65 72 20  ault C compiler 
2900: 69 73 20 6e 6f 74 20 41 4e 53 49 20 43 20 63 6f  is not ANSI C co
2910: 6d 70 61 74 69 62 6c 65 2e 20 20 49 66 20 47 4e  mpatible.  If GN
2920: 55 0a 43 43 20 69 73 20 6e 6f 74 20 69 6e 73 74  U.CC is not inst
2930: 61 6c 6c 65 64 2c 20 69 74 20 69 73 20 72 65 63  alled, it is rec
2940: 6f 6d 6d 65 6e 64 65 64 20 74 6f 20 75 73 65 20  ommended to use 
2950: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70  the following op
2960: 74 69 6f 6e 73 20 69 6e 0a 6f 72 64 65 72 20 74  tions in.order t
2970: 6f 20 75 73 65 20 61 6e 20 41 4e 53 49 20 43 20  o use an ANSI C 
2980: 63 6f 6d 70 69 6c 65 72 3a 0a 0a 20 20 20 20 20  compiler:..     
2990: 2e 2f 63 6f 6e 66 69 67 75 72 65 20 43 43 3d 22  ./configure CC="
29a0: 63 63 20 2d 41 65 20 2d 44 5f 58 4f 50 45 4e 5f  cc -Ae -D_XOPEN_
29b0: 53 4f 55 52 43 45 3d 35 30 30 22 0a 0a 61 6e 64  SOURCE=500"..and
29c0: 20 69 66 20 74 68 61 74 20 64 6f 65 73 6e 27 74   if that doesn't
29d0: 20 77 6f 72 6b 2c 20 69 6e 73 74 61 6c 6c 20 70   work, install p
29e0: 72 65 2d 62 75 69 6c 74 20 62 69 6e 61 72 69 65  re-built binarie
29f0: 73 20 6f 66 20 47 43 43 20 66 6f 72 20 48 50 2d  s of GCC for HP-
2a00: 55 58 2e 0a 0a 20 20 20 48 50 2d 55 58 20 60 6d  UX...   HP-UX `m
2a10: 61 6b 65 27 20 75 70 64 61 74 65 73 20 74 61 72  ake' updates tar
2a20: 67 65 74 73 20 77 68 69 63 68 20 68 61 76 65 20  gets which have 
2a30: 74 68 65 20 73 61 6d 65 20 74 69 6d 65 20 73 74  the same time st
2a40: 61 6d 70 73 20 61 73 0a 74 68 65 69 72 20 70 72  amps as.their pr
2a50: 65 72 65 71 75 69 73 69 74 65 73 2c 20 77 68 69  erequisites, whi
2a60: 63 68 20 6d 61 6b 65 73 20 69 74 20 67 65 6e 65  ch makes it gene
2a70: 72 61 6c 6c 79 20 75 6e 75 73 61 62 6c 65 20 77  rally unusable w
2a80: 68 65 6e 20 73 68 69 70 70 65 64 0a 67 65 6e 65  hen shipped.gene
2a90: 72 61 74 65 64 20 66 69 6c 65 73 20 73 75 63 68  rated files such
2aa0: 20 61 73 20 60 63 6f 6e 66 69 67 75 72 65 27 20   as `configure' 
2ab0: 61 72 65 20 69 6e 76 6f 6c 76 65 64 2e 20 20 55  are involved.  U
2ac0: 73 65 20 47 4e 55 20 60 6d 61 6b 65 27 0a 69 6e  se GNU `make'.in
2ad0: 73 74 65 61 64 2e 0a 0a 20 20 20 4f 6e 20 4f 53  stead...   On OS
2ae0: 46 2f 31 20 61 2e 6b 2e 61 2e 20 54 72 75 36 34  F/1 a.k.a. Tru64
2af0: 2c 20 73 6f 6d 65 20 76 65 72 73 69 6f 6e 73 20  , some versions 
2b00: 6f 66 20 74 68 65 20 64 65 66 61 75 6c 74 20 43  of the default C
2b10: 20 63 6f 6d 70 69 6c 65 72 20 63 61 6e 6e 6f 74   compiler cannot
2b20: 0a 70 61 72 73 65 20 69 74 73 20 60 3c 77 63 68  .parse its `<wch
2b30: 61 72 2e 68 3e 27 20 68 65 61 64 65 72 20 66 69  ar.h>' header fi
2b40: 6c 65 2e 20 20 54 68 65 20 6f 70 74 69 6f 6e 20  le.  The option 
2b50: 60 2d 6e 6f 64 74 6b 27 20 63 61 6e 20 62 65 20  `-nodtk' can be 
2b60: 75 73 65 64 20 61 73 0a 61 20 77 6f 72 6b 61 72  used as.a workar
2b70: 6f 75 6e 64 2e 20 20 49 66 20 47 4e 55 20 43 43  ound.  If GNU CC
2b80: 20 69 73 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65   is not installe
2b90: 64 2c 20 69 74 20 69 73 20 74 68 65 72 65 66 6f  d, it is therefo
2ba0: 72 65 20 72 65 63 6f 6d 6d 65 6e 64 65 64 0a 74  re recommended.t
2bb0: 6f 20 74 72 79 0a 0a 20 20 20 20 20 2e 2f 63 6f  o try..     ./co
2bc0: 6e 66 69 67 75 72 65 20 43 43 3d 22 63 63 22 0a  nfigure CC="cc".
2bd0: 0a 61 6e 64 20 69 66 20 74 68 61 74 20 64 6f 65  .and if that doe
2be0: 73 6e 27 74 20 77 6f 72 6b 2c 20 74 72 79 0a 0a  sn't work, try..
2bf0: 20 20 20 20 20 2e 2f 63 6f 6e 66 69 67 75 72 65       ./configure
2c00: 20 43 43 3d 22 63 63 20 2d 6e 6f 64 74 6b 22 0a   CC="cc -nodtk".
2c10: 0a 20 20 20 4f 6e 20 53 6f 6c 61 72 69 73 2c 20  .   On Solaris, 
2c20: 64 6f 6e 27 74 20 70 75 74 20 60 2f 75 73 72 2f  don't put `/usr/
2c30: 75 63 62 27 20 65 61 72 6c 79 20 69 6e 20 79 6f  ucb' early in yo
2c40: 75 72 20 60 50 41 54 48 27 2e 20 20 54 68 69 73  ur `PATH'.  This
2c50: 0a 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 61  .directory conta
2c60: 69 6e 73 20 73 65 76 65 72 61 6c 20 64 79 73 66  ins several dysf
2c70: 75 6e 63 74 69 6f 6e 61 6c 20 70 72 6f 67 72 61  unctional progra
2c80: 6d 73 3b 20 77 6f 72 6b 69 6e 67 20 76 61 72 69  ms; working vari
2c90: 61 6e 74 73 20 6f 66 0a 74 68 65 73 65 20 70 72  ants of.these pr
2ca0: 6f 67 72 61 6d 73 20 61 72 65 20 61 76 61 69 6c  ograms are avail
2cb0: 61 62 6c 65 20 69 6e 20 60 2f 75 73 72 2f 62 69  able in `/usr/bi
2cc0: 6e 27 2e 20 20 53 6f 2c 20 69 66 20 79 6f 75 20  n'.  So, if you 
2cd0: 6e 65 65 64 20 60 2f 75 73 72 2f 75 63 62 27 0a  need `/usr/ucb'.
2ce0: 69 6e 20 79 6f 75 72 20 60 50 41 54 48 27 2c 20  in your `PATH', 
2cf0: 70 75 74 20 69 74 20 5f 61 66 74 65 72 5f 20 60  put it _after_ `
2d00: 2f 75 73 72 2f 62 69 6e 27 2e 0a 0a 20 20 20 4f  /usr/bin'...   O
2d10: 6e 20 48 61 69 6b 75 2c 20 73 6f 66 74 77 61 72  n Haiku, softwar
2d20: 65 20 69 6e 73 74 61 6c 6c 65 64 20 66 6f 72 20  e installed for 
2d30: 61 6c 6c 20 75 73 65 72 73 20 67 6f 65 73 20 69  all users goes i
2d40: 6e 20 60 2f 62 6f 6f 74 2f 63 6f 6d 6d 6f 6e 27  n `/boot/common'
2d50: 2c 0a 6e 6f 74 20 60 2f 75 73 72 2f 6c 6f 63 61  ,.not `/usr/loca
2d60: 6c 27 2e 20 20 49 74 20 69 73 20 72 65 63 6f 6d  l'.  It is recom
2d70: 6d 65 6e 64 65 64 20 74 6f 20 75 73 65 20 74 68  mended to use th
2d80: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69  e following opti
2d90: 6f 6e 73 3a 0a 0a 20 20 20 20 20 2e 2f 63 6f 6e  ons:..     ./con
2da0: 66 69 67 75 72 65 20 2d 2d 70 72 65 66 69 78 3d  figure --prefix=
2db0: 2f 62 6f 6f 74 2f 63 6f 6d 6d 6f 6e 0a 0a 53 70  /boot/common..Sp
2dc0: 65 63 69 66 79 69 6e 67 20 74 68 65 20 53 79 73  ecifying the Sys
2dd0: 74 65 6d 20 54 79 70 65 0a 3d 3d 3d 3d 3d 3d 3d  tem Type.=======
2de0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
2df0: 3d 3d 3d 0a 0a 20 20 20 54 68 65 72 65 20 6d 61  ===..   There ma
2e00: 79 20 62 65 20 73 6f 6d 65 20 66 65 61 74 75 72  y be some featur
2e10: 65 73 20 60 63 6f 6e 66 69 67 75 72 65 27 20 63  es `configure' c
2e20: 61 6e 6e 6f 74 20 66 69 67 75 72 65 20 6f 75 74  annot figure out
2e30: 0a 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2c 20  .automatically, 
2e40: 62 75 74 20 6e 65 65 64 73 20 74 6f 20 64 65 74  but needs to det
2e50: 65 72 6d 69 6e 65 20 62 79 20 74 68 65 20 74 79  ermine by the ty
2e60: 70 65 20 6f 66 20 6d 61 63 68 69 6e 65 20 74 68  pe of machine th
2e70: 65 20 70 61 63 6b 61 67 65 0a 77 69 6c 6c 20 72  e package.will r
2e80: 75 6e 20 6f 6e 2e 20 20 55 73 75 61 6c 6c 79 2c  un on.  Usually,
2e90: 20 61 73 73 75 6d 69 6e 67 20 74 68 65 20 70 61   assuming the pa
2ea0: 63 6b 61 67 65 20 69 73 20 62 75 69 6c 74 20 74  ckage is built t
2eb0: 6f 20 62 65 20 72 75 6e 20 6f 6e 20 74 68 65 0a  o be run on the.
2ec0: 5f 73 61 6d 65 5f 20 61 72 63 68 69 74 65 63 74  _same_ architect
2ed0: 75 72 65 73 2c 20 60 63 6f 6e 66 69 67 75 72 65  ures, `configure
2ee0: 27 20 63 61 6e 20 66 69 67 75 72 65 20 74 68 61  ' can figure tha
2ef0: 74 20 6f 75 74 2c 20 62 75 74 20 69 66 20 69 74  t out, but if it
2f00: 20 70 72 69 6e 74 73 0a 61 20 6d 65 73 73 61 67   prints.a messag
2f10: 65 20 73 61 79 69 6e 67 20 69 74 20 63 61 6e 6e  e saying it cann
2f20: 6f 74 20 67 75 65 73 73 20 74 68 65 20 6d 61 63  ot guess the mac
2f30: 68 69 6e 65 20 74 79 70 65 2c 20 67 69 76 65 20  hine type, give 
2f40: 69 74 20 74 68 65 0a 60 2d 2d 62 75 69 6c 64 3d  it the.`--build=
2f50: 54 59 50 45 27 20 6f 70 74 69 6f 6e 2e 20 20 54  TYPE' option.  T
2f60: 59 50 45 20 63 61 6e 20 65 69 74 68 65 72 20 62  YPE can either b
2f70: 65 20 61 20 73 68 6f 72 74 20 6e 61 6d 65 20 66  e a short name f
2f80: 6f 72 20 74 68 65 20 73 79 73 74 65 6d 0a 74 79  or the system.ty
2f90: 70 65 2c 20 73 75 63 68 20 61 73 20 60 73 75 6e  pe, such as `sun
2fa0: 34 27 2c 20 6f 72 20 61 20 63 61 6e 6f 6e 69 63  4', or a canonic
2fb0: 61 6c 20 6e 61 6d 65 20 77 68 69 63 68 20 68 61  al name which ha
2fc0: 73 20 74 68 65 20 66 6f 72 6d 3a 0a 0a 20 20 20  s the form:..   
2fd0: 20 20 43 50 55 2d 43 4f 4d 50 41 4e 59 2d 53 59    CPU-COMPANY-SY
2fe0: 53 54 45 4d 0a 0a 77 68 65 72 65 20 53 59 53 54  STEM..where SYST
2ff0: 45 4d 20 63 61 6e 20 68 61 76 65 20 6f 6e 65 20  EM can have one 
3000: 6f 66 20 74 68 65 73 65 20 66 6f 72 6d 73 3a 0a  of these forms:.
3010: 0a 20 20 20 20 20 4f 53 0a 20 20 20 20 20 4b 45  .     OS.     KE
3020: 52 4e 45 4c 2d 4f 53 0a 0a 20 20 20 53 65 65 20  RNEL-OS..   See 
3030: 74 68 65 20 66 69 6c 65 20 60 63 6f 6e 66 69 67  the file `config
3040: 2e 73 75 62 27 20 66 6f 72 20 74 68 65 20 70 6f  .sub' for the po
3050: 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 6f 66  ssible values of
3060: 20 65 61 63 68 20 66 69 65 6c 64 2e 20 20 49 66   each field.  If
3070: 0a 60 63 6f 6e 66 69 67 2e 73 75 62 27 20 69 73  .`config.sub' is
3080: 6e 27 74 20 69 6e 63 6c 75 64 65 64 20 69 6e 20  n't included in 
3090: 74 68 69 73 20 70 61 63 6b 61 67 65 2c 20 74 68  this package, th
30a0: 65 6e 20 74 68 69 73 20 70 61 63 6b 61 67 65 20  en this package 
30b0: 64 6f 65 73 6e 27 74 0a 6e 65 65 64 20 74 6f 20  doesn't.need to 
30c0: 6b 6e 6f 77 20 74 68 65 20 6d 61 63 68 69 6e 65  know the machine
30d0: 20 74 79 70 65 2e 0a 0a 20 20 20 49 66 20 79 6f   type...   If yo
30e0: 75 20 61 72 65 20 5f 62 75 69 6c 64 69 6e 67 5f  u are _building_
30f0: 20 63 6f 6d 70 69 6c 65 72 20 74 6f 6f 6c 73 20   compiler tools 
3100: 66 6f 72 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c  for cross-compil
3110: 69 6e 67 2c 20 79 6f 75 20 73 68 6f 75 6c 64 0a  ing, you should.
3120: 75 73 65 20 74 68 65 20 6f 70 74 69 6f 6e 20 60  use the option `
3130: 2d 2d 74 61 72 67 65 74 3d 54 59 50 45 27 20 74  --target=TYPE' t
3140: 6f 20 73 65 6c 65 63 74 20 74 68 65 20 74 79 70  o select the typ
3150: 65 20 6f 66 20 73 79 73 74 65 6d 20 74 68 65 79  e of system they
3160: 20 77 69 6c 6c 0a 70 72 6f 64 75 63 65 20 63 6f   will.produce co
3170: 64 65 20 66 6f 72 2e 0a 0a 20 20 20 49 66 20 79  de for...   If y
3180: 6f 75 20 77 61 6e 74 20 74 6f 20 5f 75 73 65 5f  ou want to _use_
3190: 20 61 20 63 72 6f 73 73 20 63 6f 6d 70 69 6c 65   a cross compile
31a0: 72 2c 20 74 68 61 74 20 67 65 6e 65 72 61 74 65  r, that generate
31b0: 73 20 63 6f 64 65 20 66 6f 72 20 61 0a 70 6c 61  s code for a.pla
31c0: 74 66 6f 72 6d 20 64 69 66 66 65 72 65 6e 74 20  tform different 
31d0: 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 20 70  from the build p
31e0: 6c 61 74 66 6f 72 6d 2c 20 79 6f 75 20 73 68 6f  latform, you sho
31f0: 75 6c 64 20 73 70 65 63 69 66 79 20 74 68 65 0a  uld specify the.
3200: 22 68 6f 73 74 22 20 70 6c 61 74 66 6f 72 6d 20  "host" platform 
3210: 28 69 2e 65 2e 2c 20 74 68 61 74 20 6f 6e 20 77  (i.e., that on w
3220: 68 69 63 68 20 74 68 65 20 67 65 6e 65 72 61 74  hich the generat
3230: 65 64 20 70 72 6f 67 72 61 6d 73 20 77 69 6c 6c  ed programs will
3240: 0a 65 76 65 6e 74 75 61 6c 6c 79 20 62 65 20 72  .eventually be r
3250: 75 6e 29 20 77 69 74 68 20 60 2d 2d 68 6f 73 74  un) with `--host
3260: 3d 54 59 50 45 27 2e 0a 0a 53 68 61 72 69 6e 67  =TYPE'...Sharing
3270: 20 44 65 66 61 75 6c 74 73 0a 3d 3d 3d 3d 3d 3d   Defaults.======
3280: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 49  ==========..   I
3290: 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 65  f you want to se
32a0: 74 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73  t default values
32b0: 20 66 6f 72 20 60 63 6f 6e 66 69 67 75 72 65 27   for `configure'
32c0: 20 73 63 72 69 70 74 73 20 74 6f 20 73 68 61 72   scripts to shar
32d0: 65 2c 0a 79 6f 75 20 63 61 6e 20 63 72 65 61 74  e,.you can creat
32e0: 65 20 61 20 73 69 74 65 20 73 68 65 6c 6c 20 73  e a site shell s
32f0: 63 72 69 70 74 20 63 61 6c 6c 65 64 20 60 63 6f  cript called `co
3300: 6e 66 69 67 2e 73 69 74 65 27 20 74 68 61 74 20  nfig.site' that 
3310: 67 69 76 65 73 0a 64 65 66 61 75 6c 74 20 76 61  gives.default va
3320: 6c 75 65 73 20 66 6f 72 20 76 61 72 69 61 62 6c  lues for variabl
3330: 65 73 20 6c 69 6b 65 20 60 43 43 27 2c 20 60 63  es like `CC', `c
3340: 61 63 68 65 5f 66 69 6c 65 27 2c 20 61 6e 64 20  ache_file', and 
3350: 60 70 72 65 66 69 78 27 2e 0a 60 63 6f 6e 66 69  `prefix'..`confi
3360: 67 75 72 65 27 20 6c 6f 6f 6b 73 20 66 6f 72 20  gure' looks for 
3370: 60 50 52 45 46 49 58 2f 73 68 61 72 65 2f 63 6f  `PREFIX/share/co
3380: 6e 66 69 67 2e 73 69 74 65 27 20 69 66 20 69 74  nfig.site' if it
3390: 20 65 78 69 73 74 73 2c 20 74 68 65 6e 0a 60 50   exists, then.`P
33a0: 52 45 46 49 58 2f 65 74 63 2f 63 6f 6e 66 69 67  REFIX/etc/config
33b0: 2e 73 69 74 65 27 20 69 66 20 69 74 20 65 78 69  .site' if it exi
33c0: 73 74 73 2e 20 20 4f 72 2c 20 79 6f 75 20 63 61  sts.  Or, you ca
33d0: 6e 20 73 65 74 20 74 68 65 0a 60 43 4f 4e 46 49  n set the.`CONFI
33e0: 47 5f 53 49 54 45 27 20 65 6e 76 69 72 6f 6e 6d  G_SITE' environm
33f0: 65 6e 74 20 76 61 72 69 61 62 6c 65 20 74 6f 20  ent variable to 
3400: 74 68 65 20 6c 6f 63 61 74 69 6f 6e 20 6f 66 20  the location of 
3410: 74 68 65 20 73 69 74 65 20 73 63 72 69 70 74 2e  the site script.
3420: 0a 41 20 77 61 72 6e 69 6e 67 3a 20 6e 6f 74 20  .A warning: not 
3430: 61 6c 6c 20 60 63 6f 6e 66 69 67 75 72 65 27 20  all `configure' 
3440: 73 63 72 69 70 74 73 20 6c 6f 6f 6b 20 66 6f 72  scripts look for
3450: 20 61 20 73 69 74 65 20 73 63 72 69 70 74 2e 0a   a site script..
3460: 0a 44 65 66 69 6e 69 6e 67 20 56 61 72 69 61 62  .Defining Variab
3470: 6c 65 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  les.============
3480: 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20 56 61 72 69 61  ======..   Varia
3490: 62 6c 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 64  bles not defined
34a0: 20 69 6e 20 61 20 73 69 74 65 20 73 68 65 6c 6c   in a site shell
34b0: 20 73 63 72 69 70 74 20 63 61 6e 20 62 65 20 73   script can be s
34c0: 65 74 20 69 6e 20 74 68 65 0a 65 6e 76 69 72 6f  et in the.enviro
34d0: 6e 6d 65 6e 74 20 70 61 73 73 65 64 20 74 6f 20  nment passed to 
34e0: 60 63 6f 6e 66 69 67 75 72 65 27 2e 20 20 48 6f  `configure'.  Ho
34f0: 77 65 76 65 72 2c 20 73 6f 6d 65 20 70 61 63 6b  wever, some pack
3500: 61 67 65 73 20 6d 61 79 20 72 75 6e 0a 63 6f 6e  ages may run.con
3510: 66 69 67 75 72 65 20 61 67 61 69 6e 20 64 75 72  figure again dur
3520: 69 6e 67 20 74 68 65 20 62 75 69 6c 64 2c 20 61  ing the build, a
3530: 6e 64 20 74 68 65 20 63 75 73 74 6f 6d 69 7a 65  nd the customize
3540: 64 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 73  d values of thes
3550: 65 0a 76 61 72 69 61 62 6c 65 73 20 6d 61 79 20  e.variables may 
3560: 62 65 20 6c 6f 73 74 2e 20 20 49 6e 20 6f 72 64  be lost.  In ord
3570: 65 72 20 74 6f 20 61 76 6f 69 64 20 74 68 69 73  er to avoid this
3580: 20 70 72 6f 62 6c 65 6d 2c 20 79 6f 75 20 73 68   problem, you sh
3590: 6f 75 6c 64 20 73 65 74 0a 74 68 65 6d 20 69 6e  ould set.them in
35a0: 20 74 68 65 20 60 63 6f 6e 66 69 67 75 72 65 27   the `configure'
35b0: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 75   command line, u
35c0: 73 69 6e 67 20 60 56 41 52 3d 76 61 6c 75 65 27  sing `VAR=value'
35d0: 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a  .  For example:.
35e0: 0a 20 20 20 20 20 2e 2f 63 6f 6e 66 69 67 75 72  .     ./configur
35f0: 65 20 43 43 3d 2f 75 73 72 2f 6c 6f 63 61 6c 32  e CC=/usr/local2
3600: 2f 62 69 6e 2f 67 63 63 0a 0a 63 61 75 73 65 73  /bin/gcc..causes
3610: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 60   the specified `
3620: 67 63 63 27 20 74 6f 20 62 65 20 75 73 65 64 20  gcc' to be used 
3630: 61 73 20 74 68 65 20 43 20 63 6f 6d 70 69 6c 65  as the C compile
3640: 72 20 28 75 6e 6c 65 73 73 20 69 74 20 69 73 0a  r (unless it is.
3650: 6f 76 65 72 72 69 64 64 65 6e 20 69 6e 20 74 68  overridden in th
3660: 65 20 73 69 74 65 20 73 68 65 6c 6c 20 73 63 72  e site shell scr
3670: 69 70 74 29 2e 0a 0a 55 6e 66 6f 72 74 75 6e 61  ipt)...Unfortuna
3680: 74 65 6c 79 2c 20 74 68 69 73 20 74 65 63 68 6e  tely, this techn
3690: 69 71 75 65 20 64 6f 65 73 20 6e 6f 74 20 77 6f  ique does not wo
36a0: 72 6b 20 66 6f 72 20 60 43 4f 4e 46 49 47 5f 53  rk for `CONFIG_S
36b0: 48 45 4c 4c 27 20 64 75 65 20 74 6f 0a 61 6e 20  HELL' due to.an 
36c0: 41 75 74 6f 63 6f 6e 66 20 62 75 67 2e 20 20 55  Autoconf bug.  U
36d0: 6e 74 69 6c 20 74 68 65 20 62 75 67 20 69 73 20  ntil the bug is 
36e0: 66 69 78 65 64 20 79 6f 75 20 63 61 6e 20 75 73  fixed you can us
36f0: 65 20 74 68 69 73 20 77 6f 72 6b 61 72 6f 75 6e  e this workaroun
3700: 64 3a 0a 0a 20 20 20 20 20 43 4f 4e 46 49 47 5f  d:..     CONFIG_
3710: 53 48 45 4c 4c 3d 2f 62 69 6e 2f 62 61 73 68 20  SHELL=/bin/bash 
3720: 2f 62 69 6e 2f 62 61 73 68 20 2e 2f 63 6f 6e 66  /bin/bash ./conf
3730: 69 67 75 72 65 20 43 4f 4e 46 49 47 5f 53 48 45  igure CONFIG_SHE
3740: 4c 4c 3d 2f 62 69 6e 2f 62 61 73 68 0a 0a 60 63  LL=/bin/bash..`c
3750: 6f 6e 66 69 67 75 72 65 27 20 49 6e 76 6f 63 61  onfigure' Invoca
3760: 74 69 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  tion.===========
3770: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 20 20 20  ===========..   
3780: 60 63 6f 6e 66 69 67 75 72 65 27 20 72 65 63 6f  `configure' reco
3790: 67 6e 69 7a 65 73 20 74 68 65 20 66 6f 6c 6c 6f  gnizes the follo
37a0: 77 69 6e 67 20 6f 70 74 69 6f 6e 73 20 74 6f 20  wing options to 
37b0: 63 6f 6e 74 72 6f 6c 20 68 6f 77 20 69 74 0a 6f  control how it.o
37c0: 70 65 72 61 74 65 73 2e 0a 0a 60 2d 2d 68 65 6c  perates...`--hel
37d0: 70 27 0a 60 2d 68 27 0a 20 20 20 20 20 50 72 69  p'.`-h'.     Pri
37e0: 6e 74 20 61 20 73 75 6d 6d 61 72 79 20 6f 66 20  nt a summary of 
37f0: 61 6c 6c 20 6f 66 20 74 68 65 20 6f 70 74 69 6f  all of the optio
3800: 6e 73 20 74 6f 20 60 63 6f 6e 66 69 67 75 72 65  ns to `configure
3810: 27 2c 20 61 6e 64 20 65 78 69 74 2e 0a 0a 60 2d  ', and exit...`-
3820: 2d 68 65 6c 70 3d 73 68 6f 72 74 27 0a 60 2d 2d  -help=short'.`--
3830: 68 65 6c 70 3d 72 65 63 75 72 73 69 76 65 27 0a  help=recursive'.
3840: 20 20 20 20 20 50 72 69 6e 74 20 61 20 73 75 6d       Print a sum
3850: 6d 61 72 79 20 6f 66 20 74 68 65 20 6f 70 74 69  mary of the opti
3860: 6f 6e 73 20 75 6e 69 71 75 65 20 74 6f 20 74 68  ons unique to th
3870: 69 73 20 70 61 63 6b 61 67 65 27 73 0a 20 20 20  is package's.   
3880: 20 20 60 63 6f 6e 66 69 67 75 72 65 27 2c 20 61    `configure', a
3890: 6e 64 20 65 78 69 74 2e 20 20 54 68 65 20 60 73  nd exit.  The `s
38a0: 68 6f 72 74 27 20 76 61 72 69 61 6e 74 20 6c 69  hort' variant li
38b0: 73 74 73 20 6f 70 74 69 6f 6e 73 20 75 73 65 64  sts options used
38c0: 0a 20 20 20 20 20 6f 6e 6c 79 20 69 6e 20 74 68  .     only in th
38d0: 65 20 74 6f 70 20 6c 65 76 65 6c 2c 20 77 68 69  e top level, whi
38e0: 6c 65 20 74 68 65 20 60 72 65 63 75 72 73 69 76  le the `recursiv
38f0: 65 27 20 76 61 72 69 61 6e 74 20 6c 69 73 74 73  e' variant lists
3900: 20 6f 70 74 69 6f 6e 73 0a 20 20 20 20 20 61 6c   options.     al
3910: 73 6f 20 70 72 65 73 65 6e 74 20 69 6e 20 61 6e  so present in an
3920: 79 20 6e 65 73 74 65 64 20 70 61 63 6b 61 67 65  y nested package
3930: 73 2e 0a 0a 60 2d 2d 76 65 72 73 69 6f 6e 27 0a  s...`--version'.
3940: 60 2d 56 27 0a 20 20 20 20 20 50 72 69 6e 74 20  `-V'.     Print 
3950: 74 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 41  the version of A
3960: 75 74 6f 63 6f 6e 66 20 75 73 65 64 20 74 6f 20  utoconf used to 
3970: 67 65 6e 65 72 61 74 65 20 74 68 65 20 60 63 6f  generate the `co
3980: 6e 66 69 67 75 72 65 27 0a 20 20 20 20 20 73 63  nfigure'.     sc
3990: 72 69 70 74 2c 20 61 6e 64 20 65 78 69 74 2e 0a  ript, and exit..
39a0: 0a 60 2d 2d 63 61 63 68 65 2d 66 69 6c 65 3d 46  .`--cache-file=F
39b0: 49 4c 45 27 0a 20 20 20 20 20 45 6e 61 62 6c 65  ILE'.     Enable
39c0: 20 74 68 65 20 63 61 63 68 65 3a 20 75 73 65 20   the cache: use 
39d0: 61 6e 64 20 73 61 76 65 20 74 68 65 20 72 65 73  and save the res
39e0: 75 6c 74 73 20 6f 66 20 74 68 65 20 74 65 73 74  ults of the test
39f0: 73 20 69 6e 20 46 49 4c 45 2c 0a 20 20 20 20 20  s in FILE,.     
3a00: 74 72 61 64 69 74 69 6f 6e 61 6c 6c 79 20 60 63  traditionally `c
3a10: 6f 6e 66 69 67 2e 63 61 63 68 65 27 2e 20 20 46  onfig.cache'.  F
3a20: 49 4c 45 20 64 65 66 61 75 6c 74 73 20 74 6f 20  ILE defaults to 
3a30: 60 2f 64 65 76 2f 6e 75 6c 6c 27 20 74 6f 0a 20  `/dev/null' to. 
3a40: 20 20 20 20 64 69 73 61 62 6c 65 20 63 61 63 68      disable cach
3a50: 69 6e 67 2e 0a 0a 60 2d 2d 63 6f 6e 66 69 67 2d  ing...`--config-
3a60: 63 61 63 68 65 27 0a 60 2d 43 27 0a 20 20 20 20  cache'.`-C'.    
3a70: 20 41 6c 69 61 73 20 66 6f 72 20 60 2d 2d 63 61   Alias for `--ca
3a80: 63 68 65 2d 66 69 6c 65 3d 63 6f 6e 66 69 67 2e  che-file=config.
3a90: 63 61 63 68 65 27 2e 0a 0a 60 2d 2d 71 75 69 65  cache'...`--quie
3aa0: 74 27 0a 60 2d 2d 73 69 6c 65 6e 74 27 0a 60 2d  t'.`--silent'.`-
3ab0: 71 27 0a 20 20 20 20 20 44 6f 20 6e 6f 74 20 70  q'.     Do not p
3ac0: 72 69 6e 74 20 6d 65 73 73 61 67 65 73 20 73 61  rint messages sa
3ad0: 79 69 6e 67 20 77 68 69 63 68 20 63 68 65 63 6b  ying which check
3ae0: 73 20 61 72 65 20 62 65 69 6e 67 20 6d 61 64 65  s are being made
3af0: 2e 20 20 54 6f 0a 20 20 20 20 20 73 75 70 70 72  .  To.     suppr
3b00: 65 73 73 20 61 6c 6c 20 6e 6f 72 6d 61 6c 20 6f  ess all normal o
3b10: 75 74 70 75 74 2c 20 72 65 64 69 72 65 63 74 20  utput, redirect 
3b20: 69 74 20 74 6f 20 60 2f 64 65 76 2f 6e 75 6c 6c  it to `/dev/null
3b30: 27 20 28 61 6e 79 20 65 72 72 6f 72 0a 20 20 20  ' (any error.   
3b40: 20 20 6d 65 73 73 61 67 65 73 20 77 69 6c 6c 20    messages will 
3b50: 73 74 69 6c 6c 20 62 65 20 73 68 6f 77 6e 29 2e  still be shown).
3b60: 0a 0a 60 2d 2d 73 72 63 64 69 72 3d 44 49 52 27  ..`--srcdir=DIR'
3b70: 0a 20 20 20 20 20 4c 6f 6f 6b 20 66 6f 72 20 74  .     Look for t
3b80: 68 65 20 70 61 63 6b 61 67 65 27 73 20 73 6f 75  he package's sou
3b90: 72 63 65 20 63 6f 64 65 20 69 6e 20 64 69 72 65  rce code in dire
3ba0: 63 74 6f 72 79 20 44 49 52 2e 20 20 55 73 75 61  ctory DIR.  Usua
3bb0: 6c 6c 79 0a 20 20 20 20 20 60 63 6f 6e 66 69 67  lly.     `config
3bc0: 75 72 65 27 20 63 61 6e 20 64 65 74 65 72 6d 69  ure' can determi
3bd0: 6e 65 20 74 68 61 74 20 64 69 72 65 63 74 6f 72  ne that director
3be0: 79 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e  y automatically.
3bf0: 0a 0a 60 2d 2d 70 72 65 66 69 78 3d 44 49 52 27  ..`--prefix=DIR'
3c00: 0a 20 20 20 20 20 55 73 65 20 44 49 52 20 61 73  .     Use DIR as
3c10: 20 74 68 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f   the installatio
3c20: 6e 20 70 72 65 66 69 78 2e 20 20 2a 6e 6f 74 65  n prefix.  *note
3c30: 20 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 4e 61   Installation Na
3c40: 6d 65 73 3a 3a 0a 20 20 20 20 20 66 6f 72 20 6d  mes::.     for m
3c50: 6f 72 65 20 64 65 74 61 69 6c 73 2c 20 69 6e 63  ore details, inc
3c60: 6c 75 64 69 6e 67 20 6f 74 68 65 72 20 6f 70 74  luding other opt
3c70: 69 6f 6e 73 20 61 76 61 69 6c 61 62 6c 65 20 66  ions available f
3c80: 6f 72 20 66 69 6e 65 2d 74 75 6e 69 6e 67 0a 20  or fine-tuning. 
3c90: 20 20 20 20 74 68 65 20 69 6e 73 74 61 6c 6c 61      the installa
3ca0: 74 69 6f 6e 20 6c 6f 63 61 74 69 6f 6e 73 2e 0a  tion locations..
3cb0: 0a 60 2d 2d 6e 6f 2d 63 72 65 61 74 65 27 0a 60  .`--no-create'.`
3cc0: 2d 6e 27 0a 20 20 20 20 20 52 75 6e 20 74 68 65  -n'.     Run the
3cd0: 20 63 6f 6e 66 69 67 75 72 65 20 63 68 65 63 6b   configure check
3ce0: 73 2c 20 62 75 74 20 73 74 6f 70 20 62 65 66 6f  s, but stop befo
3cf0: 72 65 20 63 72 65 61 74 69 6e 67 20 61 6e 79 20  re creating any 
3d00: 6f 75 74 70 75 74 0a 20 20 20 20 20 66 69 6c 65  output.     file
3d10: 73 2e 0a 0a 60 63 6f 6e 66 69 67 75 72 65 27 20  s...`configure' 
3d20: 61 6c 73 6f 20 61 63 63 65 70 74 73 20 73 6f 6d  also accepts som
3d30: 65 20 6f 74 68 65 72 2c 20 6e 6f 74 20 77 69 64  e other, not wid
3d40: 65 6c 79 20 75 73 65 66 75 6c 2c 20 6f 70 74 69  ely useful, opti
3d50: 6f 6e 73 2e 20 20 52 75 6e 0a 60 63 6f 6e 66 69  ons.  Run.`confi
3d60: 67 75 72 65 20 2d 2d 68 65 6c 70 27 20 66 6f 72  gure --help' for
3d70: 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a 0a   more details...