source: BOOK/final-system/common/autoconf.xml @ 3f8be484

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 3f8be484 was 3f8be484, checked in by Jim Gifford <clfs@…>, 18 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 6.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6  %general-entities;
7  %patches-entities;
8]>
9
10<sect1 id="ch-system-autoconf" role="wrap">
11  <?dbhtml filename="autoconf.html"?>
12
13  <title>Autoconf-&autoconf-version;</title>
14
15  <indexterm zone="ch-system-autoconf">
16    <primary sortas="a-Autoconf">Autoconf</primary>
17  </indexterm>
18
19  <sect2 role="package">
20    <title/>
21
22    <para>The Autoconf package contains programs for producing shell scripts that
23    can automatically configure source code.</para>
24
25    <segmentedlist>
26      <segtitle>&buildtime;</segtitle>
27      <segtitle>&diskspace;</segtitle>
28
29      <seglistitem>
30        <seg>Not checked yet</seg>
31        <seg>Not checked yet</seg>
32      </seglistitem>
33    </segmentedlist>
34
35    <segmentedlist>
36      <segtitle>&dependencies;</segtitle>
37
38      <seglistitem>
39        <seg>Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, and Sed</seg>
40      </seglistitem>
41    </segmentedlist>
42
43  </sect2>
44
45  <sect2 role="installation">
46    <title>Installation of Autoconf</title>
47
48    <para os="a">Prepare Autoconf for compilation:</para>
49
50<screen><userinput>./configure --prefix=/usr</userinput></screen>
51
52    <para os="b">Compile the package:</para>
53
54<screen os="c"><userinput>make</userinput></screen>
55
56    <para os="d">To test the results, issue: <userinput>make check</userinput>.
57    This takes a long time, about 2 SBUs.</para>
58
59    <para os="e">Install the package:</para>
60
61<screen os="f"><userinput>make install</userinput></screen>
62
63  </sect2>
64
65  <sect2 id="contents-autoconf" role="content">
66    <title>Contents of Autoconf</title>
67
68    <segmentedlist>
69      <segtitle>Installed programs</segtitle>
70
71      <seglistitem>
72        <seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
73        and ifnames</seg>
74      </seglistitem>
75    </segmentedlist>
76
77    <variablelist>
78      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
79      <?dbfo list-presentation="list"?>
80      <?dbhtml list-presentation="table"?>
81
82      <varlistentry id="autoconf">
83        <term><command>autoconf</command></term>
84        <listitem>
85          <para>Produces shell scripts that automatically configure software
86          source code packages to adapt to many kinds of Unix-like systems.
87          The configuration scripts it produces are independent&mdash;running
88          them does not require the <command>autoconf</command> program.</para>
89          <indexterm zone="ch-system-autoconf autoconf">
90            <primary sortas="b-autoconf">autoconf</primary>
91          </indexterm>
92        </listitem>
93      </varlistentry>
94
95      <varlistentry id="autoheader">
96        <term><command>autoheader</command> </term>
97        <listitem>
98          <para>A tool for creating template files of C
99          <emphasis>#define</emphasis> statements for configure to use</para>
100          <indexterm zone="ch-system-autoconf autoheader">
101            <primary sortas="b-autoheader">autoheader</primary>
102          </indexterm>
103        </listitem>
104      </varlistentry>
105
106      <varlistentry id="autom4te">
107        <term><command>autom4te</command></term>
108        <listitem>
109          <para>A wrapper for the M4 macro processor</para>
110          <indexterm zone="ch-system-autoconf autom4te">
111            <primary sortas="b-autom4te">autom4te</primary>
112          </indexterm>
113        </listitem>
114      </varlistentry>
115
116      <varlistentry id="autoreconf">
117        <term><command>autoreconf</command></term>
118        <listitem>
119          <para>Automatically runs <command>autoconf</command>,
120          <command>autoheader</command>, <command>aclocal</command>,
121          <command>automake</command>, <command>gettextize</command>, and
122          <command>libtoolize</command> in the correct order to save time
123          when changes are made to <command>autoconf</command> and
124          <command>automake</command> template files</para>
125          <indexterm zone="ch-system-autoconf autoreconf">
126            <primary sortas="b-autoreconf">autoreconf</primary>
127          </indexterm>
128        </listitem>
129      </varlistentry>
130
131      <varlistentry id="autoscan">
132        <term><command>autoscan</command> </term>
133        <listitem>
134          <para>Helps to create a <filename>configure.in</filename> file for a
135          software package; it examines the source files in a directory tree,
136          searching them for common portability issues, and creates a
137          <filename>configure.scan</filename> file that serves as as a
138          preliminary <filename>configure.in</filename> file for the package</para>
139          <indexterm zone="ch-system-autoconf autoscan">
140            <primary sortas="b-autoscan">autoscan</primary>
141          </indexterm>
142        </listitem>
143      </varlistentry>
144
145      <varlistentry id="autoupdate">
146        <term><command>autoupdate</command></term>
147        <listitem>
148          <para>Modifies a <filename>configure.in</filename> file that still
149          calls <command>autoconf</command> macros by their old names to use the
150          current macro names</para>
151          <indexterm zone="ch-system-autoconf autoupdate">
152            <primary sortas="b-autoupdate">autoupdate</primary>
153          </indexterm>
154        </listitem>
155      </varlistentry>
156
157      <varlistentry id="ifnames">
158        <term><command>ifnames</command> </term>
159        <listitem>
160          <para>Helps when writing <filename>configure.in</filename> files
161          for a software package; it prints the identifiers that the package
162          uses in C preprocessor conditionals. If a package has already been set
163          up to have some portability, this program can help determine what
164          <command>configure</command> needs to check for. It can also fill in
165          gaps in a <filename>configure.in</filename> file generated by
166          <command>autoscan</command></para>
167          <indexterm zone="ch-system-autoconf ifnames">
168            <primary sortas="b-ifnames">ifnames</primary>
169          </indexterm>
170        </listitem>
171      </varlistentry>
172
173    </variablelist>
174
175  </sect2>
176
177</sect1>
Note: See TracBrowser for help on using the repository browser.