Changeset 9e26f63 for chapter06/automake.xml
- Timestamp:
- 02/02/2006 09:35:05 PM (19 years ago)
- Children:
- a7fe252
- Parents:
- 0e5c784
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/automake.xml
r0e5c784 r9e26f63 1 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 3 4 <!ENTITY % general-entities SYSTEM "../general.ent"> 4 5 %general-entities; 5 6 ]> 7 6 8 <sect1 id="ch-system-automake" role="wrap"> 7 <title>Automake-&automake-version;</title> 8 <?dbhtml filename="automake.html"?> 9 10 <indexterm zone="ch-system-automake"><primary sortas="a-Automake">Automake</primary></indexterm> 11 12 <sect2 role="package"><title/> 13 <para>The Automake package contains programs for generating Makefiles for use 14 with Autoconf.</para> 15 16 <segmentedlist> 17 <segtitle>&buildtime;</segtitle> 18 <segtitle>&diskspace;</segtitle> 19 <seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem> 20 </segmentedlist> 21 22 <segmentedlist> 23 <segtitle>&dependencies;</segtitle> 24 <seglistitem><seg>Autoconf, Bash, Coreutils, 25 Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem> 26 </segmentedlist> 27 </sect2> 28 29 <sect2 role="installation"> 30 <title>Installation of Automake</title> 31 32 <para>Prepare Automake for compilation:</para> 9 <?dbhtml filename="automake.html"?> 10 11 <title>Automake-&automake-version;</title> 12 13 <indexterm zone="ch-system-automake"> 14 <primary sortas="a-Automake">Automake</primary> 15 </indexterm> 16 17 <sect2 role="package"> 18 <title/> 19 20 <para>The Automake package contains programs for generating Makefiles for use 21 with Autoconf.</para> 22 23 <segmentedlist> 24 <segtitle>&buildtime;</segtitle> 25 <segtitle>&diskspace;</segtitle> 26 27 <seglistitem> 28 <seg>0.2 SBU</seg> 29 <seg>8.8 MB</seg> 30 </seglistitem> 31 </segmentedlist> 32 33 <segmentedlist> 34 <segtitle>&dependencies;</segtitle> 35 36 <seglistitem> 37 <seg>Autoconf, Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, 38 and Sed</seg> 39 </seglistitem> 40 </segmentedlist> 41 42 </sect2> 43 44 <sect2 role="installation"> 45 <title>Installation of Automake</title> 46 47 <para>Prepare Automake for compilation:</para> 33 48 34 49 <screen><userinput>./configure --prefix=/usr</userinput></screen> 35 50 36 <para>Compile the package:</para>51 <para>Compile the package:</para> 37 52 38 53 <screen><userinput>make</userinput></screen> 39 54 40 <para>To test the results, issue: 41 <userinput>make check</userinput>. This takes a long time, about 5 SBUs.</para> 42 43 <para>Install the package:</para> 55 <para>To test the results, issue: 56 <userinput>make check</userinput>. 57 This takes a long time, about 5 SBUs.</para> 58 59 <para>Install the package:</para> 44 60 45 61 <screen><userinput>make install</userinput></screen> 46 62 47 </sect2> 48 49 50 <sect2 id="contents-automake" role="content"><title>Contents of Automake</title> 51 52 <segmentedlist> 53 <segtitle>Installed programs</segtitle> 54 <seglistitem><seg>acinstall, aclocal, aclocal-&automake-version;, 55 automake, automake-&automake-version;, 56 compile, config.guess, config.sub, depcomp, elisp-comp, install-sh, mdate-sh, 57 missing, mkinstalldirs, py-compile, symlink-tree, and ylwrap</seg></seglistitem> 58 </segmentedlist> 59 60 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> 61 <?dbfo list-presentation="list"?> 62 <?dbhtml list-presentation="table"?> 63 64 <varlistentry id="acinstall"> 65 <term><command>acinstall</command></term> 66 <listitem> 67 <para>A script that installs aclocal-style M4 files</para> 68 <indexterm zone="ch-system-automake acinstall"><primary sortas="b-acinstall">acinstall</primary></indexterm> 69 </listitem> 70 </varlistentry> 71 72 <varlistentry id="aclocal"> 73 <term><command>aclocal</command></term> 74 <listitem> 75 <para>Generates <filename>aclocal.m4</filename> 76 files based on the contents of <filename>configure.in</filename> files</para> 77 <indexterm zone="ch-system-automake aclocal"><primary sortas="b-aclocal">aclocal</primary></indexterm> 78 </listitem> 79 </varlistentry> 80 81 <varlistentry id="aclocal-version"> 82 <term><command>aclocal-&automake-version;</command></term> 83 <listitem> 84 <para>A hard link to <command>aclocal</command></para> 85 <indexterm zone="ch-system-automake aclocal-version"><primary 86 sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary></indexterm> 87 </listitem> 88 </varlistentry> 89 90 <varlistentry id="automake"> 91 <term><command>automake</command></term> 92 <listitem> 93 <para>A tool for automatically generating 94 <filename>Makefile.in</filename> files from 95 <filename>Makefile.am</filename> files. To create all the 96 <filename>Makefile.in</filename> files for a package, run this program 97 in the top-level directory. By scanning the 98 <filename>configure.in</filename> file, it automatically finds each 99 appropriate <filename>Makefile.am</filename> file and generates the 100 corresponding <filename>Makefile.in</filename> file</para> 101 <indexterm zone="ch-system-automake automake"><primary sortas="b-automake">automake</primary></indexterm> 102 </listitem> 103 </varlistentry> 104 105 <varlistentry id="automake-version"> 106 <term><command>automake-&automake-version;</command></term> 107 <listitem> 108 <para>A hard link to <command>automake</command></para> 109 <indexterm zone="ch-system-automake automake-version"><primary 110 sortas="b-automake-&automake-version;">automake-&automake-version;</primary></indexterm> 111 </listitem> 112 </varlistentry> 113 114 <varlistentry id="compile"> 115 <term><command>compile</command></term> 116 <listitem> 117 <para>A wrapper for compilers</para> 118 <indexterm zone="ch-system-automake compile"><primary sortas="b-compile">compile</primary></indexterm> 119 </listitem> 120 </varlistentry> 121 122 <varlistentry id="config.guess"> 123 <term><command>config.guess</command></term> 124 <listitem> 125 <para>A script that attempts to guess 126 the canonical triplet for the given build, host, or target architecture</para> 127 <indexterm zone="ch-system-automake config.guess"><primary sortas="b-config.guess">config.guess</primary></indexterm> 128 </listitem> 129 </varlistentry> 130 131 <varlistentry id="config.sub"> 132 <term><command>config.sub</command></term> 133 <listitem> 134 <para>A configuration validation subroutine script</para> 135 <indexterm zone="ch-system-automake config.sub"><primary sortas="b-config.sub">config.sub</primary></indexterm> 136 </listitem> 137 </varlistentry> 138 139 <varlistentry id="depcomp"> 140 <term><command>depcomp</command></term> 141 <listitem> 142 <para>A script for compiling a program so that dependency information 143 is generated in addition to the desired output</para> 144 <indexterm zone="ch-system-automake depcomp"><primary sortas="b-depcomp">depcomp</primary></indexterm> 145 </listitem> 146 </varlistentry> 147 148 <varlistentry id="elisp-comp"> 149 <term><command>elisp-comp</command></term> 150 <listitem> 151 <para>Byte-compiles Emacs Lisp code</para> 152 <indexterm zone="ch-system-automake elisp-comp"><primary sortas="b-elisp-comp">elisp-comp</primary></indexterm> 153 </listitem> 154 </varlistentry> 155 156 <varlistentry id="install-sh"> 157 <term><command>install-sh</command></term> 158 <listitem> 159 <para>A script that installs a program, script, or data file</para> 160 <indexterm zone="ch-system-automake install-sh"><primary sortas="b-install-sh">install-sh</primary></indexterm> 161 </listitem> 162 </varlistentry> 163 164 <varlistentry id="mdate-sh"> 165 <term><command>mdate-sh</command></term> 166 <listitem> 167 <para>A script that prints the modification time of a file or directory</para> 168 <indexterm zone="ch-system-automake mdate-sh"><primary sortas="b-mdate-sh">mdate-sh</primary></indexterm> 169 </listitem> 170 </varlistentry> 171 172 <varlistentry id="missing"> 173 <term><command>missing</command></term> 174 <listitem> 175 <para>A script acting as a common stub for missing GNU programs during 176 an installation</para> 177 <indexterm zone="ch-system-automake missing"><primary sortas="b-missing">missing</primary></indexterm> 178 </listitem> 179 </varlistentry> 180 181 <varlistentry id="mkinstalldirs"> 182 <term><command>mkinstalldirs</command></term> 183 <listitem> 184 <para>A script that creates a directory tree</para> 185 <indexterm zone="ch-system-automake mkinstalldirs"><primary sortas="b-mkinstalldirs">mkinstalldirs</primary></indexterm> 186 </listitem> 187 </varlistentry> 188 189 <varlistentry id="py-compile"> 190 <term><command>py-compile</command></term> 191 <listitem> 192 <para>Compiles a Python program</para> 193 <indexterm zone="ch-system-automake py-compile"><primary sortas="b-py-compile">py-compile</primary></indexterm> 194 </listitem> 195 </varlistentry> 196 197 <varlistentry id="symlink-tree"> 198 <term><command>symlink-tree</command></term> 199 <listitem> 200 <para>A script to create a symlink tree of a directory tree</para> 201 <indexterm zone="ch-system-automake symlink-tree"><primary sortas="b-symlink-tree">symlink-tree</primary></indexterm> 202 </listitem> 203 </varlistentry> 204 205 <varlistentry id="ylwrap"> 206 <term><command>ylwrap</command></term> 207 <listitem> 208 <para>A wrapper for <command>lex</command> and <command>yacc</command></para> 209 <indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm> 210 </listitem> 211 </varlistentry> 212 </variablelist> 213 214 </sect2> 63 </sect2> 64 65 66 <sect2 id="contents-automake" role="content"> 67 <title>Contents of Automake</title> 68 69 <segmentedlist> 70 <segtitle>Installed programs</segtitle> 71 72 <seglistitem> 73 <seg>acinstall, aclocal, aclocal-&automake-version;, automake, 74 automake-&automake-version;, compile, config.guess, config.sub, 75 depcomp, elisp-comp, install-sh, mdate-sh, missing, mkinstalldirs, 76 py-compile, symlink-tree, and ylwrap</seg> 77 </seglistitem> 78 </segmentedlist> 79 80 <variablelist> 81 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 82 <?dbfo list-presentation="list"?> 83 <?dbhtml list-presentation="table"?> 84 85 <varlistentry id="acinstall"> 86 <term><command>acinstall</command></term> 87 <listitem> 88 <para>A script that installs aclocal-style M4 files</para> 89 <indexterm zone="ch-system-automake acinstall"> 90 <primary sortas="b-acinstall">acinstall</primary> 91 </indexterm> 92 </listitem> 93 </varlistentry> 94 95 <varlistentry id="aclocal"> 96 <term><command>aclocal</command></term> 97 <listitem> 98 <para>Generates <filename>aclocal.m4</filename> files based on the 99 contents of <filename>configure.in</filename> files</para> 100 <indexterm zone="ch-system-automake aclocal"> 101 <primary sortas="b-aclocal">aclocal</primary> 102 </indexterm> 103 </listitem> 104 </varlistentry> 105 106 <varlistentry id="aclocal-version"> 107 <term><command>aclocal-&automake-version;</command></term> 108 <listitem> 109 <para>A hard link to <command>aclocal</command></para> 110 <indexterm zone="ch-system-automake aclocal-version"> 111 <primary sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary> 112 </indexterm> 113 </listitem> 114 </varlistentry> 115 116 <varlistentry id="automake"> 117 <term><command>automake</command></term> 118 <listitem> 119 <para>A tool for automatically generating 120 <filename>Makefile.in</filename> files from 121 <filename>Makefile.am</filename> files. To create all the 122 <filename>Makefile.in</filename> files for a package, run this program 123 in the top-level directory. By scanning the 124 <filename>configure.in</filename> file, it automatically finds each 125 appropriate <filename>Makefile.am</filename> file and generates the 126 corresponding <filename>Makefile.in</filename> file</para> 127 <indexterm zone="ch-system-automake automake"> 128 <primary sortas="b-automake">automake</primary> 129 </indexterm> 130 </listitem> 131 </varlistentry> 132 133 <varlistentry id="automake-version"> 134 <term><command>automake-&automake-version;</command></term> 135 <listitem> 136 <para>A hard link to <command>automake</command></para> 137 <indexterm zone="ch-system-automake automake-version"> 138 <primary sortas="b-automake-&automake-version;">automake-&automake-version;</primary> 139 </indexterm> 140 </listitem> 141 </varlistentry> 142 143 <varlistentry id="compile"> 144 <term><command>compile</command></term> 145 <listitem> 146 <para>A wrapper for compilers</para> 147 <indexterm zone="ch-system-automake compile"> 148 <primary sortas="b-compile">compile</primary> 149 </indexterm> 150 </listitem> 151 </varlistentry> 152 153 <varlistentry id="config.guess"> 154 <term><command>config.guess</command></term> 155 <listitem> 156 <para>A script that attempts to guess the canonical triplet for 157 the given build, host, or target architecture</para> 158 <indexterm zone="ch-system-automake config.guess"> 159 <primary sortas="b-config.guess">config.guess</primary> 160 </indexterm> 161 </listitem> 162 </varlistentry> 163 164 <varlistentry id="config.sub"> 165 <term><command>config.sub</command></term> 166 <listitem> 167 <para>A configuration validation subroutine script</para> 168 <indexterm zone="ch-system-automake config.sub"> 169 <primary sortas="b-config.sub">config.sub</primary> 170 </indexterm> 171 </listitem> 172 </varlistentry> 173 174 <varlistentry id="depcomp"> 175 <term><command>depcomp</command></term> 176 <listitem> 177 <para>A script for compiling a program so that dependency information 178 is generated in addition to the desired output</para> 179 <indexterm zone="ch-system-automake depcomp"> 180 <primary sortas="b-depcomp">depcomp</primary> 181 </indexterm> 182 </listitem> 183 </varlistentry> 184 185 <varlistentry id="elisp-comp"> 186 <term><command>elisp-comp</command></term> 187 <listitem> 188 <para>Byte-compiles Emacs Lisp code</para> 189 <indexterm zone="ch-system-automake elisp-comp"> 190 <primary sortas="b-elisp-comp">elisp-comp</primary> 191 </indexterm> 192 </listitem> 193 </varlistentry> 194 195 <varlistentry id="install-sh"> 196 <term><command>install-sh</command></term> 197 <listitem> 198 <para>A script that installs a program, script, or data file</para> 199 <indexterm zone="ch-system-automake install-sh"> 200 <primary sortas="b-install-sh">install-sh</primary> 201 </indexterm> 202 </listitem> 203 </varlistentry> 204 205 <varlistentry id="mdate-sh"> 206 <term><command>mdate-sh</command></term> 207 <listitem> 208 <para>A script that prints the modification time of a file or 209 directory</para> 210 <indexterm zone="ch-system-automake mdate-sh"> 211 <primary sortas="b-mdate-sh">mdate-sh</primary> 212 </indexterm> 213 </listitem> 214 </varlistentry> 215 216 <varlistentry id="missing"> 217 <term><command>missing</command></term> 218 <listitem> 219 <para>A script acting as a common stub for missing GNU programs during 220 an installation</para> 221 <indexterm zone="ch-system-automake missing"> 222 <primary sortas="b-missing">missing</primary> 223 </indexterm> 224 </listitem> 225 </varlistentry> 226 227 <varlistentry id="mkinstalldirs"> 228 <term><command>mkinstalldirs</command></term> 229 <listitem> 230 <para>A script that creates a directory tree</para> 231 <indexterm zone="ch-system-automake mkinstalldirs"> 232 <primary sortas="b-mkinstalldirs">mkinstalldirs</primary> 233 </indexterm> 234 </listitem> 235 </varlistentry> 236 237 <varlistentry id="py-compile"> 238 <term><command>py-compile</command></term> 239 <listitem> 240 <para>Compiles a Python program</para> 241 <indexterm zone="ch-system-automake py-compile"> 242 <primary sortas="b-py-compile">py-compile</primary> 243 </indexterm> 244 </listitem> 245 </varlistentry> 246 247 <varlistentry id="symlink-tree"> 248 <term><command>symlink-tree</command></term> 249 <listitem> 250 <para>A script to create a symlink tree of a directory tree</para> 251 <indexterm zone="ch-system-automake symlink-tree"> 252 <primary sortas="b-symlink-tree">symlink-tree</primary> 253 </indexterm> 254 </listitem> 255 </varlistentry> 256 257 <varlistentry id="ylwrap"> 258 <term><command>ylwrap</command></term> 259 <listitem> 260 <para>A wrapper for <command>lex</command> and 261 <command>yacc</command></para> 262 <indexterm zone="ch-system-automake ylwrap"> 263 <primary sortas="b-ylwrap">ylwrap</primary> 264 </indexterm> 265 </listitem> 266 </varlistentry> 267 268 </variablelist> 269 270 </sect2> 215 271 216 272 </sect1> 217
Note:
See TracChangeset
for help on using the changeset viewer.