summaryrefslogtreecommitdiffstats
path: root/meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch
diff options
context:
space:
mode:
Diffstat (limited to 'meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch')
-rw-r--r--meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch270
1 files changed, 0 insertions, 270 deletions
diff --git a/meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch b/meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch
deleted file mode 100644
index 8d2539611d..0000000000
--- a/meta/recipes-devtools/autoconf/autoconf/backports/0026-Modernize-INSTALL.patch
+++ /dev/null
@@ -1,270 +0,0 @@
1From a7421b411b4359b97528c8f4e9dd8abe82235813 Mon Sep 17 00:00:00 2001
2From: Paul Eggert <eggert@cs.ucla.edu>
3Date: Tue, 20 Jun 2023 13:23:19 -0700
4Subject: [PATCH 26/29] Modernize INSTALL
5
6Problem reported for gettext bootstrap by Julien Palard in:
7https://savannah.gnu.org/bugs/?62196
8* doc/install.texi: Give a brief info as to how to bootstrap,
9on packages built from Git rather from a distribution tarball.
10Remove aging details about c99, macOS, X, HP-UX, OSF/1, Solaris,
11Haiku, sun4. Improve documentation for enable/disable and
12with/without options.
13
14Upstream-Status: Backport
15Signed-off-by: Khem Raj <raj.khem@gmail.com>
16---
17 doc/install.texi | 157 +++++++++++++++++++++--------------------------
18 1 file changed, 70 insertions(+), 87 deletions(-)
19
20diff --git a/doc/install.texi b/doc/install.texi
21index e06689613..cec245fd0 100644
22--- a/doc/install.texi
23+++ b/doc/install.texi
24@@ -18,9 +18,21 @@ warranty of any kind.
25 @node Basic Installation
26 @section Basic Installation
27
28-Briefly, the shell command
29-@samp{./configure@tie{}&& make@tie{}&& make@tie{}install}
30-should configure, build, and install this package. The following
31+Briefly, the following shell commands:
32+
33+@example
34+test -f configure || ./bootstrap
35+./configure
36+make
37+make install
38+@end example
39+
40+@noindent
41+should configure, build, and install this package.
42+The @command{./bootstrap} line is intended for developers;
43+you can omit it when building from a distribution tarball.
44+
45+The following
46 more-detailed instructions are generic; see the @file{README} file for
47 instructions specific to this package.
48 @ifclear autoconf
49@@ -32,6 +44,17 @@ More recommendations for GNU packages can be found in
50 @ref{Makefile Conventions, , Makefile Conventions, standards,
51 GNU Coding Standards}.
52
53+If the @command{bootstrap} shell script exists, it attempts to build the
54+@command{configure} shell script and related files, perhaps by
55+downloading other software components from the network, and by using
56+developer tools that are less commonly installed. Because the output of
57+@command{bootstrap} is system-independent, it is normally run by a
58+package developer so that its output can be put into the distribution
59+tarball and ordinary builders and users need not run @command{bootstrap}.
60+Some packages have commands like @command{./autopull.sh} and
61+@command {./autogen.sh} that you can run instead of @command{./bootstrap},
62+for more fine-grained control over bootstrapping.
63+
64 The @command{configure} shell script attempts to guess correct values
65 for various system-dependent variables used during compilation. It uses
66 those values to create a @file{Makefile} in each directory of the
67@@ -63,8 +86,15 @@ The simplest way to compile this package is:
68
69 @enumerate
70 @item
71-@command{cd} to the directory containing the package's source code and type
72-@samp{./configure} to configure the package for your system.
73+@command{cd} to the directory containing the package's source code.
74+
75+@item
76+If this is a developer checkout and file @samp{configure} does not yet exist,
77+type @samp{./bootstrap} to create it.
78+You may need special developer tools and network access to bootstrap.
79+
80+@item
81+Type @samp{./configure} to configure the package for your system.
82
83 Running @command{configure} might take a while. While running, it prints some
84 messages telling which features it is checking for.
85@@ -124,7 +154,7 @@ parameters by setting variables in the command line or in the environment.
86 Here is an example:
87
88 @example
89-./configure CC=c99 CFLAGS=-g LIBS=-lposix
90+./configure CC=gcc CFLAGS=-g LIBS=-lposix
91 @end example
92
93 @xref{Defining Variables}, for more details.
94@@ -148,21 +178,10 @@ architecture at a time in the source code directory. After you have
95 installed the package for one architecture, use @samp{make distclean}
96 before reconfiguring for another architecture.
97
98-On MacOS X 10.5 and later systems, you can create libraries and
99-executables that work on multiple system types---known as @dfn{fat} or
100-@dfn{universal} binaries---by specifying multiple @option{-arch} options
101-to the compiler but only a single @option{-arch} option to the
102-preprocessor. Like this:
103-
104-@example
105-./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
106- CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
107- CPP="gcc -E" CXXCPP="g++ -E"
108-@end example
109-
110-This is not guaranteed to produce working output in all cases, you may
111-have to build one architecture at a time and combine the results
112-using the @command{lipo} tool if you have problems.
113+Some platforms, notably macOS, support ``fat'' or ``universal'' binaries,
114+where a single binary can execute on different architectures.
115+On these platforms you can configure and compile just once,
116+with options specific to that platform.
117
118 @node Installation Names
119 @section Installation Names
120@@ -227,20 +246,16 @@ an extra prefix or suffix on their names by giving @command{configure}
121 the option @option{--program-prefix=@var{PREFIX}} or
122 @option{--program-suffix=@var{SUFFIX}}.
123
124-Some packages pay attention to @option{--enable-@var{feature}} options
125+Some packages pay attention to @option{--enable-@var{feature}}
126+and @option{--disable-@var{feature}} options
127 to @command{configure}, where @var{feature} indicates an optional part
128 of the package. They may also pay attention to
129-@option{--with-@var{package}} options, where @var{package} is something
130-like @samp{gnu-as} or @samp{x} (for the X Window System). The
131-@file{README} should mention any @option{--enable-} and @option{--with-}
132+@option{--with-@var{package}} and @option{--without-@var{package}} options,
133+where @var{package} is something like @samp{gnu-ld}.
134+@samp{./configure --help} should mention the
135+@option{--enable-...} and @option{--with-...}
136 options that the package recognizes.
137
138-For packages that use the X Window System, @command{configure} can
139-usually find the X include and library files automatically, but if it
140-doesn't, you can use the @command{configure} options
141-@option{--x-includes=@var{dir}} and @option{--x-libraries=@var{dir}} to
142-specify their locations.
143-
144 Some packages offer the ability to configure how verbose the execution
145 of @command{make} will be. For these packages, running
146 @samp{./configure --enable-silent-rules} sets the default to minimal
147@@ -248,53 +263,6 @@ output, which can be overridden with @code{make V=1}; while running
148 @samp{./configure --disable-silent-rules} sets the default to verbose,
149 which can be overridden with @code{make V=0}.
150
151-@node Particular Systems
152-@section Particular systems
153-
154-On HP-UX, the default C compiler is not ANSI C compatible. If GNU CC is
155-not installed, it is recommended to use the following options in order to
156-use an ANSI C compiler:
157-
158-@example
159-./configure CC="cc -Ae -D_XOPEN_SOURCE=500"
160-@end example
161-
162-@noindent
163-and if that doesn't work, install pre-built binaries of GCC for HP-UX.
164-
165-HP-UX @command{make} updates targets which have the same timestamps as
166-their prerequisites, which makes it generally unusable when shipped
167-generated files such as @command{configure} are involved. Use GNU
168-@command{make} instead.
169-
170-On OSF/1 a.k.a.@: Tru64, some versions of the default C compiler cannot
171-parse its @code{<wchar.h>} header file. The option @option{-nodtk} can be
172-used as a workaround. If GNU CC is not installed, it is therefore
173-recommended to try
174-
175-@example
176-./configure CC="cc"
177-@end example
178-
179-@noindent
180-and if that doesn't work, try
181-
182-@example
183-./configure CC="cc -nodtk"
184-@end example
185-
186-On Solaris, don't put @code{/usr/ucb} early in your @env{PATH}. This
187-directory contains several dysfunctional programs; working variants
188-of these programs are available in @code{/usr/bin}. So, if you need
189-@code{/usr/ucb} in your @env{PATH}, put it @emph{after} @code{/usr/bin}.
190-
191-On Haiku, software installed for all users goes in @file{/boot/common},
192-not @file{/usr/local}. It is recommended to use the following options:
193-
194-@example
195-./configure --prefix=/boot/common
196-@end example
197-
198 @node System Type
199 @section Specifying the System Type
200
201@@ -304,7 +272,8 @@ will run on. Usually, assuming the package is built to be run on the
202 @emph{same} architectures, @command{configure} can figure that out, but
203 if it prints a message saying it cannot guess the machine type, give it
204 the @option{--build=@var{type}} option. @var{type} can either be a
205-short name for the system type, such as @samp{sun4}, or a canonical name
206+short name like @samp{mingw64} for the system type, or a canonical name
207+like @samp{x86_64-pc-linux-gnu}
208 which has the form:
209
210 @example
211@@ -319,6 +288,7 @@ where @var{system} can have one of these forms:
212 @var{kernel}-@var{os}
213 @end example
214
215+@noindent
216 See the file @file{config.sub} for the possible values of each field.
217 If @file{config.sub} isn't included in this package, then this package
218 doesn't need to know the machine type.
219@@ -405,13 +375,6 @@ traditionally @file{config.cache}. @var{file} defaults to
220 @itemx -C
221 Alias for @option{--cache-file=config.cache}.
222
223-@item --quiet
224-@itemx --silent
225-@itemx -q
226-Do not print messages saying which checks are being made. To suppress
227-all normal output, redirect it to @file{/dev/null} (any error messages
228-will still be shown).
229-
230 @item --srcdir=@var{dir}
231 Look for the package's source code in directory @var{dir}. Usually
232 @command{configure} can determine that directory automatically.
233@@ -421,13 +384,33 @@ Use @var{dir} as the installation prefix. @ref{Installation Names}
234 for more details, including other options available for fine-tuning
235 the installation locations.
236
237+@item --build=@var{type}
238+Build for architecture @var{type}. @ref{Specifying the System Type}
239+for more details, including other system type options.
240+
241+@item --enable-@var{feature}
242+@itemx --disable-@var{feature}
243+Enable or disable the optional @var{feature}. @xref{Optional Features}.
244+
245+@item --with-@var{package}
246+@itemx --without-@var{package}
247+Use or omit @var{package} when building. @xref{Optional Features}.
248+
249+@item --quiet
250+@itemx --silent
251+@itemx -q
252+Do not print messages saying which checks are being made. To suppress
253+all normal output, redirect it to @file{/dev/null} (any error messages
254+will still be shown).
255+
256 @item --no-create
257 @itemx -n
258 Run the configure checks, but stop before creating any output files.
259 @end table
260
261 @noindent
262-@command{configure} also accepts some other, not widely useful, options.
263+@command{configure} also recognizes several environment variables,
264+and accepts some other, less widely useful, options.
265 Run @samp{configure --help} for more details.
266
267 @c Local Variables:
268--
2692.41.0
270