From: Ralf Wildenhues Date: Sat, 8 Jan 2011 19:18:03 +0000 (+0100) Subject: docs: split 'amhello Explained' node. X-Git-Tag: v1.11.1b~37^2~11 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=dcc0f400e92d994a77dc3228d90ab9fbfd0590e8;p=thirdparty%2Fautomake.git docs: split 'amhello Explained' node. * doc/automake.texi (amhello Explained): Split node ... (amhello's configure.ac Setup Explained) (amhello's Makefile.am Setup Explained) : ... into these two. (Top, Hello World): Adjust, and add @anchor for stable URL links. Suggestion by Karl Berry in automake bug#7766. Signed-off-by: Ralf Wildenhues --- diff --git a/ChangeLog b/ChangeLog index 5fc0c9adf..5fb21e95e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2011-01-09 Ralf Wildenhues + + docs: split 'amhello Explained' node. + * doc/automake.texi (amhello Explained): Split node ... + (amhello's configure.ac Setup Explained) + (amhello's Makefile.am Setup Explained) : ... into these two. + (Top, Hello World): Adjust, and add @anchor for stable URL links. + Suggestion by Karl Berry in automake bug#7766. + 2011-01-08 Karl Berry Eric Blake diff --git a/doc/automake.texi b/doc/automake.texi index c63dbf3cc..775c95f97 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -157,7 +157,8 @@ Use Cases for the GNU Build System A Small Hello World * Creating amhello:: Create @file{amhello-1.0.tar.gz} from scratch -* amhello Explained:: @file{configure.ac} and @file{Makefile.am} explained +* amhello's configure.ac Setup Explained:: +* amhello's Makefile.am Setup Explained:: General ideas @@ -1392,9 +1393,11 @@ instantiate the GNU Build System, while the second explains the meaning of the @file{configure.ac} and @file{Makefile.am} files read by the Autotools. +@anchor{amhello Explained} @menu * Creating amhello:: Create @file{amhello-1.0.tar.gz} from scratch -* amhello Explained:: @file{configure.ac} and @file{Makefile.am} explained +* amhello's configure.ac Setup Explained:: +* amhello's Makefile.am Setup Explained:: @end menu @node Creating amhello @@ -1555,8 +1558,10 @@ creating @file{configure} from @file{configure.ac}, while direct you to the right manual when seeking answers. -@node amhello Explained -@subsection @file{amhello-1.0} Explained +@node amhello's configure.ac Setup Explained +@subsection @code{amhello}'s @file{configure.ac} Setup Explained + +@cindex @file{configure.ac}, Hello World Let us begin with the contents of @file{configure.ac}. @@ -1664,6 +1669,10 @@ your package may need (@pxref{autoscan Invocation, , Using @command{autoscan} to Create @file{configure.ac}, autoconf, The Autoconf Manual}). + +@node amhello's Makefile.am Setup Explained +@subsection @code{amhello}'s @file{Makefile.am} Setup Explained + @cindex @file{Makefile.am}, Hello World We now turn to @file{src/Makefile.am}. This file contains