mirror of
https://github.com/darlinghq/darling-gdb.git
synced 2024-11-28 14:30:48 +00:00
This is the second batch of makefile changes. Libg++ makefiles were
checked in earlier. These are Makefiles relevant to the progressive
release currently in progress.
* added exec_prefix
* default bindir now exec_prefix/bin
* default libdir now exec_prefix/lib
* default mandir now prefix/man
* default infodir now prefix/info
* added oldincludedir, default NULL
* remove all traces of the old -subdirs and -namesubdir support,
including code, for loops, and all subdir/unsubdir stuff.
* remove old style staging targets {de-}stage[1234], comparison,
bootstrapN, from all but the bootstrappable tools.
* added check targets.
* removed any "Last Mod" lines.
* forced copyrights to '92 and shifted some from Cygnus to FSF.
* added tooldir and program_prefix where needed.
* updated texinfo and man pages, removed all references to multiple
hosts or targets.
This commit is contained in:
K. Richard Pixley
parent
335413d8ea
commit
787c6bfe70
@ -10,7 +10,7 @@ This document attempts to describe the general concepts behind
|
||||
configuration of the Cygnus Support release of the @sc{gnu} Development
|
||||
Tools. It also discusses common usage..
|
||||
|
||||
Copyright (C) 1991 Cygnus Support
|
||||
Copyright (C) 1991, 1992 Cygnus Support
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
are preserved on all copies.
|
||||
@ -41,7 +41,7 @@ by Cygnus Support.
|
||||
@page
|
||||
|
||||
@vskip 0pt plus 1filll
|
||||
Copyright @copyright{} 1991 Cygnus Support
|
||||
Copyright @copyright{} 1991, 1992 Cygnus Support
|
||||
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
@ -214,13 +214,14 @@ while for a sun4 with postfix you might use:
|
||||
./configure sun4 -notation=postfix
|
||||
@end example
|
||||
|
||||
If we wanted to build both at the same time, in the same directory
|
||||
structure, the intermediate pieces used in the build process must be
|
||||
kept separate.
|
||||
If we wanted to build both at the same time, the intermediate pieces
|
||||
used in the build process must be kept separate.
|
||||
|
||||
@example
|
||||
./configure sun4 -subdirs -notation=postfix
|
||||
./configure sun3 -subdirs -notation=infix
|
||||
mkdir ../objdir.sun4
|
||||
(cd ../objdir.sun4 ; ./configure sun4 -notation=postfix -srcdir=../src)
|
||||
mkdir ../objdir.sun3
|
||||
(cd ../objdir.sun3 ; ./configure sun3 -notation=infix -srcdir=../src)
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
@ -228,13 +229,14 @@ will create subdirectories for the intermediate pieces of the sun4 and
|
||||
sun3 configurations. This is necessary as previous systems were only
|
||||
capable of one configuration at a time. Otherwise, a second
|
||||
configuration would write over the first. We've chosen to retain this
|
||||
behaviour so the @code{-subdirs} configuration option is necessary to
|
||||
get the new behaviour. The order of the arguments doesn't matter.
|
||||
There should be exactly one argument without a leading @samp{-} sign
|
||||
and that argument will be assumed to be the host name.
|
||||
behaviour so the obj directories and the @code{-srcdir} configuration
|
||||
option are necessary to get the new behaviour. The order of the
|
||||
arguments doesn't matter. There should be exactly one argument without
|
||||
a leading @samp{-} sign and that argument will be assumed to be the host
|
||||
name.
|
||||
|
||||
From here on the examples will assume that you want to build the tools
|
||||
@emph{in place} and won't show the @code{-subdirs} option, but remember
|
||||
@emph{in place} and won't show the @code{-srcdir} option, but remember
|
||||
that it is available.
|
||||
|
||||
In order to actually install the program, the configuration system needs
|
||||
@ -687,10 +689,6 @@ configures this directory, perhaps recursively, for a single host+target
|
||||
pair where the host is @var{hostname} and target is @var{targetname}.
|
||||
If a previous configuration existed, it will be overwritten.
|
||||
|
||||
@item ./configure -subdirs @var{hostname} -target=@var{targetname}
|
||||
creates a subdirectories @file{H-@var{hostname}} if @var{hostname} is @var{targetname} or
|
||||
@file{X-@var{hostname}-@var{targetname}} if it is not and configures the new directory.
|
||||
|
||||
@end table
|
||||
|
||||
@menu
|
||||
@ -709,7 +707,7 @@ The Makefile is created by prepending some variable definitions to a
|
||||
Makefile template called @file{Makefile.in} and then inserting host and
|
||||
target specific Makefile fragments. The variables are set based on the
|
||||
chosen host+target pair and build style, that is, if you use
|
||||
subdirectories or not. The host and target specific Makefile may or may
|
||||
@code{-srcdir} or not. The host and target specific Makefile may or may
|
||||
not exist.
|
||||
|
||||
@itemize @bullet
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
# script appropriate for this directory. For more information, check
|
||||
# any existing configure script.
|
||||
|
||||
configdirs="libiberty texinfo bfd binutils byacc bison gcc readline glob flex ld gas gnulib clib gdb emacs ispell make grep diff rcs gdbm cvs patch send_pr fileutils libg++"
|
||||
configdirs="libiberty texinfo bfd binutils byacc bison gcc readline glob ld gas gdb emacs ispell make grep diff rcs gdbm cvs patch send_pr libg++"
|
||||
srctrigger=cfg-paper.texi
|
||||
srcname="gnu development package"
|
||||
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
.\" -*- nroff -*-
|
||||
.\" Copyright (c) 1991 Cygnus Support
|
||||
.\" $Id$
|
||||
.\" Copyright (c) 1991, 1992 Cygnus Support
|
||||
.\" written by K. Richard Pixley
|
||||
.TH configure 1 "13 December 1991" "cygnus support" "Cygnus Support"
|
||||
.de BP
|
||||
.sp
|
||||
@ -12,9 +12,9 @@
|
||||
configure \(em\& prepare source code to be built
|
||||
|
||||
.SH SYNOPSIS
|
||||
configure host1 [host2 [host3 ...]] [-datadir=dir] [-gas] [-help]
|
||||
[-host=h] [-namesubdir=name] [-nfp] [-norecursion] [-objdir=dir]
|
||||
[-prefix=dir] [-recurring] [-rm] [-site=s] [-srcdir=dir] [-subdirs]
|
||||
configure host1 [host2 [host3 ...]] [-exec_prefix=dir] [-gas] [-help]
|
||||
[-host=h] [-nfp] [-norecursion]
|
||||
[-prefix=dir] [-s] [-rm] [-site=s] [-srcdir=dir]
|
||||
[-target=t] [-v] [-x]
|
||||
|
||||
.SH DESCRIPTION
|
||||
@ -28,9 +28,11 @@ directories, and some other miscellaneous file editting.
|
||||
accepts the following options:
|
||||
|
||||
.TP
|
||||
.I \-datadir=dir
|
||||
sets the root directory for host independent files to
|
||||
.I \-exec_prefix=dir
|
||||
sets the root directory for host dependent files to
|
||||
.I dir.
|
||||
The default location is the same as
|
||||
.I prefix.
|
||||
|
||||
.TP
|
||||
.I \-gas
|
||||
@ -49,12 +51,6 @@ called
|
||||
This option is very confusing and is best ignored. FIXME: I don't
|
||||
think it should even be documented.
|
||||
|
||||
.TP
|
||||
.I \-namesubdir=name
|
||||
When using -subdirs, this option sets the name of the subdir to be
|
||||
created. This isn't very useful when configuring for multiple hosts.
|
||||
NOTE: support for this option is temporarily suspended.
|
||||
|
||||
.TP
|
||||
.I \-nfp
|
||||
Notifies configure that all of the specified hosts have
|
||||
@ -66,18 +62,13 @@ units.
|
||||
asks that only the current directory be configured. Normally
|
||||
configure recurs on subdirectories.
|
||||
|
||||
.TP
|
||||
.I \-objdir=dir
|
||||
asks that the build directories be created in dir. NOTE: support for
|
||||
this option is at least temporarily suspended.
|
||||
|
||||
.TP
|
||||
.I \-prefix=dir
|
||||
sets the default location in which to install files to dir. The
|
||||
default is "/usr/local".
|
||||
|
||||
.TP
|
||||
.I \-recurring
|
||||
.I \-s
|
||||
used internally by configure to supress status messages on
|
||||
subdirectory recursions.
|
||||
|
||||
@ -94,21 +85,11 @@ building Makefiles.
|
||||
.I \-srcdir=dir
|
||||
tells configure to find the source in srcdir.
|
||||
|
||||
.TP
|
||||
.I \-subdirs
|
||||
asks configure to create subdirectories of the build directory named
|
||||
"H-host" for each host. If the configuration is not native, (host is
|
||||
not target), the the directory will be named "X-host-target" instead.
|
||||
NOTE: support for this option is temporarily suspended.
|
||||
|
||||
.TP
|
||||
.I \-target=t
|
||||
Requests that the sources be configured to target the t machine. If
|
||||
no targets are specified explicitly, the target is assumed to be the
|
||||
same as the host. If multiple targets are specified, configurations
|
||||
for each are created and -subdirs is assumed.
|
||||
|
||||
NOTE: support for multiple targets is at least temporarily suspended.
|
||||
same as the host.
|
||||
|
||||
.TP
|
||||
.I \-tmpdir=dir
|
||||
@ -128,7 +109,7 @@ available on this machine, even if they are not normally available.
|
||||
|
||||
.SH FILES
|
||||
configure.in for each directory's individual needs
|
||||
config.subr for parsing configuration names
|
||||
config.sub for parsing configuration names
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.RB "`\|" configure "\|'"
|
||||
|
||||
295
configure.texi
295
configure.texi
@ -14,7 +14,7 @@
|
||||
This document attempts to describe the Cygnus Support version of
|
||||
@code{configure}.
|
||||
|
||||
Copyright (C) 1991 Cygnus Support
|
||||
Copyright (C) 1991, 1992 Cygnus Support
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
are preserved on all copies.
|
||||
@ -46,7 +46,7 @@ by Cygnus Support.
|
||||
@page
|
||||
|
||||
@vskip 0pt plus 1filll
|
||||
Copyright @copyright{} 1991 Cygnus Support
|
||||
Copyright @copyright{} 1991, 1992 Cygnus Support
|
||||
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
@ -76,11 +76,6 @@ END-INFO-DIR-ENTRY
|
||||
This file documents the configuration system used and distributed by
|
||||
Cygnus Support.
|
||||
|
||||
NOTE: support for a Cygnus experimental option, @code{-subdirs} is at
|
||||
least temporarily suspended. Most of the code is still in configure but
|
||||
the option is disabled. This document describes that feature, but those
|
||||
parts are prominently marked with NOTE's like this one. FIXME-soon
|
||||
|
||||
@menu
|
||||
* What Configure Does:: What Configure Does
|
||||
* Invoking:: Invoking
|
||||
@ -91,28 +86,59 @@ parts are prominently marked with NOTE's like this one. FIXME-soon
|
||||
* Variables Index:: Variable Index
|
||||
* Concept Index:: Concept Index
|
||||
|
||||
--- The Detailed Node Listing ---
|
||||
|
||||
Using Configure
|
||||
|
||||
* Install Locations:: Where to install things once they are built
|
||||
* Build Directories:: Where to build object files
|
||||
* Host:: Telling @code{configure} what will source will
|
||||
be built
|
||||
* Target:: Telling @code{configure} what the source will
|
||||
target
|
||||
* Local Conventions:: Adding information about local conventions
|
||||
|
||||
Install Locations
|
||||
|
||||
* prefix:: Changing the default install directory
|
||||
* exec_prefix:: How to separate host independent files
|
||||
from host dependent files when
|
||||
installing for multiple hosts
|
||||
* Install Details:: Full descriptions of all installation
|
||||
subdirectories
|
||||
|
||||
Porting with Configure
|
||||
|
||||
* Programs:: Adding configure to new programs
|
||||
* Hosts and Targets:: Adding hosts and targets
|
||||
* Sites:: Adding site info
|
||||
|
||||
Gory details described
|
||||
|
||||
* Makefile Extensions:: Extensions to the @sc{gnu} coding standards
|
||||
* configure.in:: The format of the configure.in file
|
||||
* config.status:: config.status
|
||||
* Makefile Fragments:: Makefile Fragments
|
||||
|
||||
The format of the @file{configure.in} file
|
||||
|
||||
* Minimal:: A minimal configure.in
|
||||
* Configure Variables:: Variables available to configure.in
|
||||
* Declarations:: For each invocation
|
||||
* Per-host:: For each host
|
||||
* Per-target:: For each target
|
||||
* Post-target:: After each target
|
||||
* Example:: An example configure.in
|
||||
@end menu
|
||||
|
||||
@end ifinfo
|
||||
|
||||
@iftex
|
||||
@unnumbered Preface
|
||||
NOTE: support for a Cygnus experimental option, @code{-subdirs} is at
|
||||
least temporarily suspended. Most of the code is still in configure but
|
||||
the option is disabled. This document describes that feature, but those
|
||||
parts are prominently marked with NOTE's like this one. FIXME-soon
|
||||
@end iftex
|
||||
|
||||
@node What Configure Does, Invoking, top, top
|
||||
@chapter What Configure Does
|
||||
|
||||
@code{configure} prepares source directories for building working
|
||||
programs. A program cannot be built until its source has been
|
||||
configured. When configure runs, it does the following things for each source
|
||||
directory for each host and target combination.
|
||||
@*
|
||||
NOTE: support for multiple hosts and targets is at least temporarily
|
||||
suspended.
|
||||
configured. When configure runs, it does the following things.
|
||||
|
||||
@table @emph
|
||||
@item Create build directories
|
||||
@ -121,26 +147,16 @@ suspended.
|
||||
directory, creating under it a directory tree that parallels the
|
||||
directory structure under the source directory. (See @ref{Invoking}).
|
||||
|
||||
NOTE: support for @code{-subdirs} is at least temporarily suspended.
|
||||
@*
|
||||
When you run @code{configure} with the @code{-subdirs} option, it
|
||||
creates a build subdirectory in each source directory.
|
||||
|
||||
If you use both @code{-subdirs} and @code{-srcdir=}, a tree that
|
||||
parallels the source directory structure is created in the current
|
||||
directory, and the subdirectories are created in this directory tree
|
||||
rather than in the source directories.
|
||||
|
||||
@item Generate makefiles
|
||||
A makefile template from the source directory, usually called
|
||||
@file{Makefile.in}, is copied to an output file in the build directory.
|
||||
The output file is usually named @file{Makefile}. @code{configure}
|
||||
places definitions for a number of standard makefile
|
||||
macros at the beginning of the output file. If @code{-prefix=} or
|
||||
@code{-datadir=} were specified on the @code{configure} command line,
|
||||
corresponding makefile variables are set accordingly. If host, target, or
|
||||
site specific makefile fragments exist, these are inserted into the
|
||||
output file. (See @ref{Makefiles, , , make, Makefiles}.)
|
||||
places definitions for a number of standard makefile macros at the
|
||||
beginning of the output file. If @code{-prefix=} or @code{-exec_prefix}
|
||||
were specified on the @code{configure} command line, corresponding
|
||||
makefile variables are set accordingly. If host, target, or site
|
||||
specific makefile fragments exist, these are inserted into the output
|
||||
file. (See @ref{Makefiles, , , make, Makefiles}.)
|
||||
|
||||
@item Generate @file{.gdbinit} If the source directory contains a
|
||||
@file{.gdbinit} file and the build directory is not the same as the
|
||||
@ -185,24 +201,18 @@ This prepares the source to be compiled in a
|
||||
@var{host} environment with programs and files to be installed in
|
||||
@file{/usr/local}.
|
||||
|
||||
NOTE: support for multiple hosts is at least temporarily suspended.
|
||||
FIXME-soon
|
||||
@*
|
||||
If more than one host is specified on the command line, then
|
||||
configurations are created for each and @code{-subdirs} is assumed.
|
||||
|
||||
@code{configure} prepares the source as you specify by selecting and
|
||||
using script and Makefile fragments prepared in advance, and stored with
|
||||
the source. @code{configure}'s command line options also allow you to
|
||||
specify other aspects of the source configuration:
|
||||
|
||||
@table @code
|
||||
@item -datadir=@var{dir}
|
||||
Configure the source to install host independent files in @var{dir}.
|
||||
@item -exec_prefix=@var{dir}
|
||||
Configure the source to install host dependent files in @var{dir}.
|
||||
|
||||
This option sets the @code{configure} variable @code{datadir}.
|
||||
Generated Makefiles will have their @code{datadir} variables set to this
|
||||
value. (See @ref{Install Details}.)
|
||||
This option sets the @code{configure} variable @code{exec_prefix}.
|
||||
Generated Makefiles will have their @code{exec_prefix} variables set to
|
||||
this value. (See @ref{Install Details}.)
|
||||
|
||||
@item -gas
|
||||
Configure to use the @sc{GNU} assembler.
|
||||
@ -214,18 +224,6 @@ Display a quick summary of how to invoke @code{configure}.
|
||||
FIXME-soon: I don't think this option should be documented.
|
||||
@c Then why does it exist? /Pesch 7jan92
|
||||
|
||||
@item -namesubdir=@var{name}
|
||||
NOTE: support for this @code{-namesubdir=} is at least temporarily
|
||||
suspended. FIXME-soon
|
||||
|
||||
Name any subdirectories created by the @code{-subdirs} option
|
||||
@file{@var{name}}.
|
||||
|
||||
@emph{Warning:} Avoid using this option if you specify multiple hosts
|
||||
simultaneously. There is no way to specify separate names for
|
||||
subdirectories, when you configure for multiple hosts in a single
|
||||
invocation of @code{configure}.
|
||||
|
||||
@item -nfp
|
||||
@emph{No floating point} unit available on the target; configure to
|
||||
avoid dependencies on hardware floating point.
|
||||
@ -235,13 +233,6 @@ Configure only this directory; ignore any subdirectories. This is used
|
||||
by the executable shell script @file{config.status} to reconfigure the
|
||||
current directory. (see @ref{config.status}).
|
||||
|
||||
@ignore
|
||||
@c This is complicated enough without "no longer supported" entries.
|
||||
@c Should really delete this, but for ease of discourse...
|
||||
@item -objdir=@var{dir}
|
||||
This option is no longer supported. Use @code{-srcdir=} instead.
|
||||
@end ignore
|
||||
|
||||
@item -prefix=@var{dir}
|
||||
Configure the source to install programs and files under directory
|
||||
@file{@var{dir}}.
|
||||
@ -268,29 +259,11 @@ Generate Makefiles using site specific Makefile fragments for
|
||||
Build Makefiles to use the sources located in directory @file{@var{dir}}. The
|
||||
build directory is assumed to be @file{.}.
|
||||
|
||||
@item -subdirs
|
||||
NOTE: support for this @code{-subdirs} is at least temporary suspended.
|
||||
FIXME-soon
|
||||
|
||||
Place configurations in subdirectories of each build directory.
|
||||
@code{configure} builds a separate subdirectory for each host specified,
|
||||
and names it @file{H-@var{host}}. If a configuration is not native,
|
||||
(@var{host} is not @var{target}), then the subdirectory is named
|
||||
@file{X-@var{host}-@var{target}} instead. You can also name a
|
||||
subdirectory explicitly using the @samp{-namesubdir} option, but this is
|
||||
effective only when you specify one configuration at a time.
|
||||
|
||||
@item -target=@var{target}
|
||||
Requests that the sources be configured to target the @var{target}
|
||||
machine. If no target is specified explicitly, the target is assumed
|
||||
to be the same as the host.
|
||||
|
||||
NOTE: support for multiple targets is at least temporarily suspended.
|
||||
FIXME-soon
|
||||
@*
|
||||
If multiple targets are specified, configurations for each
|
||||
are created and @code{-subdirs} is assumed.
|
||||
|
||||
@item -tmpdir=@var{tmpdir}
|
||||
Use the directory @var{tmpdir} for @code{configure}'s temporary files.
|
||||
The default is the value of the environment variable TMPDIR, or
|
||||
@ -336,14 +309,14 @@ often correct for native tools installed on only one host.
|
||||
|
||||
@menu
|
||||
* prefix:: Changing the default install directory
|
||||
* datadir:: How to separate host independent files
|
||||
* exec_prefix:: How to separate host independent files
|
||||
from host dependent files when
|
||||
installing for multiple hosts
|
||||
* Install Details:: Full descriptions of all installation
|
||||
subdirectories
|
||||
@end menu
|
||||
|
||||
@node prefix, datadir, Install Locations, Install Locations
|
||||
@node prefix, exec_prefix, Install Locations, Install Locations
|
||||
@subsection Changing the default install directory
|
||||
@cindex Changing the default install directory
|
||||
@cindex Prefix directory
|
||||
@ -364,17 +337,17 @@ To make this easier, the value of the @code{configure} variable
|
||||
using the option @code{-prefix=}.
|
||||
|
||||
|
||||
@node datadir, Install Details, prefix, Install Locations
|
||||
@node exec_prefix, Install Details, prefix, Install Locations
|
||||
@subsection Installing for multiple hosts
|
||||
@cindex Configuring for multiple hosts
|
||||
@cindex Sharing host independent files
|
||||
@cindex The @file{datadir} directory
|
||||
@cindex The @file{exec_prefix} directory
|
||||
@cindex Installing host independent files
|
||||
|
||||
By default, host independent files are installed in subdirectories of
|
||||
@file{@var{prefix}/lib}. The location is determined by the value of the
|
||||
@code{configure} variable @code{datadir}, which determines the value of
|
||||
the Makefile variable @code{datadir}. This makes it simpler to install
|
||||
By default, host dependent files are installed in subdirectories of
|
||||
@file{@var{exec_prefix}}. The location is determined by the value of the
|
||||
@code{configure} variable @code{exec_prefix}, which determines the value of
|
||||
the Makefile variable @code{exec_prefix}. This makes it simpler to install
|
||||
for a single host, and simplifies changing the default location for the
|
||||
install tree; but the default doesn't allow for multiple hosts to
|
||||
effectively share host independent files.
|
||||
@ -383,24 +356,21 @@ To configure so that multiple hosts can share common files, use
|
||||
something like:
|
||||
|
||||
@example
|
||||
configure @var{host1} -prefix=/usr/gnu/H-@var{host1} -datadir=/usr/gnu/H-independent
|
||||
configure @var{host1} -prefix=/usr/gnu -exec_prefix=/usr/gnu/H-host1
|
||||
make all info install install-info clean
|
||||
|
||||
configure @var{host2} -prefix=/usr/gnu/H-@var{host2} -datadir=/usr/gnu/H-independent
|
||||
configure @var{host2} -prefix=/usr/gnu -exec_prefix=/usr/gnu/H-host2
|
||||
make all info install install-info
|
||||
@end example
|
||||
|
||||
The first line configures the source for @var{host1} to place host
|
||||
specific programs in subdirectories of @file{/usr/gnu/H-@var{host1}},
|
||||
and host independent files in @file{/usr/gnu/H-independent}.
|
||||
specific programs in subdirectories of @file{/usr/gnu/H-@var{host1}}.
|
||||
|
||||
The second line builds and installs all programs for @var{host1},
|
||||
including both host independent and host specific files.
|
||||
|
||||
The third line reconfigures the source for @var{host2} to place host
|
||||
specific programs in subdirectories of @file{/usr/gnu/H-@var{host2}},
|
||||
and host independent files (once again) in
|
||||
@file{/usr/gnu/H-independent}.
|
||||
specific programs in subdirectories of @file{/usr/gnu/H-@var{host2}}.
|
||||
|
||||
The fourth line builds and installs all programs for @var{host2}. Host
|
||||
specific files are installed in new directories, but the host
|
||||
@ -408,17 +378,7 @@ independent files are installed @emph{on top of} the host
|
||||
independent files installed for @var{host1}. This results in a single
|
||||
copy of the host independent files, suitable for use by both hosts.
|
||||
|
||||
NOTE: support for @code{-subdirs} and multiple hosts is at least
|
||||
temporarily suspended. FIXME-soon
|
||||
@*
|
||||
Previously this was:
|
||||
|
||||
@example
|
||||
configure @var{host1} @var{host2} -prefix=/usr/gnu
|
||||
make all install
|
||||
@end example
|
||||
|
||||
@node Install Details, , datadir, Install Locations
|
||||
@node Install Details, , exec_prefix, Install Locations
|
||||
@subsection Full descriptions of all installation subdirectories
|
||||
|
||||
During any install, a number of standard directories are created. Their
|
||||
@ -462,12 +422,12 @@ The default value for @code{bindir} depends on @code{prefix};
|
||||
The default value for @code{bindir} is @file{$(prefix)/bin}.
|
||||
@end defvr
|
||||
|
||||
@vindex datadir
|
||||
@defvr {Makefile and configure} datadir
|
||||
A directory for host independent files. You can specify the Makefile
|
||||
default value by using the @code{-datadir=} option to @code{configure}.
|
||||
(See also @ref{Invoking}.) The default value for @code{datadir} is
|
||||
@file{$(prefix)/lib}.
|
||||
@vindex exec_prefix
|
||||
@defvr {Makefile and configure} exec_prefix
|
||||
A directory for host dependent files. You can specify the Makefile
|
||||
default value by using the @code{-exec_prefix=} option to @code{configure}.
|
||||
(See also @ref{Invoking}.) The default value for @code{exec_prefix} is
|
||||
@file{$(prefix)}.
|
||||
@end defvr
|
||||
|
||||
@vindex libdir
|
||||
@ -483,7 +443,7 @@ changed only indirectly through @code{prefix}. The default value for
|
||||
A directory for @code{man} format documentation (``man pages''). The
|
||||
default value for @code{mandir} depends on @code{prefix};
|
||||
@code{mandir} is normally changed only indirectly through @code{prefix}.
|
||||
The default value for @code{mandir} is @file{$(datadir)/man}.
|
||||
The default value for @code{mandir} is @file{$(prefix)/man}.
|
||||
@end defvr
|
||||
|
||||
@vindex man@var{N}dir
|
||||
@ -512,7 +472,7 @@ not clear. (See also @ref{Makefile Extensions}.)
|
||||
A directory for @emph{info} format documentation. The default value for
|
||||
@code{infodir} depends indirectly on @code{prefix}; @code{infodir} is
|
||||
normally changed only through @code{prefix}. The default value for
|
||||
@code{infodir} is @file{$(datadir)/info}.
|
||||
@code{infodir} is @file{$(prefix)/info}.
|
||||
@end defvr
|
||||
|
||||
@vindex docdir
|
||||
@ -570,70 +530,9 @@ where @var{builddir} is the directory where you wish to build,
|
||||
If you were to do this twice with different values for @var{builddir}
|
||||
and @var{host}, then you could @code{make} for both at the same time.
|
||||
|
||||
@quotation
|
||||
@emph{NOTE:} The rest of this section describes the @code{-subdirs} feature for
|
||||
which support is at least temporarily suspended. FIXME-soon.
|
||||
@end quotation
|
||||
|
||||
Another way to specify the build directory is with the @samp{-subdirs}
|
||||
option. For example:
|
||||
|
||||
@example
|
||||
configure @var{host} -subdirs
|
||||
@end example
|
||||
|
||||
Using this option, @code{configure} will create a subdirectory named
|
||||
@file{H-@var{host}} to act as the build directory for each source
|
||||
directory.
|
||||
|
||||
Since building for multiple hosts is so common, @code{configure}
|
||||
recognizes this situation as special. For example:
|
||||
|
||||
@example
|
||||
configure @var{host1} @var{host2}
|
||||
@end example
|
||||
|
||||
is precisely the same as:
|
||||
|
||||
@example
|
||||
configure @var{host1} -subdirs
|
||||
configure @var{host2} -subdirs
|
||||
@end example
|
||||
|
||||
That is, configuring for multiple hosts or multiple targets implies
|
||||
@samp{-subdirs}.
|
||||
|
||||
When configuring for cross tools (the converse of native tools: when the
|
||||
host is not the target), as in:
|
||||
|
||||
@example
|
||||
configure @var{host} +target=@var{targ} -subdirs
|
||||
@end example
|
||||
|
||||
@noindent
|
||||
the subdirectories are named @file{X-@var{host}-@var{targ}}. This is
|
||||
especially useful when configuring for multiple targets.
|
||||
|
||||
If you use both @samp{-subdirs} and @samp{-srcdir=}, a tree that
|
||||
parallels the source directory structure is created in the current
|
||||
directory, and the subdirectories are created in this directory
|
||||
tree rather than in the source directories.
|
||||
|
||||
@emph{NOTE:} previously, @samp{-subdirs} built two-level subdirectories
|
||||
as @file{./H-@var{host}/T-@var{target}}, created
|
||||
@file{./H-@var{host}/Makefile} for building across all targets,
|
||||
@file{./Makefile} for building across all hosts, and
|
||||
@file{./config.status} and @file{./H-@var{host}/config.status} for
|
||||
rebuilding these Makefiles.
|
||||
|
||||
@node Host, Target, Build Directories, Using Configure
|
||||
@section Host
|
||||
|
||||
@quotation
|
||||
@emph{NOTE:} support for multiple hosts is at least temporarily suspended.
|
||||
FIXME-soon.
|
||||
@end quotation
|
||||
|
||||
The arguments to @code{configure} are @emph{hosts}. By @emph{host} we
|
||||
mean the environment in which the source will be compiled. This need
|
||||
not necessarily be the same as the physical machine involved,
|
||||
@ -964,22 +863,15 @@ of @code{manext}?
|
||||
|
||||
@kindex datadir
|
||||
@item datadir
|
||||
is used for @emph{all} host independent files. This makes it possible
|
||||
to share host independent files across multiple hosts without resorting
|
||||
to symbolic links or to multiple mount points. This also makes it possible
|
||||
build an install tree that contains multiple host binaries, write
|
||||
the binaries to tape, and extract any of the hosts without extracting
|
||||
the others.
|
||||
is used for host independent data files.
|
||||
|
||||
@kindex mandir
|
||||
@item mandir
|
||||
The default path for @code{mandir} depends on @code{datadir}, since man
|
||||
pages are host independent.
|
||||
The default path for @code{mandir} depends on @code{prefix}.
|
||||
|
||||
@kindex infodir
|
||||
@item infodir
|
||||
The default path for @code{infodir} depends on @code{datadir}, since
|
||||
info files are host independent.
|
||||
The default path for @code{infodir} depends on @code{prefix}.
|
||||
|
||||
@kindex BISON
|
||||
@item BISON
|
||||
@ -1100,18 +992,6 @@ host and target configurations.
|
||||
@c this? (FIXME).
|
||||
@end defvar
|
||||
|
||||
@defvar{target_dependent}
|
||||
NOTE: support for multiple targets is currently suspended.
|
||||
@*
|
||||
If this variable is not empty and @code{-subdirs} is in effect then
|
||||
configure will create separate build directories for each target. This
|
||||
is usually set in the declarations section of @file{configure.in}. The
|
||||
default is to assume that a directory is target independent, and to create
|
||||
only one real directory with symlinks from the other names. This means that
|
||||
a target independent directory will be built exactly once regardless of
|
||||
how many targets are being built.
|
||||
@end defvar
|
||||
|
||||
@defvar{host}
|
||||
Contains the name that the user entered for the host. Since many things
|
||||
that the user could enter would map to the same output from
|
||||
@ -1203,12 +1083,10 @@ on all hosts, regardless of what is normally available on them.
|
||||
@end defvar
|
||||
|
||||
@defvar{srcdir}
|
||||
NOTE: support for @code{-subdirs} is at least temporarily suspended.
|
||||
@*
|
||||
Is set to the name of the directory containing the source for this
|
||||
program. This will be different from @file{.} if the user has specified
|
||||
either the @code{-srcdir=} or the @code{-subdirs} options. Note that
|
||||
@code{srcdir} is not necessarily an absolute path.
|
||||
the @code{-srcdir=} option. Note that @code{srcdir} is not necessarily
|
||||
an absolute path.
|
||||
@end defvar
|
||||
|
||||
@defvar{host_makefile_frag}
|
||||
@ -1272,10 +1150,7 @@ of @file{configure.in} up to a line beginning with @samp{# Per-host:}
|
||||
immediately after parsing command line arguments. The variables
|
||||
@code{srctrigger} and @code{srcname} @emph{must} be set here.
|
||||
|
||||
You might also want to set the variables @code{configdirs} or
|
||||
@code{target_dependent} here.
|
||||
@*
|
||||
FIXME-soon. target_dependent isn't useful without multiple targets.
|
||||
You might also want to set the variable @code{configdirs} here.
|
||||
|
||||
@node Per-host, Per-target, Declarations, configure.in
|
||||
@subsection For each host
|
||||
@ -1391,7 +1266,7 @@ They are used for target dependent compile time options.
|
||||
Site specific Makefile fragments conventionally reside in the
|
||||
@file{./config} directory with names of the form @file{ms-@var{site}}.
|
||||
They are used to override host and target independent compile time
|
||||
options. Note that you can also overridde these options on the
|
||||
options. Note that you can also override these options on the
|
||||
@code{make} invocation line.
|
||||
|
||||
@node Known Bugs, Variables Index, Reference, top
|
||||
|
||||
@ -28,10 +28,14 @@ srcdir = .
|
||||
|
||||
prefix = /usr/local
|
||||
|
||||
bindir = $(prefix)/bin
|
||||
program_prefix =
|
||||
exec_prefix = $(prefix)
|
||||
bindir = $(exec_prefix)/bin
|
||||
libdir = $(exec_prefix)/lib
|
||||
tooldir = $(libdir)
|
||||
|
||||
datadir = $(prefix)/lib
|
||||
libdir = $(prefix)/lib
|
||||
mandir = $(datadir)/man
|
||||
mandir = $(prefix)/man
|
||||
man1dir = $(mandir)/man1
|
||||
man2dir = $(mandir)/man2
|
||||
man3dir = $(mandir)/man3
|
||||
@ -41,7 +45,7 @@ man6dir = $(mandir)/man6
|
||||
man7dir = $(mandir)/man7
|
||||
man8dir = $(mandir)/man8
|
||||
man9dir = $(mandir)/man9
|
||||
infodir = $(datadir)/info
|
||||
infodir = $(prefix)/info
|
||||
includedir = $(prefix)/include
|
||||
docdir = $(datadir)/doc
|
||||
|
||||
@ -113,7 +117,6 @@ REAL_HEADERS = \
|
||||
$(srcdir)/struc-symbol.h \
|
||||
$(srcdir)/subsegs.h \
|
||||
$(srcdir)/symbols.h \
|
||||
$(srcdir)/syscalls.h \
|
||||
$(srcdir)/write.h
|
||||
|
||||
LINKED_HEADERS = \
|
||||
@ -205,6 +208,8 @@ as.new: $(OBJS) $(LIBDEPS)
|
||||
-mv -f as.new as.old
|
||||
$(CC) $(ALL_CFLAGS) $(LDFLAGS) -o as.new $(OBJS) $(LIBS) $(LOADLIBES)
|
||||
|
||||
check:
|
||||
|
||||
config.status:
|
||||
@echo You must configure gas. Look at the INSTALL file for details.
|
||||
@false
|
||||
@ -273,6 +278,7 @@ read.o : read.c as.h host.h targ-env.h obj-format.h \
|
||||
targ-cpu.h struc-symbol.h \
|
||||
write.h flonum.h bignum.h expr.h frags.h hash.h read.h symbols.h tc.h obj.h \
|
||||
|
||||
strerror.o : strerror.c
|
||||
strstr.o : strstr.c
|
||||
subsegs.o : subsegs.c as.h host.h targ-env.h obj-format.h \
|
||||
targ-cpu.h struc-symbol.h \
|
||||
@ -325,11 +331,10 @@ distclean: clean
|
||||
|
||||
# Copy the files into directories where they will be run.
|
||||
install:
|
||||
if [ "$(host_alias)" = "$(target_alias)" ] ; then \
|
||||
$(INSTALL_PROGRAM) as.new $(bindir)/as ; \
|
||||
else \
|
||||
$(INSTALL_PROGRAM) as.new $(bindir)/as-$(target_alias) ; \
|
||||
fi
|
||||
-rm -f $(bindir)/$(program_prefix)as
|
||||
$(INSTALL_PROGRAM) as.new $(bindir)/$(program_prefix)as
|
||||
-rm -f $(tooldir)/as
|
||||
ln $(bindir)/$(program_prefix)as $(tooldir)/as
|
||||
|
||||
# Create the installation directory.
|
||||
install-dir:
|
||||
@ -348,7 +353,7 @@ uninstall:
|
||||
# These exist for maintenance purposes.
|
||||
|
||||
tags TAGS: force
|
||||
etags $(REAL_SOURCES) $(REAL_HEADERS) $(srcdir)/README $(srcdir)/Makefile $(srcdir)/config/*.[hc]
|
||||
etags $(REAL_HEADERS) $(REAL_SOURCES) $(srcdir)/config/*.[hc] $(srcdir)/README $(srcdir)/Makefile.in
|
||||
|
||||
bootstrap: as.new force
|
||||
$(MAKE) stage1
|
||||
|
||||
13
gas/doc/ChangeLog
Normal file
13
gas/doc/ChangeLog
Normal file
@ -0,0 +1,13 @@
|
||||
Sat Mar 7 00:06:25 1992 K. Richard Pixley (rich@rtl.cygnus.com)
|
||||
|
||||
* Makefile.in: commented out line for building as-all.texinfo.
|
||||
This is temporary.
|
||||
|
||||
* as.texinfo, as-all.texinfo: added menu item hooks.
|
||||
|
||||
Wed Feb 26 18:04:40 1992 K. Richard Pixley (rich@cygnus.com)
|
||||
|
||||
* Makefile.in, configure.in: removed traces of namesubdir,
|
||||
-subdirs, $(subdir), $(unsubdir), some rcs triggers. Forced
|
||||
copyrights to '92, changed some from Cygnus to FSF.
|
||||
|
||||
@ -19,6 +19,9 @@
|
||||
# the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
|
||||
#
|
||||
|
||||
# This file was written, and is maintained by K. Richard Pixley
|
||||
# <rich@cygnus.com>.
|
||||
|
||||
# This file is a shell script that supplies the information necessary
|
||||
# to tailor a template configure script into the configure script
|
||||
# appropriate for this directory. For more information, check any
|
||||
|
||||
@ -1,3 +1,14 @@
|
||||
Sat Mar 7 18:44:50 1992 K. Richard Pixley (rich@rtl.cygnus.com)
|
||||
|
||||
* Makefile.in: commented out gdb-all.texinfo rule. This is
|
||||
temporary.
|
||||
|
||||
Wed Feb 26 18:04:40 1992 K. Richard Pixley (rich@cygnus.com)
|
||||
|
||||
* Makefile.in, configure.in: removed traces of namesubdir,
|
||||
-subdirs, $(subdir), $(unsubdir), some rcs triggers. Forced
|
||||
copyrights to '92, changed some from Cygnus to FSF.
|
||||
|
||||
Fri Dec 13 09:47:31 1991 John Gilmore (gnu at cygnus.com)
|
||||
|
||||
* gdb.texinfo: Improve how we ask for bug reports.
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
##Copyright (C) 1991 Free Software Foundation, Inc.
|
||||
##Copyright (C) 1991, 1992 Free Software Foundation, Inc.
|
||||
|
||||
# Makefile for GDB documentation.
|
||||
# This file is part of GDB.
|
||||
@ -21,10 +21,12 @@ srcdir = .
|
||||
|
||||
prefix = /usr/local
|
||||
|
||||
bindir = $(prefix)/bin
|
||||
exec_prefix = $(prefix)
|
||||
bindir = $(exec_prefix)/bin
|
||||
libdir = $(exec_prefix)/lib
|
||||
|
||||
datadir = $(prefix)/lib
|
||||
libdir = $(prefix)/lib
|
||||
mandir = $(datadir)/man
|
||||
mandir = $(prefix)/man
|
||||
man1dir = $(mandir)/man1
|
||||
man2dir = $(mandir)/man2
|
||||
man3dir = $(mandir)/man3
|
||||
@ -34,7 +36,7 @@ man6dir = $(mandir)/man6
|
||||
man7dir = $(mandir)/man7
|
||||
man8dir = $(mandir)/man8
|
||||
man9dir = $(mandir)/man9
|
||||
infodir = $(datadir)/info
|
||||
infodir = $(prefix)/info
|
||||
includedir = $(prefix)/include
|
||||
docdir = $(datadir)/doc
|
||||
|
||||
@ -173,16 +175,17 @@ gdbVN.m4 : $(srcdir)/${gdbdir}/Makefile.in
|
||||
# source directory for the benefit of people who *don't* use this makefile,
|
||||
# VPATH will often tell make not to bother building it, because the one
|
||||
# in the srcdir is up to date. (if not, then make should build one here).
|
||||
gdb-all.texi: ${SFILES_DOCDIR}
|
||||
if [ ! -f ./gdbVN.m4 ]; then \
|
||||
ln -s $(srcdir)/gdbVN.m4 . || \
|
||||
ln $(srcdir)/gdbVN.m4 . || \
|
||||
cp $(srcdir)/gdbVN.m4 . ; else true; fi
|
||||
rm -f foobus.texinfo
|
||||
${M4} $(srcdir)/pretex.m4 $(srcdir)/none.m4 $(srcdir)/all.m4 \
|
||||
gdbVN.m4 $(srcdir)/gdb.texinfo >foobus.texinfo
|
||||
rm -f gdb-all.texi
|
||||
mv foobus.texinfo ./gdb-all.texi
|
||||
|
||||
#gdb-all.texi: ${SFILES_DOCDIR}
|
||||
# if [ ! -f ./gdbVN.m4 ]; then \
|
||||
# ln -s $(srcdir)/gdbVN.m4 . || \
|
||||
# ln $(srcdir)/gdbVN.m4 . || \
|
||||
# cp $(srcdir)/gdbVN.m4 . ; else true; fi
|
||||
# rm -f foobus.texinfo
|
||||
# ${M4} $(srcdir)/pretex.m4 $(srcdir)/none.m4 $(srcdir)/all.m4 \
|
||||
# gdbVN.m4 $(srcdir)/gdb.texinfo >foobus.texinfo
|
||||
# rm -f gdb-all.texi
|
||||
# mv foobus.texinfo ./gdb-all.texi
|
||||
|
||||
# GDB MANUAL: TeX dvi file
|
||||
gdb.dvi : gdb-${CONFIG}.texi rluser.texinfo inc-hist.texi
|
||||
@ -197,7 +200,7 @@ gdb.dvi : gdb-${CONFIG}.texi rluser.texinfo inc-hist.texi
|
||||
# cope with all the markup. In the meantime, we distribute the info
|
||||
# files
|
||||
gdb.info: gdb-${CONFIG}.texi
|
||||
$(MAKEINFO) -o ./gdb.info gdb-${CONFIG}.texi
|
||||
$(MAKEINFO) -o ./gdb.info $(srcdir)/gdb-${CONFIG}.texi
|
||||
|
||||
# GDB MANUAL: roff translations
|
||||
# Try to use a recent texi2roff. v2 was put on prep in jan91.
|
||||
|
||||
@ -1,3 +1,17 @@
|
||||
Sat Mar 7 00:15:36 1992 K. Richard Pixley (rich@rtl.cygnus.com)
|
||||
|
||||
* Makefile.in: remove FIXME's on info and install-info targets.
|
||||
|
||||
Fri Mar 6 22:02:04 1992 K. Richard Pixley (rich@cygnus.com)
|
||||
|
||||
* Makefile.in: added check target.
|
||||
|
||||
Wed Feb 26 18:04:40 1992 K. Richard Pixley (rich@cygnus.com)
|
||||
|
||||
* Makefile.in, configure.in: removed traces of namesubdir,
|
||||
-subdirs, $(subdir), $(unsubdir), some rcs triggers. Forced
|
||||
copyrights to '92, changed some from Cygnus to FSF.
|
||||
|
||||
Fri Feb 21 14:37:32 1992 Steve Chamberlain (sac at rtl.cygnus.com)
|
||||
|
||||
* readline.c, examples/fileman.c: patches from DJ to support DOS
|
||||
|
||||
Loading…
Reference in New Issue
Block a user