RE: macro doc inconsistencies

2001-04-23 Thread Bruce Korb
Me, too! Me, too! :-) AutoGen is now an official GNU tool & it includes an extractor not only useful for documentation, but just about everything else tied to entries in a source file. Since it antedates many of the other tools mentioned, it also uses slightly different syntax. But it is surp

Re: macro doc inconsistencies

2001-04-23 Thread Lars J. Aas
On Mon, Apr 23, 2001 at 12:24:15PM -0500, John W. Eaton wrote: : You might take a look at what is currently used in the Octave sources : (current CVS and recent bleeding-edge (2.1.x) releases). The doc : strings for individual functions are written using Texinfo, and they : are included in the so

Re: macro doc inconsistencies

2001-04-23 Thread John W. Eaton
On 22-Apr-2001, Lars J. Aas <[EMAIL PROTECTED]> wrote: | I was thinking of using texinfo markup directly in the doc macro. HTML | and other formats should come from the texinfo output. I don't see this | part as an obstacle - the problem is more on the management-side - getting | the doc parts

Re: macro doc inconsistencies

2001-04-22 Thread Lars J. Aas
On Sun, Apr 22, 2001 at 06:27:34PM +0100, Gary V . Vaughan wrote: : On Sunday 22 April 2001 12:55 pm, Lars J. Aas wrote: : > I was thinking m4 would be the most suitable language to implement this in. : : Now that you mention it, having a document macro seems like a better idea, : though you wou

Re: macro doc inconsistencies

2001-04-22 Thread Gary V . Vaughan
On Sunday 22 April 2001 12:55 pm, Lars J. Aas wrote: > On Fri, Apr 20, 2001 at 09:02:15PM +0100, Gary V . Vaughan wrote: > : On Sunday 15 April 2001 4:00 pm, Lars J. Aas wrote: > : > If we could merge the macro reference documentation with the m4 files > : > and get it extracted automatically, it

Re: macro doc inconsistencies

2001-04-22 Thread Lars J. Aas
On Fri, Apr 20, 2001 at 09:02:15PM +0100, Gary V . Vaughan wrote: : On Sunday 15 April 2001 4:00 pm, Lars J. Aas wrote: : > If we could merge the macro reference documentation with the m4 files and : > get it extracted automatically, it would be a breeze to keep the doc : > consistent with the im

Re: macro doc inconsistencies

2001-04-20 Thread Gary V . Vaughan
On Sunday 15 April 2001 4:00 pm, Lars J. Aas wrote: > On Sat, Apr 14, 2001 at 12:04:37AM -0400, Steven G. Johnson wrote: > : On Fri, 13 Apr 2001 [EMAIL PROTECTED] wrote: > : > On Thu, Apr 12, 2001 at 11:21:03PM -0400, Steven G. Johnson wrote: > : > > This macro is documented in the manual but I c

macro doc inconsistencies

2001-04-15 Thread Lars J. Aas
On Sat, Apr 14, 2001 at 12:04:37AM -0400, Steven G. Johnson wrote: : On Fri, 13 Apr 2001 [EMAIL PROTECTED] wrote: : > On Thu, Apr 12, 2001 at 11:21:03PM -0400, Steven G. Johnson wrote: : > > This macro is documented in the manual but I can't seem to find it in the : > > source. Is it obsolete? :