Hi all,

 

I have put an ndoc task to my build file but I’ve missing all code documentation. The class structure was build but that’s all. When I run the same from NDoc Gui itself and select the created program version from Visual .Net it works well. I achieve the same (missing documentation) from NDoc Gui if I select the app version which was created by nant ndoc task. Both versions the created release version from Visual .Net and that from nant build are different in size. Maybe that is the reason. My build task looks as follows:

 

<target name="build" depends="init" description="build's carat application for net 1.1">

    <property name="nant.settings.currentframework" value="net-1.1" />

                        <csc target="winexe" output="${build.dir}/${filename}" debug="${debug}" doc="${base.dir}/Carat.xml">

                                   <sources>

                                               <include name="${src.dir}/**/*.cs"/>

                                   </sources>

 

                                   <references>

                                               <include name="${lib.dir}/*.dll"/>

                                               <include name="System.dll" />

                                               <include name="System.Drawing.dll" />

                                               <include name="System.Windows.Forms.dll" />

                                   </references>

 

                                   <resources dynamicprefix="true" prefix="Carat">

            <include name="${src.dir}/**/*.resx" />

                        </resources>                                       

 

                        </csc>

</target>

 

And here my documentation task:

 

<target name="docu" depends="build" description="make the source documentation">

            <ndoc>

                        <assemblies basedir="${build.dir}">

                                   <include name="${filename}" />

                        </assemblies>

                        <documenters>

                                   <documenter name="MSDN">

                                               <property name="OutputDirectory" value="${doc.dir}" />

                                               <property name="HtmlHelpName" value="CaratControl" />

                                               <property name="HtmlHelpCompilerFilename" value="${htmlhelp.compiler}" />

                                               <property name="IncludeFavorites" value="true" />

                                               <property name="IncludeHierarchy" value="true" />

                                               <property name="Title" value="Carat Source Documentation - ${version}" />

                                               <property name="SplitTOCs" value="true" />

                                               <property name="ShowVisualBasic" value="false" />

                                               <property name="OmitObjectTags" value="false" />

                                               <property name="RootPageContainsNamespaces" value="false" />

                                               <property name="SortTOCByNamespace" value="true" />

                                               <property name="ShowMissingSummaries" value="false" />

                                               <property name="ShowMissingRemarks" value="false" />

                                               <property name="ShowMissingParams" value="false" />

                                               <property name="ShowMissingReturns" value="false" />

                                               <property name="ShowMissingValues" value="false" />

                                               <property name="DocumentInheritedFrameworkMembers" value="true" />

                                               <property name="DocumentPrivates" value="false" />

                                               <property name="DocumentProtected" value="true" />

                                               <property name="DocumentEmptyNamespaces" value="false" />

                                               <property name="SkipNamespacesWithoutSummaries" value="false" />

                                               <property name="AutoPropertyBackerSummaries" value="false" />

                                               <property name="AutoDocumentConstructors" value="true" />

                                               <property name="GetExternalSummaries" value="true" />

                                               <property name="IncludeAssemblyVersion" value="true" />

                                   </documenter>

                        </documenters>

            </ndoc>

 

            <!-- Remove everything except the help file itself from the current SDK documentation directory -->

            <delete>

                        <fileset basedir="${current.sdkdoc.dir}">

                                   <include name="**/*" />

                                   <exclude name="**/*.chm" />

                        </fileset>

            </delete>

</target>

 

Where is the mistake ? The build task works, the created application starts without error. But how I said before the size of both generated files are different and documentation wasn’t included if I select the version which was build from nant.

 

Thanks in forward

Cando

-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
NAnt-users mailing list
NAnt-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/nant-users

Reply via email to