[GRASS-dev] Re: [GRASS GIS] #1175: tools/mkhtml.py bug (was: g.html2man.py bug)

[GRASS GIS]

#1175: tools/mkhtml.py bug
-----------------------+----------------------------------------------------
 Reporter:  neteler    |       Owner:  grass-dev@…              
     Type:  defect     |      Status:  new                      
 Priority:  critical   |   Milestone:  7.0.0                    
Component:  Compiling  |     Version:  svn-trunk                
 Keywords:             |    Platform:  All                      
      Cpu:  All        |  
-----------------------+----------------------------------------------------

Comment(by glynn):

 Replying to [comment:1 neteler]:
 > Note: This new bug is related to the recent addition of TOC in
 tools/mkhtml.py

 The bug isn't "related" to r43469, the bug is in r43469 (summary changed
 to reflect this).

 g.html2man.py is correct: the only permitted children of a UL element are
 LI elements. LI elements can contain just about anything, including UL
 elements, but the LI start tag isn't minimisable.

 IOW, this:

 {{{
     <li><a href="#EXAMPLES">EXAMPLES</a></li>
     <ul>
         <li><a href="#DBF">DBF</a></li>
         ...
     </ul>
     <li><a href="#SEE ALSO">SEE ALSO</a></li>
 }}}

 should be this:

 {{{
     <li><a href="#EXAMPLES">EXAMPLES</a></li>
     <li>
         <ul>
             <li><a href="#DBF">DBF</a></li>
             ...
         </ul>
     </li>
     <li><a href="#SEE ALSO">SEE ALSO</a></li>
 }}}

 Running a page through a validator would have shown what the problem was
 (and simply trying to build GRASS would have shown that there was a
 problem). As always: "works in my browser" is not a reliable test of
 validity.

-- 
Ticket URL: <http://trac.osgeo.org/grass/ticket/1175#comment:2>
GRASS GIS <http://grass.osgeo.org>