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
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.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Url : http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20040504/7d43124c/attachment.bin
More information about the gnucash-devel