1
0

automake.xml 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-automake" xreflabel="Automake" role="wrap">
  7. <title>Automake-&automake-version;</title>
  8. <?dbhtml filename="automake.html"?>
  9. <indexterm zone="ch-system-automake"><primary sortas="a-Automake">Automake</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Automake package contains programs for generating Makefiles for use
  12. with Autoconf.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.2 SBU</seg><seg>6.8 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>Automake installation depends on</segtitle>
  20. <seglistitem><seg>Autoconf, Bash, Coreutils,
  21. Diffutils, Grep, M4, Make, Perl, Sed</seg></seglistitem>
  22. </segmentedlist>
  23. </sect2>
  24. <sect2 role="installation">
  25. <title>Installation of Automake</title>
  26. <para>Prepare Automake for compilation:</para>
  27. <screen><userinput>./configure --prefix=/usr</userinput></screen>
  28. <para>Compile the package:</para>
  29. <screen><userinput>make</userinput></screen>
  30. <para>To test the results, issue:
  31. <userinput>make check</userinput>. This takes a long time, about 5 SBUs.</para>
  32. <para>Install the package:</para>
  33. <screen><userinput>make install</userinput></screen>
  34. </sect2>
  35. <sect2 id="contents-automake" role="content"><title>Contents of Automake</title>
  36. <segmentedlist>
  37. <segtitle>Installed programs</segtitle>
  38. <seglistitem><seg>acinstall, aclocal, aclocal-1.8, automake, automake-1.8,
  39. compile, config.guess, config.sub, depcomp, elisp-comp, install-sh, mdate-sh,
  40. missing, mkinstalldirs, py-compile, symlink-tree, ylwrap</seg></seglistitem>
  41. </segmentedlist>
  42. <variablelist><title>Short descriptions</title>
  43. <varlistentry id="acinstall">
  44. <term><command>acinstall</command></term>
  45. <listitem>
  46. <indexterm zone="ch-system-automake acinstall"><primary sortas="b-acinstall">acinstall</primary></indexterm>
  47. <para>is a script that installs aclocal-style M4 files.</para>
  48. </listitem>
  49. </varlistentry>
  50. <varlistentry id="aclocal">
  51. <term><command>aclocal</command></term>
  52. <listitem>
  53. <indexterm zone="ch-system-automake aclocal"><primary sortas="b-aclocal">aclocal</primary></indexterm>
  54. <para>generates <filename>aclocal.m4</filename>
  55. files based on the contents of <filename>configure.in</filename> files.</para>
  56. </listitem>
  57. </varlistentry>
  58. <varlistentry id="automake">
  59. <term><command>automake</command></term>
  60. <listitem>
  61. <indexterm zone="ch-system-automake automake"><primary sortas="b-automake">automake</primary></indexterm>
  62. <para>is a tool for automatically generating
  63. <filename>Makefile.in</filename>'s from files called
  64. <filename>Makefile.am</filename>. To create all the
  65. <filename>Makefile.in</filename> files for a package, run this program in the
  66. top-level directory. By scanning the <filename>configure.in</filename>s it
  67. automatically finds each appropriate <filename>Makefile.am</filename> and
  68. generate the corresponding <filename>Makefile.in</filename>.</para>
  69. </listitem>
  70. </varlistentry>
  71. <varlistentry id="compile">
  72. <term><command>compile</command></term>
  73. <listitem>
  74. <indexterm zone="ch-system-automake compile"><primary sortas="b-compile">compile</primary></indexterm>
  75. <para>is a wrapper for compilers.</para>
  76. </listitem>
  77. </varlistentry>
  78. <varlistentry id="config.guess">
  79. <term><command>config.guess</command> </term>
  80. <listitem>
  81. <indexterm zone="ch-system-automake config.guess"><primary sortas="b-config.guess">config.guess</primary></indexterm>
  82. <para>is a script that attempts to guess
  83. the canonical triplet for the given build, host, or target architecture.</para>
  84. </listitem>
  85. </varlistentry>
  86. <varlistentry id="config.su">
  87. <term><command>config.sub</command></term>
  88. <listitem>
  89. <indexterm zone="ch-system-automake config.su"><primary sortas="b-config.su">config.su</primary></indexterm>
  90. <para>is a configuration validation subroutine script.</para>
  91. </listitem>
  92. </varlistentry>
  93. <varlistentry id="depcomp">
  94. <term><command>depcomp</command></term>
  95. <listitem>
  96. <indexterm zone="ch-system-automake depcomp"><primary sortas="b-depcomp">depcomp</primary></indexterm>
  97. <para>is a script for compiling a program so that not only the desired output is
  98. generated, but also dependency information.</para>
  99. </listitem>
  100. </varlistentry>
  101. <varlistentry id="elisp-comp">
  102. <term><command>elisp-comp</command></term>
  103. <listitem>
  104. <indexterm zone="ch-system-automake elisp-comp"><primary sortas="b-elisp-comp">elisp-comp</primary></indexterm>
  105. <para>byte-compiles Emacs Lisp code.</para>
  106. </listitem>
  107. </varlistentry>
  108. <varlistentry id="install-sh">
  109. <term><command>install-sh</command></term>
  110. <listitem>
  111. <indexterm zone="ch-system-automake install-sh"><primary sortas="b-install-sh">install-sh</primary></indexterm>
  112. <para>is a script that installs a program, a script, or a datafile.</para>
  113. </listitem>
  114. </varlistentry>
  115. <varlistentry id="mdate-sh">
  116. <term><command>mdate-sh</command></term>
  117. <listitem>
  118. <indexterm zone="ch-system-automake mdate-sh"><primary sortas="b-mdate-sh">mdate-sh</primary></indexterm>
  119. <para>is a script that prints the modification time of a file or directory.</para>
  120. </listitem>
  121. </varlistentry>
  122. <varlistentry id="missing">
  123. <term><command>missing</command></term>
  124. <listitem>
  125. <indexterm zone="ch-system-automake missing"><primary sortas="b-missing">missing</primary></indexterm>
  126. <para>is a script acting as a common stub for
  127. missing GNU programs during an installation.</para>
  128. </listitem>
  129. </varlistentry>
  130. <varlistentry id="mkinstalldirs">
  131. <term><command>mkinstalldirs</command></term>
  132. <listitem>
  133. <indexterm zone="ch-system-automake mkinstalldirs"><primary sortas="b-mkinstalldirs">mkinstalldirs</primary></indexterm>
  134. <para>is a script that creates a directory tree.</para>
  135. </listitem>
  136. </varlistentry>
  137. <varlistentry id="py-compile">
  138. <term><command>py-compile</command></term>
  139. <listitem>
  140. <indexterm zone="ch-system-automake py-compile"><primary sortas="b-py-compile">py-compile</primary></indexterm>
  141. <para>compiles a Python program.</para>
  142. </listitem>
  143. </varlistentry>
  144. <varlistentry id="symlink-tree">
  145. <term><command>symlink-tree</command></term>
  146. <listitem>
  147. <indexterm zone="ch-system-automake symlink-tree"><primary sortas="b-symlink-tree">symlink-tree</primary></indexterm>
  148. <para>is a script to create a symlink tree of a directory tree.</para>
  149. </listitem>
  150. </varlistentry>
  151. <varlistentry id="ylwrap">
  152. <term><command>ylwrap</command></term>
  153. <listitem>
  154. <indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm>
  155. <para>is a wrapper for lex and yacc.</para>
  156. </listitem>
  157. </varlistentry>
  158. </variablelist>
  159. </sect2>
  160. </sect1>