configure.man

   1 .\" -*- nroff -*-
   2 .\" Copyright (c) 1991 Cygnus Support
   3 .\" $Id$
   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 ...]] [-datadir=dir] [-gas] [-help]
  16 [-host=h] [-namesubdir=name] [-nfp] [-norecursion] [-objdir=dir]
  17 [-prefix=dir] [-recurring] [-rm] [-site=s] [-srcdir=dir] [-subdirs]
  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 \-datadir=dir
  32 sets the root directory for host independent files to
  33 .I dir.
  34
  35 .TP
  36 .I \-gas
  37 tells configure that the GNU assembler is available on this machine
  38 even if it is not ordinarily.
  39
  40 .TP
  41 .I \-help
  42 displays a brief summary of the calling convention.
  43
  44 .TP
  45 .I \-host=h
  46 asks configure to prepare the source to be compiled in an environment
  47 called
  48 .I h.
  49 This option is very confusing and is best ignored.  FIXME: I don't
  50 think it should even be documented.
  51
  52 .TP
  53 .I \-namesubdir=name
  54 When using -subdirs, this option sets the name of the subdir to be
  55 created.  This isn't very useful when configuring for multiple hosts.
  56 NOTE: support for this option is temporarily suspended.
  57
  58 .TP
  59 .I \-nfp
  60 Notifies configure that all of the specified hosts have
  61 .I no floating point
  62 units.
  63
  64 .TP
  65 .I \-norecursion
  66 asks that only the current directory be configured.  Normally
  67 configure recurs on subdirectories.
  68
  69 .TP
  70 .I \-objdir=dir
  71 asks that the build directories be created in dir.  NOTE: support for
  72 this option is at least temporarily suspended.
  73
  74 .TP
  75 .I \-prefix=dir
  76 sets the default location in which to install files to dir.  The
  77 default is "/usr/local".
  78
  79 .TP
  80 .I \-recurring
  81 used internally by configure to supress status messages on
  82 subdirectory recursions.
  83
  84 .TP
  85 .I \-rm
  86 asks configure to remove a configuration rather than creating one.
  87
  88 .TP
  89 .I \-site=s
  90 asks configure to use any site specific Makefile fragments for s when
  91 building Makefiles.
  92
  93 .TP
  94 .I \-srcdir=dir
  95 tells configure to find the source in srcdir.
  96
  97 .TP
  98 .I \-subdirs
  99 asks configure to create subdirectories of the build directory named
 100 "H-host" for each host.  If the configuration is not native, (host is
 101 not target), the the directory will be named "X-host-target" instead.
 102 NOTE: support for this option is temporarily suspended.
 103
 104 .TP
 105 .I \-target=t
 106 Requests that the sources be configured to target the t machine.  If
 107 no targets are specified explicitly, the target is assumed to be the
 108 same as the host.  If multiple targets are specified, configurations
 109 for each are created and -subdirs is assumed.
 110
 111 NOTE: support for multiple targets is at least temporarily suspended.
 112
 113 .TP
 114 .I \-tmpdir=dir
 115 Sets the directory in which configure creates temporary files to
 116 tmpdir.
 117
 118 .TP
 119 .I \-verbose
 120 .I \-v
 121 Asks that configure print status lines for each directory configured.
 122 Normally, only the status lines for the current directory are printed.
 123
 124 .TP
 125 .I \-x
 126 Tells configure that MIT style X11 header files and libraries are
 127 available on this machine, even if they are not normally available.
 128
 129 .SH FILES
 130 configure.in    for each directory's individual needs
 131 config.subr     for parsing configuration names
 132
 133 .SH "SEE ALSO"
 134 .RB "`\|" configure "\|'"
 135 entry in
 136 .B
 137 info. (not yet available).