source: BOOK/final-system/common/autoconf.xml@ 996bfb86

clfs-3.0.0-systemd systemd
Last change on this file since 996bfb86 was 686839b, checked in by William Harrington <kb0iic@…>, 11 years ago

Add screen tags around userinput test commands and remap userinput for test commands as remap="test".

  • Property mode set to 100644
File size: 5.9 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 <title>Autoconf-&autoconf-version;</title>
12
13 <indexterm zone="ch-system-autoconf">
14 <primary sortas="a-Autoconf">Autoconf</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Autoconf package contains programs for producing shell scripts that
21 can automatically configure source code.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Autoconf</title>
27
28 <para os="a">Prepare Autoconf for compilation:</para>
29
30<screen os="b"><userinput>./configure --prefix=/usr</userinput></screen>
31
32 <para os="c">Compile the package:</para>
33
34<screen os="d"><userinput>make</userinput></screen>
35
36 <para os="e">To test the results, issue:</para>
37
38<screen os="e2"><userinput remap="test">make check VERBOSE=yes</userinput></screen>
39
40 <para os="e3">17 tests are skipped that use Automake and different GCC languages.
41 For full test coverage, Autoconf can be re-tested after Automake has been
42 installed.</para>
43
44 <para os="f">Install the package:</para>
45
46<screen os="g"><userinput>make install</userinput></screen>
47
48 </sect2>
49
50 <sect2 id="contents-autoconf" role="content">
51 <title>Contents of Autoconf</title>
52
53 <segmentedlist>
54 <segtitle>Installed programs</segtitle>
55 <segtitle>Installed directory</segtitle>
56
57 <seglistitem>
58 <seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
59 and ifnames</seg>
60 <seg>/usr/share/autoconf</seg>
61 </seglistitem>
62 </segmentedlist>
63
64 <variablelist>
65 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
66 <?dbfo list-presentation="list"?>
67 <?dbhtml list-presentation="table"?>
68
69 <varlistentry id="autoconf">
70 <term><command>autoconf</command></term>
71 <listitem>
72 <para>Produces shell scripts that automatically configure software
73 source code packages to adapt to many kinds of Unix-like systems.
74 The configuration scripts it produces are independent&mdash;running
75 them does not require the <command>autoconf</command> program.</para>
76 <indexterm zone="ch-system-autoconf autoconf">
77 <primary sortas="b-autoconf">autoconf</primary>
78 </indexterm>
79 </listitem>
80 </varlistentry>
81
82 <varlistentry id="autoheader">
83 <term><command>autoheader</command> </term>
84 <listitem>
85 <para>A tool for creating template files of C
86 <emphasis>#define</emphasis> statements for configure to use</para>
87 <indexterm zone="ch-system-autoconf autoheader">
88 <primary sortas="b-autoheader">autoheader</primary>
89 </indexterm>
90 </listitem>
91 </varlistentry>
92
93 <varlistentry id="autom4te">
94 <term><command>autom4te</command></term>
95 <listitem>
96 <para>A wrapper for the M4 macro processor</para>
97 <indexterm zone="ch-system-autoconf autom4te">
98 <primary sortas="b-autom4te">autom4te</primary>
99 </indexterm>
100 </listitem>
101 </varlistentry>
102
103 <varlistentry id="autoreconf">
104 <term><command>autoreconf</command></term>
105 <listitem>
106 <para>Automatically runs <command>autoconf</command>,
107 <command>autoheader</command>, <command>aclocal</command>,
108 <command>automake</command>, <command>gettextize</command>, and
109 <command>libtoolize</command> in the correct order to save time
110 when changes are made to <command>autoconf</command> and
111 <command>automake</command> template files</para>
112 <indexterm zone="ch-system-autoconf autoreconf">
113 <primary sortas="b-autoreconf">autoreconf</primary>
114 </indexterm>
115 </listitem>
116 </varlistentry>
117
118 <varlistentry id="autoscan">
119 <term><command>autoscan</command> </term>
120 <listitem>
121 <para>Helps to create a <filename>configure.in</filename> file for a
122 software package; it examines the source files in a directory tree,
123 searching them for common portability issues, and creates a
124 <filename>configure.scan</filename> file that serves as as a
125 preliminary <filename>configure.in</filename> file for the package</para>
126 <indexterm zone="ch-system-autoconf autoscan">
127 <primary sortas="b-autoscan">autoscan</primary>
128 </indexterm>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry id="autoupdate">
133 <term><command>autoupdate</command></term>
134 <listitem>
135 <para>Modifies a <filename>configure.in</filename> file that still
136 calls <command>autoconf</command> macros by their old names to use the
137 current macro names</para>
138 <indexterm zone="ch-system-autoconf autoupdate">
139 <primary sortas="b-autoupdate">autoupdate</primary>
140 </indexterm>
141 </listitem>
142 </varlistentry>
143
144 <varlistentry id="ifnames">
145 <term><command>ifnames</command> </term>
146 <listitem>
147 <para>Helps when writing <filename>configure.in</filename> files
148 for a software package; it prints the identifiers that the package
149 uses in C preprocessor conditionals. If a package has already been set
150 up to have some portability, this program can help determine what
151 <command>configure</command> needs to check for. It can also fill in
152 gaps in a <filename>configure.in</filename> file generated by
153 <command>autoscan</command></para>
154 <indexterm zone="ch-system-autoconf ifnames">
155 <primary sortas="b-ifnames">ifnames</primary>
156 </indexterm>
157 </listitem>
158 </varlistentry>
159
160 </variablelist>
161
162 </sect2>
163
164</sect1>
Note: See TracBrowser for help on using the repository browser.