[wx-dev] [wxdocs] update on the status of the conversion

[Vadim Zeitlin]

On Wed, 02 Jan 2008 01:48:05 +0100 Francesco Montorsi <f18m_cpp217828 at yahoo.it> wrote:

FM> QUESTION #1: are we still all convinced of the doxygen solution?

 I was convinced by it but one of the arguments which carried a lot of
weight for me was that this was something easy and (relatively) quick to do
and now it seems that maybe it was a bit overoptimistic to believe it...

FM> QUESTION #2 (assuming yes to Q#1): where are we going to put the new 
FM> ad-hoc headers ? Is wxWidgets/docs/interface a good place?

 I don't think these files should go under docs if they're going to be used
for wxPython (and other bindings) too. We should either put them under
include or make a new top-level directory for them. I think I'd prefer the
latter (it could be called "interface").

FM> QUESTION #3 (assuming yes to Q#1): is it ok to migrate to the new doc 
FM> format even if it does not work yet for SWIG for wxPython/wxLua/etc?

 Yes, I think so. As long as we can use these headers for the
documentation, we should be ready to switch to them. Of course, I do hope
that Robin can also use them for wxPython (and hence continue maintaining
them :-) but it's not necessary to wait for it to happen if Robin is sure
that this can be done.

 Thanks,
VZ