[Libreoffice] HTML formatting in comments?

[Thomas Arnhold]

Hi Cedric,

somewhere I read, that IDL files are _mostly_ files with *.idl extension
(I don't remember precisely where I read this). If we are really sure
about these files we could publish this as an Easy Hack.

What do you think about this?

Thomas

On 02/04/2011 08:19 AM, Cedric Bosdonnat wrote:
> Hi Thomas,
> 
> On Thu, 2011-02-03 at 18:07 +0100, Thomas Arnhold wrote:
>> Ok, didn't know, that idl files get handled another way. How do we
>> clearly identify IDL and related files, which shouldn't be handled by
>> doxygen?! Are these only files with the idl extension? And is the
>> doxygen documentation complete without these files?
> 
> IMHO the files that should use that custom markup should only be the
> *.idl files (mostly located in the offapi module).
> 
> I would say that all use of that markup in hxx files should be banned /
> changed. I know that some files are using it to produce the doc linked
> here on OOo website:
> 
> http://api.openoffice.org/docs/cpp/ref/names/index.html
> 
>> As an simple alternative we could define aliases for TRUE/FALSE and so
>> on with doxygen, say it replaces <TRUE/> with TRUE.
> 
> Well, a simple script that spots all the occurences of these tags in C++
> would help as well. It could at least show us the files containing
> comments to switch to Doxygen documentation style. Then sed is your
> friend for this kind of boring job :)
>