Re: more documentation proofreading

[Steven G. Johnson]

On 10 Apr 2001, Akim Demaille wrote:
> Steven> Isn't the fact that any lines before AC_INIT are ignored,
> Steven> whether they begin with # or not?  So that's not a rule about
> Steven> # comments per se.
> 
> No, they are not ignored: they are *executed*, but (unless you play
> with divert), nothing is output.  For instance, you may `define' etc.

Good point.  On the same note, things after a # are also
executed...another reason to distinguish between m4 and sh comments.

> This is a good approximation, but it leaves the most important thing
> aside: comments *inside* macro definition will of course be output,
> but not comments outside (i.e., typically comments in aclocal.m4 which
> are not in a macro body).
> 
> But I don't recall whether this section is about configure.in and only
> it, or it includes writing library m4 files.

It specifically referred to configure.ac files.

> It depends upon the section.  If the section is about writing macros
> (not using them), then we should keep it.  Don't forget newlines are
> not meaningless in sh, and there are cases where you do not want to
> issue one.

Okay.

Steven