https://bugs.freedesktop.org/show_bug.cgi?id=69306

--- Comment #5 from Michael Stahl <[email protected]> ---
sorry, this one went out of sight...

(In reply to comment #2)
> 
> I understood it as a bug in doxygen's IDL format support.
> 

well... there is no doxygen UNO IDL *comment* support,
only doxygen UNO IDL *syntax* support.

(or i guess i should say autodoc comment support, since as
far as UNO IDL is concerned comments start with /* and end with */)

the documentation for @param is here:

http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdparam

... and it speaks of "a paragraph" so probably that means one.

paragraphs breaks are indicated by an empty line, see:

http://www.stack.nl/~dimitri/doxygen/manual/markdown.html#md_para

... but fortunately we can insert a line break in the paragraph
via the <br> tag because doxygen understands HTML too:

http://www.stack.nl/~dimitri/doxygen/manual/htmlcmds.html

... and for the XConnectionTools that basically means removing the
2 empty lines gives the desired layout.

[ i wonder how long it takes until i start complaining that our IDL
comments have become inconsistent mess of JavaDoc, HTML and Markdown :D ]

not sure if all of this means the bug can be resolved - WFM perhaps?

-- 
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
Libreoffice-bugs mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

Reply via email to