Re: [E-devel] [patch] elementary: doxygen doc fixes

[Jérôme P. <ng...@gm...>]

On 05/29/12 14:36, Jonas M. Gastal wrote:
> On Tuesday 29 May 2012 11:43:19 Jérôme Pinot wrote:
> > Hi,
> > 
> > Here is a patch to fix elementary doxygen doc:
> > - #link on the beginning of a new line does give ugly output:
> > http://ngc891.blogdns.net/pub/projects/debug/doxygen-formating-eww.png
> > - some typos
> > - some missing @c
> > - in elm_web, convert remaining @li parameter lists to @param
> > - minor random fixes
> > 
> > This patch apply to trunk and elementary-1.0 branch.
> 
> Jérôme,
> 
> Did you take the screenshot from the online docs or from documentation 
> generated on your machine? I ask because I only ever saw that problem with 
> doxygen versions newer than the one on e2, and for those versions the # is 
> unneeded, it makes links regardless.
> 
> To be clear, I'm not complaining about your patch, it seems to make things 
> work for both newer and older versions which is great, I'm just looking to 
> know if the formatting problem is present on older doxygen versions.

Seems it was really a bug in Doxygen which was fixed in Doxygen 1.8.1.
We should not worry anymore about where we put the #link.

> Gastal.

-- 
Jérôme Pinot
http://ngc891.blogdns.net/