Re: RFC: New layout for 2.53

[Lars J. Aas]

On Thu, Jul 19, 2001 at 01:42:47PM +0200, Akim Demaille wrote:
: >>>>> "Lars" == Lars J Aas <address@hidden> writes:
: Lars> Anyways, I was thinking of starting to implement the
: Lars> macro-doc-snarfing system I've mentioned before, but it may not
: Lars> be ready for 2.53 (nor does it matter that much when it is
: Lars> ready).
: 
: Why not.  But I'd say we have to demonstrate its usefulness.  What
: would be great would be that foreign macros, say the macro archive,
: would be automatically included in the Autoconf documentation.  But
: that's not doable, so the actual gain is not very clear.  In addition,
: being in Texinfo-mode when writing documentation is a real bonus.

I think the real bonus is to do programming on a macro, and then just
update the macro description above the macro and know that the updated
description will be included in the doc the next time it is generated.
The improved locality of the doc is the gain.  That's why javadoc and
Doxygen, etc. are such great successes.

: Here, we are talking about a file which is part Texinfo, part M4...

Multi-mode files have never been a problem for me.  It's not good for
emacs modes, of course, but I'm not using emacs :)

  Lars J
-- 
This is your life and it's ending one minute at a time.