Date: prev next · Thread: first prev next last
2011 Archives by date, by thread · List index


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



Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.