Re: additional doxygen pages (was: Re: QOF help!)

2004-05-07 Thread Derek Atkins
[EMAIL PROTECTED] (Linas Vepstas) writes: > On Wed, May 05, 2004 at 03:08:24PM -0400, Derek Atkins was heard to remark: >> Ok, the docs are now auto-generated every night from CVS and are >> available on the web: > > Take a look now at http://cvs.gnucash.org/docs/HEAD/modules.html > > Should look

Re: additional doxygen pages (was: Re: QOF help!)

2004-05-07 Thread Linas Vepstas
On Wed, May 05, 2004 at 03:08:24PM -0400, Derek Atkins was heard to remark: > Ok, the docs are now auto-generated every night from CVS and are > available on the web: Take a look now at http://cvs.gnucash.org/docs/HEAD/modules.html Should look a lot more impressive. --linas -- pub 1024D/01045

Re: additional doxygen pages (was: Re: QOF help!)

2004-05-06 Thread Neil Williams
On Thursday 06 May 2004 3:50, Linas Vepstas wrote: > > >>I'm not sure how to use doxygen for architectural docs... Could you > > >>provide an example or pointers to docs that describe it? > > > > > >Using \defgroup , \addtogroup , \example , \mainpage and \file , and a > > >bit of convention, one

Re: additional doxygen pages (was: Re: QOF help!)

2004-05-06 Thread Linas Vepstas
> >>I'm not sure how to use doxygen for architectural docs... Could you > >>provide an example or pointers to docs that describe it? > > > >Using \defgroup , \addtogroup , \example , \mainpage and \file , and a > >bit of convention, one could build higher-level structural docs > >along-side the lo

Online Docs (was Re: QOF help!)

2004-05-06 Thread Derek Atkins
[EMAIL PROTECTED] (Linas Vepstas) writes: > On Tue, May 04, 2004 at 09:41:17PM -0400, Derek Atkins was heard to remark: >> >> (the latter being the list archives). Right now machine1 (www) has >> very limited disk space (at least until Linas upgrades his machine). > > ? Its had about 30GB of fre

Re: QOF help!

2004-05-06 Thread Linas Vepstas
On Tue, May 04, 2004 at 09:41:17PM -0400, Derek Atkins was heard to remark: > > (the latter being the list archives). Right now machine1 (www) has > very limited disk space (at least until Linas upgrades his machine). ? Its had about 30GB of free disk space for about 5 years now ... How much do

ANNOUNCE: Online Docs [was Re: QOF help!]

2004-05-06 Thread Linas Vepstas
Hi, On Mon, May 03, 2004 at 10:10:41PM +0100, Neil Williams was heard to remark: > On Monday 03 May 2004 4:07, you wrote: > > > Where's the documentation for using QOF and Gnucash together? I just cleaned up and updated the QOF part of the docs, and put them online. Take a look at: http://qof.s

Re: additional doxygen pages (was: Re: QOF help!)

2004-05-05 Thread Derek Atkins
Ok, the docs are now auto-generated every night from CVS and are available on the web: http://cvs.gnucash.org/docs/HEAD/ Enjoy, -derek -- Derek Atkins, SB '93 MIT EE, SM '95 MIT Media Laboratory Member, MIT Student Information Processing Board (SIPB) URL: http://web.mi

additional doxygen pages (was: Re: QOF help!)

2004-05-05 Thread Christian Stimming
Josh Sled wrote: I'm not sure how to use doxygen for architectural docs... Could you provide an example or pointers to docs that describe it? http://www.stack.nl/~dimitri/doxygen/commands.html Using \defgroup , \addtogroup , \example , \mainpage and \file , and a bit of convention, one could bui

Re: QOF help!

2004-05-04 Thread Josh Sled
On Tue, 2004-05-04 at 17:50, Derek Atkins wrote: > I'm not sure how to use doxygen for architectural docs... Could you > provide an example or pointers to docs that describe it? http://www.stack.nl/~dimitri/doxygen/commands.html Using \defgroup , \addtogroup , \example , \mainpage and \file , a

Re: QOF help!

2004-05-04 Thread Derek Atkins
Neil Williams <[EMAIL PROTECTED]> writes: > Can't it simply be linked into www.gnucash.org using a symbolic link or NFS > etc.? What's the design of the various sub-domains? (off-list if you like - > I'll need to know about the list vs www domains for the search engine). Yes, there could be an

Re: QOF help!

2004-05-04 Thread Neil Williams
On Tuesday 04 May 2004 10:41, Derek Atkins wrote: > Neil Williams <[EMAIL PROTECTED]> writes: > > The documentation produced, is there a problem with hosting it somewhere? > > (If I keep it updated from CVS)? I've got the space to host it, if you'd > > like, although somewhere on gnucash.org would

Re: QOF help!

2004-05-04 Thread Derek Atkins
Josh Sled <[EMAIL PROTECTED]> writes: > On Tue, 2004-05-04 at 17:41, Derek Atkins wrote: > >> IMHO doxygen should be the ONLY place for API documentation. >> However if you want to provide usage examples, or architectural >> documentation, docbook would definitely be a reasonable thing. > > I'd pu

Re: QOF help!

2004-05-04 Thread Josh Sled
On Tue, 2004-05-04 at 17:41, Derek Atkins wrote: > IMHO doxygen should be the ONLY place for API documentation. > However if you want to provide usage examples, or architectural > documentation, docbook would definitely be a reasonable thing. I'd push for most instances of this type of documentat

Re: QOF help!

2004-05-04 Thread Derek Atkins
Neil Williams <[EMAIL PROTECTED]> writes: > The documentation produced, is there a problem with hosting it somewhere? (If > I keep it updated from CVS)? I've got the space to host it, if you'd like, > although somewhere on gnucash.org would be more intuitive it would force the > update burden o

Re: QOF help!

2004-05-04 Thread Neil Williams
On Monday 03 May 2004 11:15, Derek Atkins wrote: > Neil Williams <[EMAIL PROTECTED]> writes: > > On Monday 03 May 2004 4:07, you wrote: > >> In theory, the docs should auto build with doxygen > >> I think you need to > >> configure --enable-doxygen or --enable-dot > Uh, did you try "make doc"?

Re: QOF help!

2004-05-03 Thread Neil Williams
On Monday 03 May 2004 4:07, you wrote: > > Where's the documentation for using QOF and Gnucash together? > > In theory, the docs should auto build with doxygen > I think you need to > configure --enable-doxygen or --enable-dot > > These docs may be, um minimal. After updating from CVS HEAD, rer

Re: QOF help!

2004-05-03 Thread Derek Atkins
Neil Williams <[EMAIL PROTECTED]> writes: > On Monday 03 May 2004 4:07, you wrote: >> > Where's the documentation for using QOF and Gnucash together? >> >> In theory, the docs should auto build with doxygen >> I think you need to >> configure --enable-doxygen or --enable-dot >> >> These docs ma

Re: QOF help!

2004-05-03 Thread Linas Vepstas
Hi, FYI, there are now two example progs on the web: http://qof.sourceforge.net/my-obj-example.c.html http://qof.sourceforge.net/gobj-example.c.html Although neither directly adress your question. On Mon, May 03, 2004 at 10:33:32AM +0100, Neil Williams was heard to remark: > > I can't get this

Re: QOF help!

2004-05-03 Thread Derek Atkins
Neil Williams <[EMAIL PROTECTED]> writes: > I can't get this clear and I can't find any documentation on exactly how to > iterate over the existing, registered, GnuCash objects. At the moment, QOF > isn't make a whole lot of sense. Do I have to create and register yet another > object to query

Re: QOF help!

2004-05-03 Thread Neil Williams
On Monday 03 May 2004 7:44, Neil Williams wrote: > On Sunday 02 May 2004 10:08, Derek Atkins wrote: > > > I'm trying to understand QOF using the sourceforge example: > > > http://qof.sourceforge.net/my-obj-example.c.html > > > To find the invoices you either need to iterate > > (using qof_collectio