QOF help!

Neil Williams linux at codehelp.co.uk
Tue May 4 16:52:56 EDT 2004

On Monday 03 May 2004 11:15, Derek Atkins wrote:
> Neil Williams <linux at codehelp.co.uk> 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"?

Ok, for some reason I thought configure would add doc to the target list. 
Makefiles are still unfamiliar. Done now.

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 onto someone else.

> > I'll keep writing some documentation as I go, using docbook. It may turn
> > out to be useful for others.
> That's extremely UN-USEFUL.  As Linas suggested can you please write
> docs in doxygen format in the header files and submit patches to the
> headers?

The big advantage with doxygen is the links from one typedef to another. I'll 
include doxygen compatible info in the files, certainly, but most of the 
docbook stuff is for my own reference and has a different emphasis to the 
doxygen output. It's not primarily for project use, although it may still 
turn out to be useful. e.g. if this information had been readily accessible 
when I started thinking about the merge facility, it would have made my life 
easier. If it helps anyone else get a start in a large project, especially 
someone like me whose degree isn't in computer programming/science, I don't 
see the harm - considering I'll be writing it anyway for my own use. I can be 
far more expansive in docbook and the docbook itself doesn't have to be 
packaged with the code.

Off to learn about doxygen now, adding to GTK, Glib, QOF, and automake. I may 
as well say this now, I'm NOT going to be able to learn Scheme as well! I'll 
need help with the GUI dialogs etc. Plenty of time yet though.


Neil Williams

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: signature
Url : http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20040504/7d43124c/attachment.bin

More information about the gnucash-devel mailing list