Re: more documentation proofreading

[Akim Demaille]

>>>>> "Steven" == Steven G Johnson <address@hidden> writes:

Steven> Good point.  On the same note, things after a # are also
Steven> executed...

No, they are not :) $1, $@ and the like are always *substituted* when
expanding a macro but code after # or dnl is not executed:

~ % m4
define(foo, #$1
$1)

define(bar, BAR)

foo(`bar')
#bar
BAR

~ %                                                            nostromo Err 130


Steven> 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.

Steven> It specifically referred to configure.ac files.

Then we should not get into the details, and just say `use #'.  They
don't need to know more.