Excluding some Public Classes in NDoc

[Ash Moollan [InfoMaster]]

Hi there,

I am using NDOC to generate docs for one C# project which I wrote. My
assembly has some public classes that are not meant to be used by others and
I have not documented them. I would like NDOC not to generate documentation
for those public classes that do not have an XML documentation. Can anyone
suggest how I do that?

All help much appreciated

Thanks
Ash Moollan
Software Developer / Consultant

 

[AdamM]

I believe there is a /nodoc compiler switch you should look at.

 

[AdamM]

I may have misundrstood your question initially, but I found this in the
NDOC docs:

If you scroll to the bottom of the property grid in NdocGui, you will see a
category of options called "Visibility". These options will allow you to,
for instance, document internal or private classes. If you try changing
'DocumentInternals' to true, you should produce some documentation.
Not sure if this answers your question, but I hope it is helpful.

 

[John Vottero]

Hi there,

I am using NDOC to generate docs for one C# project which I wrote. My
assembly has some public classes that are not meant to be used by others
and I have not documented them. I would like NDOC not to generate
documentation for those public classes that do not have an XML
documentation. Can anyone suggest how I do that?

All help much appreciated

Add the <exclude /> tag like this:

/// <summary>
/// <exclude />
/// This won't be in NDoc!
/// </summary>

 

[KD]

Try using the <exclude/> tag

http://ndoc.sourceforge.net/content/tag_exclude.htm

 

[Ash Moollan [InfoMaster]]

Hi all,
Thanks for all your help. I ended up looking at the NDOC source code and I
added a new option in there not to document classes that do not have
comment.

e.g
/// <Summary>Blah Class</Summary>
Public Class Blah {}

Public Class Blah1{}

After running this through my version of NDOC, documentation will only be
generated for class Blah and not Blah.
I did that because the access modifiers option in NDOC is not enough because
both classes are public.

If anyone is interrested to know how i set that flag, give me a yell and
i'll post the code.

Thanks
Ash Moollan
Software Developer / Consultant

 

[JRoughgarden]

Ash,

Yes, I would be interested in seeing your version of the NDOC source
code. Please post it.

As it stands, I am not much impressed with NDOCS. It seems to pump out
a lot of boilerplate. Documentation was better back in the heyday of
VB5, when there was an OCX from Sheridan called vbDocumenter. It
created help files without the BS.

Jeff Roughgarden.

 

[Ashraf]

Jeff,

I have put the code up on http://www.moollan.net/files

The code is under the same licencing scheme as the original code: the
gnu gpl.
If you dont know what that is, please get yourself a copy and read it
before you download.

Thanks
Ash Moollan
www.moollan.net