configure.man

   1 .\" -*- nroff -*-
   2 .\" Copyright (c) 1991, 1992 Cygnus Support
   3 .\" written by K. Richard Pixley
   4 .TH configure 1 "13 December 1991" "cygnus support" "Cygnus Support"
   5 .de BP
   6 .sp
   7 .ti \-.2i
   8 \(**
   9 ..
  10
  11 .SH NAME
  12 configure \(em\& prepare source code to be built
  13
  14 .SH SYNOPSIS
  15 configure host1 [host2 [host3 ...]] [-exec_prefix=dir] [-gas] [-help]
  16 [-host=h] [-nfp] [-norecursion]
  17 [-prefix=dir] [-s] [-rm] [-site=s] [-srcdir=dir]
  18 [-target=t] [-v] [-x]
  19
  20 .SH DESCRIPTION
  21 .I Configure
  22 is a program used to prepare souce code to be built.  It does this by
  23 generating Makefiles and .gdbinit files, creating symlinks, digging
  24 directories, and some other miscellaneous file editting.
  25
  26 .SH OPTIONS
  27 .I Configure
  28 accepts the following options:
  29
  30 .TP
  31 .I \-exec_prefix=dir
  32 sets the root directory for host dependent files to
  33 .I dir.
  34 The default location is the same as
  35 .I prefix.
  36
  37 .TP
  38 .I \-gas
  39 tells configure that the GNU assembler is available on this machine
  40 even if it is not ordinarily.
  41
  42 .TP
  43 .I \-help
  44 displays a brief summary of the calling convention.
  45
  46 .TP
  47 .I \-host=h
  48 asks configure to prepare the source to be compiled in an environment
  49 called
  50 .I h.
  51 This option is very confusing and is best ignored.  FIXME: I don't
  52 think it should even be documented.
  53
  54 .TP
  55 .I \-nfp
  56 Notifies configure that all of the specified hosts have
  57 .I no floating point
  58 units.
  59
  60 .TP
  61 .I \-norecursion
  62 asks that only the current directory be configured.  Normally
  63 configure recurs on subdirectories.
  64
  65 .TP
  66 .I \-prefix=dir
  67 sets the default location in which to install files to dir.  The
  68 default is "/usr/local".
  69
  70 .TP
  71 .I \-s
  72 used internally by configure to supress status messages on
  73 subdirectory recursions.
  74
  75 .TP
  76 .I \-rm
  77 asks configure to remove a configuration rather than creating one.
  78
  79 .TP
  80 .I \-site=s
  81 asks configure to use any site specific Makefile fragments for s when
  82 building Makefiles.
  83
  84 .TP
  85 .I \-srcdir=dir
  86 tells configure to find the source in srcdir.
  87
  88 .TP
  89 .I \-target=t
  90 Requests that the sources be configured to target the t machine.  If
  91 no targets are specified explicitly, the target is assumed to be the
  92 same as the host.
  93
  94 .TP
  95 .I \-tmpdir=dir
  96 Sets the directory in which configure creates temporary files to
  97 tmpdir.
  98
  99 .TP
 100 .I \-verbose
 101 .I \-v
 102 Asks that configure print status lines for each directory configured.
 103 Normally, only the status lines for the current directory are printed.
 104
 105 .TP
 106 .I \-x
 107 Tells configure that MIT style X11 header files and libraries are
 108 available on this machine, even if they are not normally available.
 109
 110 .SH FILES
 111 configure.in    for each directory's individual needs
 112 config.sub      for parsing configuration names
 113
 114 .SH "SEE ALSO"
 115 .RB "`\|" configure "\|'"
 116 entry in
 117 .B
 118 info. (not yet available).