Re: AC_DEFINE_UNQUOTED doc update

[Ralf Wildenhues]

* Paul Eggert wrote on Sat, May 14, 2005 at 08:01:24PM CEST:
> Ralf Wildenhues <address@hidden> writes:
> 
> > I was one who argued for this, so I volunteer to produce a patch for
> > (2), if there are chances that it will be accepted.  
> 
> Yes, I'd like to have the manual be consistent.

OK.

> Rather than doing it all at once, though, perhaps you could do two or
> three examples first, to make sure we're all on the same page here.

When I read this, I was almost through anyway, so here goes it all.  :-)
While at it, I also took liberty to fix many overlong lines in the dvi
output (the `make' chapter is one important exception; its high
indentation makes it very hard to write decently there), and add a
couple of comments to improve texi highlighting in vim.

In order to give a quick overview of the changes, they are broken down
in several patches:
- hunks with simple added quotes only,
- quotes which also add [] to otherwise empty arguments,
- added quotes which refer to either old macros or directly to pieces of
  Autoconf code (and may thus be technically incorrect),
- highlighting helper comments,
- removal of many overfull/underfull hboxes.

You may want to check the third patch and the last patch in more detail,
as the last one actually changes content (plus adds a few [] as well),
and I am known to produce incorrect English at times.  :)

I have deliberately not touched on the subject of double quotes (for
example for C code snippets), however that would need a check as well,
but I was unsure about the rules to apply there.  They are easy to find
quickly, though.

Of couse, my patches (hopefully) should not touch any macro definition
or any examples which point out old or wrong-quoted code.

If you *really* want me to, I could write detailed ChangeLog entries.
But I'd rather not, and I figured I'd at least wait to see which parts
you actually want.

Regards,
Ralf

quotes-simple.diff
Description: Text document

quotes-emptyargs.diff
Description: Text document

quotes-equiv.diff
Description: Text document

highlight-helpers.diff
Description: Text document

longlines.diff
Description: Text document