Re: API documentation [was: Re: Problem with python swig example - geturl.py]

Branko Čibej <brane@xbc.nu> writes:
> Ah, but you see, Doxygen is extremely flexible and you can make the
> markup practically invisible.

Ah, okay, +1 then.

> >(On the other, Doxygen might be easier if we continue to put the param
> >names in all-caps.)
>
> Blech. That all-caps stuff is yuck anyway. :-)
> Would you accept appropriate font-lock highlighting for the Doxygen markup?

Well, I suspect most people are in your camp and never liked the
all-caps style anyway; assuming that's ture, let's get rid of it.
I'll learn to read whatever we come up with :-). Emacs highlighting
would be a nice replacement, but not necessary.

> The point is, though, that Doxygen generates superb html docs, and this
> is something we'll need before 1.0.

Okay, let's go for it.

If you can do a few doc strings right away, then the rest of us can
probably starting tweaking stuff as we go (no need to lay this burden
on just one person).

-K

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Dec 4 02:29:15 2002