Re: bug#7766: (lack of) config.h description in manual

[Ralf Wildenhues]

Hi Karl,

* Karl Berry wrote on Sat, Jan 01, 2011 at 01:00:20AM CET:
> Finally, the "amhello explained" node is pretty long.  It seems to break
> up naturally into three pieces, for each of the files being explained.
> Perhaps it would be good to make them each separate (sub)nodes.

Hmm, I see a natural split into two, not three nodes.  Below, I replaced
the existing one rather than using another lower hierarchy level.  Does
this seem acceptable to you?

Thanks,
Ralf

    docs: split 'amhello Explained' node.
    
    * doc/automake.texi (amhello Explained): Split node ...
    (amhello/configure.ac, amhello/Makefile.am): ... into these two.
    (Top, Hello World): Adjust, and add @anchor for stable URL links.
    Suggestion by Karl Berry in automake bug#7766.

diff --git a/doc/automake.texi b/doc/automake.texi
index c63dbf3..9e29951 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -157,7 +157,8 @@ Top
 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/configure.ac::        Configure setup explained
+* amhello/Makefile.am::         Makefile setup explained
 
 General ideas
 
@@ -1392,9 +1393,11 @@ Hello World
 meaning of the @file{configure.ac} and @file{Makefile.am} files read
 by the Autotools.
 
address@hidden Explained}
 @menu
 * Creating amhello::            Create @file{amhello-1.0.tar.gz} from scratch
-* amhello Explained::           @file{configure.ac} and @file{Makefile.am} 
explained
+* amhello/configure.ac::        Configure setup explained
+* amhello/Makefile.am::         Makefile setup explained
 @end menu
 
 @node Creating amhello
@@ -1555,8 +1558,10 @@ Creating amhello
 direct you to the right manual when seeking answers.
 
 
address@hidden amhello Explained
address@hidden @file{amhello-1.0} Explained
address@hidden amhello/configure.ac
address@hidden Configure setup explained
+
address@hidden @file{configure.ac}, Hello World
 
 Let us begin with the contents of @file{configure.ac}.
 
@@ -1664,6 +1669,10 @@ amhello Explained
 @command{autoscan} to Create @file{configure.ac}, autoconf, The
 Autoconf Manual}).
 
+
address@hidden amhello/Makefile.am
address@hidden Makefile setup explained
+
 @cindex @file{Makefile.am}, Hello World
 
 We now turn to @file{src/Makefile.am}.  This file contains