source: chapter08/autoconf.xml@ ba011a9

11.0 11.0-rc1 11.0-rc2 11.0-rc3 ml-11.0 multilib trunk xry111/git-transition xry111/glibc-2.34 xry111/tester-nohack xry111/usr-move
Last change on this file since ba011a9 was ba011a9, checked in by Xi Ruoyao <xry111@…>, 11 months ago

autoconf: restore TESTSUITEFLAGS

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@12159 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 7.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-autoconf" role="wrap">
9 <?dbhtml filename="autoconf.html"?>
10
11 <sect1info condition="script">
12 <productname>autoconf</productname>
13 <productnumber>&autoconf-version;</productnumber>
14 <address>&autoconf-url;</address>
15 </sect1info>
16
17 <title>Autoconf-&autoconf-version;</title>
18
19 <indexterm zone="ch-system-autoconf">
20 <primary sortas="a-Autoconf">Autoconf</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Autoconf package contains programs for producing shell scripts that
27 can automatically configure source code.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&autoconf-fin-sbu;</seg>
35 <seg>&autoconf-fin-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of Autoconf</title>
43<!--
44 <para>First, apply a patch fixes several problems that occur with the latest
45 perl, libtool, and bash versions.</para>
46
47<screen><userinput remap="pre">patch -Np1 -i ../&autoconf-fixes-patch;</userinput></screen>
48-->
49 <para>Prepare Autoconf for compilation:</para>
50
51<screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
52
53 <para>Compile the package:</para>
54
55<screen><userinput remap="make">make</userinput></screen>
56
57 <para>To test the results, issue:</para>
58<!--
59 <para>The test suite is currently broken by bash-5 and libtool-2.4.3.
60 To run the tests anyway, issue:</para>
61 -->
62<screen><userinput remap="test">make check</userinput></screen>
63<!--
64 <para>This takes a long time, about &autoconf-fin-sbu-tests; SBUs. In addition,
65 several tests are skipped that use Automake. For full test coverage,
66 Autoconf can be re-tested after Automake has been installed. In addition,
67 two tests fail due to changes in libtool-2.4.3 and later.</para>
68-->
69 <note><para>The test time for autoconf can be reduced significantly on a
70 system with multiple cores. To do this, append
71 <command>TESTSUITEFLAGS=-j&lt;N&gt;</command> to the line above. For
72 instance, using -j4 can reduce the test time by over 60
73 percent.</para></note>
74
75 <para>Install the package:</para>
76
77<screen><userinput remap="install">make install</userinput></screen>
78
79 </sect2>
80
81 <sect2 id="contents-autoconf" role="content">
82 <title>Contents of Autoconf</title>
83
84 <segmentedlist>
85 <segtitle>Installed programs</segtitle>
86 <segtitle>Installed directory</segtitle>
87
88 <seglistitem>
89 <seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
90 and ifnames</seg>
91 <seg>/usr/share/autoconf</seg>
92 </seglistitem>
93 </segmentedlist>
94
95 <variablelist>
96 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
97 <?dbfo list-presentation="list"?>
98 <?dbhtml list-presentation="table"?>
99
100 <varlistentry id="autoconf">
101 <term><command>autoconf</command></term>
102 <listitem>
103 <para>Produces shell scripts that automatically configure software
104 source code packages to adapt to many kinds of Unix-like systems;
105 the configuration scripts it produces are independent&mdash;running
106 them does not require the <command>autoconf</command> program</para>
107 <indexterm zone="ch-system-autoconf autoconf">
108 <primary sortas="b-autoconf">autoconf</primary>
109 </indexterm>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry id="autoheader">
114 <term><command>autoheader</command> </term>
115 <listitem>
116 <para>A tool for creating template files of C
117 <emphasis>#define</emphasis> statements for configure to use</para>
118 <indexterm zone="ch-system-autoconf autoheader">
119 <primary sortas="b-autoheader">autoheader</primary>
120 </indexterm>
121 </listitem>
122 </varlistentry>
123
124 <varlistentry id="autom4te">
125 <term><command>autom4te</command></term>
126 <listitem>
127 <para>A wrapper for the M4 macro processor</para>
128 <indexterm zone="ch-system-autoconf autom4te">
129 <primary sortas="b-autom4te">autom4te</primary>
130 </indexterm>
131 </listitem>
132 </varlistentry>
133
134 <varlistentry id="autoreconf">
135 <term><command>autoreconf</command></term>
136 <listitem>
137 <para>Automatically runs <command>autoconf</command>,
138 <command>autoheader</command>, <command>aclocal</command>,
139 <command>automake</command>, <command>gettextize</command>, and
140 <command>libtoolize</command> in the correct order to save time
141 when changes are made to <command>autoconf</command> and
142 <command>automake</command> template files</para>
143 <indexterm zone="ch-system-autoconf autoreconf">
144 <primary sortas="b-autoreconf">autoreconf</primary>
145 </indexterm>
146 </listitem>
147 </varlistentry>
148
149 <varlistentry id="autoscan">
150 <term><command>autoscan</command> </term>
151 <listitem>
152 <para>Helps to create a <filename>configure.in</filename> file for a
153 software package; it examines the source files in a directory tree,
154 searching them for common portability issues, and creates a
155 <filename>configure.scan</filename> file that serves as as a
156 preliminary <filename>configure.in</filename> file for the
157 package</para>
158 <indexterm zone="ch-system-autoconf autoscan">
159 <primary sortas="b-autoscan">autoscan</primary>
160 </indexterm>
161 </listitem>
162 </varlistentry>
163
164 <varlistentry id="autoupdate">
165 <term><command>autoupdate</command></term>
166 <listitem>
167 <para>Modifies a <filename>configure.in</filename> file that still
168 calls <command>autoconf</command> macros by their old names to use the
169 current macro names</para>
170 <indexterm zone="ch-system-autoconf autoupdate">
171 <primary sortas="b-autoupdate">autoupdate</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="ifnames">
177 <term><command>ifnames</command> </term>
178 <listitem>
179 <para>Helps when writing <filename>configure.in</filename> files
180 for a software package; it prints the identifiers that the package
181 uses in C preprocessor conditionals [If a package has already been set
182 up to have some portability, this program can help determine what
183 <command>configure</command> needs to check for. It can also fill in
184 gaps in a <filename>configure.in</filename> file generated by
185 <command>autoscan</command>.]</para>
186 <indexterm zone="ch-system-autoconf ifnames">
187 <primary sortas="b-ifnames">ifnames</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 </variablelist>
193
194 </sect2>
195
196</sect1>
Note: See TracBrowser for help on using the repository browser.