Added a few comments here and there
[linux_from_scratch.git] / newxml / appendixa / automake.xml
blobb010e78d3c97810ed307207a93c5daeac07c625c
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3CR2//EN" "http://www.docbook.org/xml/4.3CR2/docbookx.dtd" [
3   <!ENTITY % automake-entities SYSTEM "../ent/automake.ent">
4   %automake-entities;
5 ]>
6 <sect1 id="aa-automake" xreflabel="Automake">
7 <title>Automake</title>
8 <?dbhtml filename="automake.html"?>
10 <para>For installation instructions see <xref linkend="ch06-automake"/>.</para>
12 <sect2><title>Official Download Location</title>
14 <literallayout>Automake (&automake-version;): 
15 <ulink url="ftp://ftp.gnu.org/gnu/automake/"/></literallayout>
16 </sect2>
18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="automake-contents.xml"/>
21 <sect2><title>Short descriptions</title>
23 <para><command>acinstall</command> is a script that installs
24 aclocal-style M4 files.</para>
26 <para><command>aclocal</command> generates <filename>aclocal.m4</filename>
27 files based on the contents of <filename>configure.in</filename> files.</para>
29 <para><command>automake</command> is a tool for automatically generating
30 <filename>Makefile.in</filename>'s from files called
31 <filename>Makefile.am</filename>. To create all the
32 <filename>Makefile.in</filename> files for a package, run this program in the
33 top level directory. By scanning the <filename>configure.in</filename>s it
34 automatically finds each appropriate <filename>Makefile.am</filename> and
35 generate the corresponding <filename>Makefile.in</filename>.</para>
37 <para><command>compile</command> is a wrapper for compilers.</para>
39 <para><command>config.guess</command> is a script that attempts to guess
40 the canonical triplet for the given build, host, or target architecture.</para>
42 <para><command>config.sub</command> is a configuration validation
43 subroutine script.</para>
45 <para><command>depcomp</command> is a script for compiling a program
46 so that not only the desired output is generated but also dependency
47 information.</para>
49 <para><command>elisp-comp</command> byte-compiles Emacs Lisp code.</para>
51 <para><command>install-sh</command> is a script that installs a program,
52 a script, or a datafile.</para>
54 <para><command>mdate-sh</command> is a script that prints the modification
55 time of a file or directory.</para>
57 <para><command>missing</command> is a script acting as a common stub for
58 missing GNU programs during an installation.</para>
60 <para><command>mkinstalldirs</command> is a script that creates a directory
61 tree.</para>
63 <para><command>py-compile</command> compiles a Python program.</para>
65 <para><command>symlink-tree</command> is a script to create a symlink tree of
66 a directory tree.</para>
68 <para><command>ylwrap</command> is a wrapper for lex and yacc.</para>
70 </sect2>
74 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="automake-deps.xml"/>
78 </sect1>