[Mono-dev] mdoc update for a non-public types

xplicit svg at ngs.ru
Thu Oct 24 11:38:35 UTC 2013


I have simple class. You can see, that the class is non-public. When I set
option "Produce XML doc" in Monodevelop, the xml documentation file is
created. But when I try to create documentation using
mdoc update -i mdocTest.xml -o doc  mdocTest.exe 
no documentation for mainClass is created. That is because monodocer.cs (at
line 656) checks types for public and if type is not public, then skip it
and does not update documentation. This looks quite strange I think
documenting or not documenting classes should be similar for compiler and
monodocer. Can anyone explain is this normal behaviour or not?


namespace mdocTest
{
	class MainClass
	{
		/// <summary>
		/// The entry point of the program, where the program control starts and
ends.
		/// </summary>
		/// The command-line arguments.
		public static void Main (string[] args)
		{
			Console.WriteLine ("Hello World!");
		}
	}
}

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>mdocTest</name>
    </assembly>
    <members>
        <member name="M:mdocTest.MainClass.Main(System.String[])">
            <summary>
            The entry point of the program, where the program control starts
and ends.
            </summary>
            The command-line arguments.
        </member>
    </members>
</doc>


 



--
View this message in context: http://mono.1490590.n4.nabble.com/mdoc-update-for-a-non-public-types-tp4661174.html
Sent from the Mono - Dev mailing list archive at Nabble.com.


More information about the Mono-devel-list mailing list