diff options
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.patch | 270 |
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 @@ | |||
1 | From a7421b411b4359b97528c8f4e9dd8abe82235813 Mon Sep 17 00:00:00 2001 | ||
2 | From: Paul Eggert <eggert@cs.ucla.edu> | ||
3 | Date: Tue, 20 Jun 2023 13:23:19 -0700 | ||
4 | Subject: [PATCH 26/29] Modernize INSTALL | ||
5 | |||
6 | Problem reported for gettext bootstrap by Julien Palard in: | ||
7 | https://savannah.gnu.org/bugs/?62196 | ||
8 | * doc/install.texi: Give a brief info as to how to bootstrap, | ||
9 | on packages built from Git rather from a distribution tarball. | ||
10 | Remove aging details about c99, macOS, X, HP-UX, OSF/1, Solaris, | ||
11 | Haiku, sun4. Improve documentation for enable/disable and | ||
12 | with/without options. | ||
13 | |||
14 | Upstream-Status: Backport | ||
15 | Signed-off-by: Khem Raj <raj.khem@gmail.com> | ||
16 | --- | ||
17 | doc/install.texi | 157 +++++++++++++++++++++-------------------------- | ||
18 | 1 file changed, 70 insertions(+), 87 deletions(-) | ||
19 | |||
20 | diff --git a/doc/install.texi b/doc/install.texi | ||
21 | index 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 | -- | ||
269 | 2.41.0 | ||
270 | |||