Re: [Doxygen-develop] strategies for XHTML support

[Francesco M. <f18...@ya...>]

Hi,
     sorry for the big delay but somehow I missed this reply up to now.

do...@ke... ha scritto:
> On Wed, Mar 05, 2008 at 03:12:49PM +0100, Francesco Montorsi wrote:
> 
>> Francesco Montorsi ha scritto:
>>> In conclusion: I need a pause and some help to complete this patch :)
>>>
>>> What's your (doxygen team) interest toward XHTML?
>>> Isn't it one of your priorities?
>> so, there's no interest in XHTML development?
>> Noone willing to help me?
> 
> I'm willing to help.
Great!

>  I'm very behind on the internals of Doxygen,
> though, so I don't know how much help I can be.
> 
> What do you need other people to help with?
basically with testing of the patch and with further fixes to doxygen
sources; in particular to force it to generate all needed </tr> and
</td> tags.

Steps to help:
  1) apply my patch to doxygen trunk

  2) unzip the validator stuff in the examples folder

  3) enable the #define DBG_HTML(x) macro to return "x" in htmlgen.cpp

  4) compile doxygen; run it on the examples and then run the 
"./validate_xhtml" script

  5) look at the validation file called "log": there are bunch of errors 
there which need to be fixed in the corresponding *def.cpp source files.

E.g. I get as first error:

define/html/define_8h.html:68: parser error : Opening and ending tag 
mismatch: tr line 56 and table
       </table>
               ^
You can see in that html file that there is a missing </tr> tag:


<!-- startMemberDocName -->
       <table class="memname">
         <tr>
           <td class="memname">#define MAX<!-- endMemberDocName -->
           </td>
<!-- startParameterList -->
           <td>(</td>
<!-- startFirstParameterType -->
           <td class="paramtype">x, <!-- endParameterType -->
&nbsp;</td>
<!-- startParameterType -->
         <tr>
           <td class="paramkey"></td>
           <td></td>
           <td class="paramtype">y<!-- endParameterType -->
&nbsp;</td>
<!-- startParameterName -->
           <td class="paramname"><!-- endParameterName -->
           </td>
           <td>&nbsp;)&nbsp;</td>
           <td>&nbsp;&nbsp;&nbsp;((x)&gt;(y)?(x):(y))<!-- 
endParameterList -->
</td>
         </tr>
<!-- endMemberDoc -->
       </table>


this is due to the fact that after startFirstParameterType() is called, 
and after endParameterType() is called, there's no </tr> added.
This is because (AFAIUI) after the parameter type it should always be 
spit out the parameter name, which puts the </tr>. In this case it 
wasn't called... why?

etc.... to be continued... :)


Thanks for any help!!

Francesco