Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 388163

Summary: [luadocumentor] Markdown bullet points do not work properly if not preceded by a regular line
Product: [Tools] LDT Reporter: Gaetan Morice <gmorice>
Component: LuaDevelopmentToolsAssignee: Simon Bernard <sbernard>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: P2 CC: kkinfoo, marc.aubry42
Version: 0.9   
Target Milestone: 0.9 RC1   
Hardware: PC   
OS: Mac OS X   
Whiteboard:
Bug Depends on:    
Bug Blocks: 393539    

Description Gaetan Morice CLA 2012-08-28 02:40:55 EDT
The following comment is displayed correctly in the luadoc view (there's a problem with bullet points hierarchy):


--- A function.
-- 
-- * bullet 1
-- * bullet 2
-- * bullet 3
-- @function [parent=#global] myfn

The following comment works well:

--- A function.
-- 
-- A regular line.
-- 
-- * bullet 1
-- * bullet 2
-- * bullet 3
-- @function [parent=#global] myfn
Comment 1 Marc Aubry CLA 2012-09-19 06:10:00 EDT
Also, the indented bullets doesn't work.

For example the following documentation:
---
-- * apple
-- * banana
--     * orange

The expected HTML generated is : 
<ul>
    <li>apple</li>
    <li>banana
    <ul>
    	<li>orange</li>
    </ul></li>
</ul>

But it is:
<ul>
    <li>apple
    <ul>
         <li>banana
         <ul>
             <li>orange</li>
         </ul></li>
    </ul></li>
</ul>
Comment 2 Marc Aubry CLA 2012-09-20 05:23:39 EDT
Also, for the following comment:

--- Module to process.
-- 
-- A regular line.
-- 
-- * apple	
-- * banana
-- * orange
--
-- Another regular line.
-- 
-- @module list

The generated HTML is:

<ul>
    <li>apple</li>
    <li>banana</li>
    <li><p>orange</p>
    <p>Another regular line.</p></li>
</ul>
	

The last line "Another regular line." is included in the last bullet instead to be separated paragraph.
Comment 3 Simon Bernard CLA 2012-11-07 10:41:56 EST
fixed in 0d8e484bf8d3c22913b92ff2779c72ddcd82a1f6.