Re: [Mono-dev] monodocer ignores "internal protected" members

[Jonathan Pryor]

On Tue, 2008-02-05 at 13:26 +0100, Stefan Noack wrote:
> I'm not sure whether this problem is subject to this list but I didn't
> find a better place to report my problem.

mono-docs-list is the normal place for this.

> I use monodocer with -importslashdoc to import XML documentation from
> the files generated by the compiler from in-source XML documentation. As
> it should be internal and private classes/members are ignored. However,
> internal protected members should not be ignored as they are accessible
> to someone overriding class members. They are present in the XML files
> generated by the compiler, though. I neither found an option telling
> monodocer not to ignore internal protected classes/members nor did I
> find a bug report about this issue.

What version of mono is this?  That was fixed on 2007-03-15 so that
internal protected members were documented; it's even checked in the
unit tests.  I'm not sure which Mono release came after that, but it's
been fixed in svn for nearly a year.

If you have a recent version of monodocer and it still fails for you,
could you file a minimal reproducible test case at bugzilla.novell.com?

Thanks,
 - Jon


_______________________________________________
Mono-docs-list maillist  -  Mono-docs-list@...
http://lists.ximian.com/mailman/listinfo/mono-docs-list

[Stefan Noack]

> What version of mono is this?  That was fixed on 2007-03-15 so that
> internal protected members were documented; it's even checked in the
> unit tests.  I'm not sure which Mono release came after that, but it's
> been fixed in svn for nearly a year.
>
> If you have a recent version of monodocer and it still fails for you,
> could you file a minimal reproducible test case at bugzilla.novell.com?
>

This is strange. I use mono 1.2.6 and the monodoc 1.2.6 gentoo ebuild
which afaik contains monodocer. But it looks strange, though:

noah@linux-laptop ~/prog/liblamp/trunk $ monodocer --version
Monodocer - The Mono Documentation Tool  0.0.0.0 - Copyright (c) 2004
Joshua Tauberer <tauberer@...>
released under the GPL.
A tool for creating and updating Mono XML documentation files for
assemblies.

I think the ebuild might be wrong and uses old code or something. Thanks
for your help :) Maybe i should switch to the SVN sources?

Stefan
--
Check out my open source .NET physics library project at
http://liblamp.sourceforge.net

_______________________________________________
Mono-docs-list maillist  -  Mono-docs-list@...
http://lists.ximian.com/mailman/listinfo/mono-docs-list

[Jonathan Pryor]

On Tue, 2008-02-05 at 18:09 +0100, Stefan Noack wrote:

> > What version of mono is this?
>
> This is strange. I use mono 1.2.6 and the monodoc 1.2.6 gentoo ebuild
> which afaik contains monodocer. But it looks strange, though:
>
> noah@linux-laptop ~/prog/liblamp/trunk $ monodocer --version
> Monodocer - The Mono Documentation Tool  0.0.0.0 - Copyright (c) 2004
> Joshua Tauberer <tauberer@...>
> released under the GPL.
> A tool for creating and updating Mono XML documentation files for
> assemblies.

You can ignore the 0.0.0.0 version number; it's automatically generated
by Mono.GetOptions, and has no relation to any actual monodocer or mono
version number.

Mono 1.2.6 should have an up-to-date monodocer, so I'm surprised that
you're seeing this problem with protected internal members.

> I think the ebuild might be wrong and uses old code or something. Thanks
> for your help :) Maybe i should switch to the SVN sources?

You shouldn't need to switch to svn or anything.

Please file a bug at bugzilla.novell.com and I'll take a look at it.

 - Jon


_______________________________________________
Mono-docs-list maillist  -  Mono-docs-list@...
http://lists.ximian.com/mailman/listinfo/mono-docs-list