[Libreoffice] HTML formatting in comments?

Thomas Arnhold thomas at arnhold.org
Sun Feb 13 09:16:43 PST 2011

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?


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 :)

More information about the LibreOffice mailing list