Re: doc: misplaced sections about Emacs Lisp, Java, Python

[Ralf Wildenhues]

Hi Bruno,

thanks for the report!

* Bruno Haible wrote on Sun, Aug 15, 2010 at 04:52:55PM CEST:
> In the Automake documentation, the sections "Emacs Lisp", "Java", "Python"
> are in a chapter "Other GNU Tools", two chapters away from the sections
> "C++ support", "Objective C Support", "Assembly Support", "Java Support".
> It is somewhat confusing.

I agree that it is a bit confusing.  Esp. the Java splitting seems ugly.

> Suggestion:
>   - Move the sections "Emacs Lisp", "Python" to the chapter
>     "Building Programs and Libraries".
>   - Combine the section "Java" with the section "Java Support", possibly
>     in two subsections, inside the chapter "Building Programs and Libraries".

I'm torn about this one.  The short-hand for the "Building Programs and
Libraries" chapter is "Programs", and in the Automake naming scheme,
_PROGRAMS are definitely not a super set of Python scripts nor Lisp
sources.  OTOH if we intend for the more general meaning of "programs
that may be executed", then I would expect to find scripts dealt with
there as well, but they are discussed in the chapter in between.

Furthermore, the Programs chapter is quite large the way it is already,
and that we may want to add a couple more entries, too.  Not a big issue
of course, but doesn't add to a well-structured manual.

I'm not quite sure about the best way out here.

Cheers,
Ralf