Re: [Ndoc-users] Documenting functions which are *not* in a class

[Wim C. <wc...@gm...>]

2006/10/6, Wilson Robin T <rob...@br...>:
> I have lots of functions which are just in separate .cpp files with no
> membership of a class (or even a namespace - though I wouldn't mind making
> them members of a namespace if that would help). Is there any way to
> document these functions using NDoc? If I look at the XML that Visual Studio
> spits out then it does list those functions which aren't in a class - NDoc
> just doesn't seem to do anything with it.
>

I don't use visual studio or write code in c++, so I obviously cannot
reproduce this
problem. However, I do know that dotNET assemblies never contain standalone
functions. Dotnet compilers for languages which do have this feature
(e.g. delphi)
have to put such functions in a special class.

Now if NDOC encounters a member element which for some reason does not
match the CLR metadata of anything in the compiled assembly, then it will
ignore the element. To find out if this is your problem, take a look
at your assembly
(e.g. with Lutz Roeder's .NET Reflector), find out in which namespace+class your
function ended up, and then compare that with the XML element.

That should shed some more light on the cause of your problem.

HTH,
Wim Coenen.