which versions of the manual do we want?

[Francesco Montorsi]

Hi,

Francesco Montorsi ha scritto:
>>>  In conclusion the list of manual builds could be:
>>>   - C++ doxygen version
>>>   - C++ "wx-styled" version (??)
>>>   - C++ simplified CSS-less version
>>
>> Just the first and third should be good I think.
> ok - everyone seems to agree on this.
> 
> I'm working on the XSLT for the simplified CSS-less version, then.
Unfortunately there are bad news about this.

The first thing I've tried is to transform through an XSLT the doxygen 
XML output into XHTML; however that's going to be a lot of work! doxygen 
XML is _very_ much structured and writing an XSLT which produces 
something similar to the doxygen HTML output would take a lot of time.

Since however we need pretty much few changes (basically we need to push 
the main CSS attributes into the 'style' attribute of the HTML tags), it 
would be much more easier and faster to process with an XSLT directly 
the doxygen HTML output.
Unfortunately doxygen outputs HTML 4.01 and not XHTML. Since HTML4 is 
not well-formed XML you can't process it with XSLT.

I've then looked at doxygen sources to see if it's possible to upgrade 
the output it produces from HTML4 to XHTML.
The result of my attempts have been posted to the doxygen-develop 
mailing list (and resulted in this patch: 
http://bugzilla.gnome.org/show_bug.cgi?id=519886) but I've been blocked 
by some problems which require more experienced doxygen hackers [*].
I hope some of them will help with completing it as I think it would be 
extremehely useful to produce valid XHTML directly from doxygen.

By now the best thing we could try in order to generate a CSS-less 
version of the manual is probably writing a sed script which works on 
the HTML4 doxygen output.

In any case, I think I'll postpone this step (generation of CSS-less 
manual) to see how doxygen developers react to my proposals.

In the meanwhile I'll try to proceed with API reference conversion.

Francesco