aboutsummaryrefslogtreecommitdiffstats
path: root/chapter08/automake.xml
blob: f89f71ced5204f91faaf976d54b8f4271e6e826d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-automake" role="wrap">
  <?dbhtml filename="automake.html"?>

  <sect1info condition="script">
    <productname>automake</productname>
    <productnumber>&automake-version;</productnumber>
    <address>&automake-url;</address>
  </sect1info>

  <title>Automake-&automake-version;</title>

  <indexterm zone="ch-system-automake">
    <primary sortas="a-Automake">Automake</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Automake package contains programs for generating Makefiles for use
    with Autoconf.</para>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&automake-fin-sbu;</seg>
        <seg>&automake-fin-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Automake</title>

    <para>Fix a failing test:</para>

<screen><userinput remap="pre">sed -i "s/''/etags/" t/tags-lisp-space.sh</userinput></screen>

    <para>Prepare Automake for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/usr --docdir=/usr/share/doc/automake-&automake-version;</userinput></screen>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para> Using the -j4 make option speeds up the tests, even on systems with
    only one processor, due to internal delays in individual tests.  To test
    the results, issue:</para>

<screen><userinput remap="test">make -j4 check</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

  </sect2>


  <sect2 id="contents-automake" role="content">
    <title>Contents of Automake</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>
      <segtitle>Installed directories</segtitle>

      <seglistitem>
        <seg>aclocal, aclocal-&am-minor-version; (hard linked with aclocal), automake, and
        automake-&am-minor-version; (hard linked with automake) </seg>
        <seg>/usr/share/aclocal-&am-minor-version;, /usr/share/automake-&am-minor-version;, and
        /usr/share/doc/automake-&automake-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="aclocal">
        <term><command>aclocal</command></term>
        <listitem>
          <para>Generates <filename>aclocal.m4</filename> files based on the
          contents of <filename>configure.in</filename> files</para>
          <indexterm zone="ch-system-automake aclocal">
            <primary sortas="b-aclocal">aclocal</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="aclocalversion">
        <term><command>aclocal-&am-minor-version;</command></term>
        <listitem>
          <para>A hard link to <command>aclocal</command></para>
          <indexterm zone="ch-system-automake aclocalversion">
            <primary sortas="b-aclocal-&am-minor-version;">aclocal-&am-minor-version;</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="automake">
        <term><command>automake</command></term>
        <listitem>
          <para>A tool for automatically generating
          <filename>Makefile.in</filename> files from
          <filename>Makefile.am</filename> files [To create all the
          <filename>Makefile.in</filename> files for a package, run this program
          in the top-level directory. By scanning the
          <filename>configure.in</filename> file, it automatically finds each
          appropriate <filename>Makefile.am</filename> file and generates the
          corresponding <filename>Makefile.in</filename> file.]</para>
          <indexterm zone="ch-system-automake automake">
            <primary sortas="b-automake">automake</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="automake-version">
        <term><command>automake-&am-minor-version;</command></term>
        <listitem>
          <para>A hard link to <command>automake</command></para>
          <indexterm zone="ch-system-automake automake-version">
            <primary sortas="b-automake-&am-minor-version;">automake-&am-minor-version;</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>