Hi,
I am trying to build a C# solution using Nant. Among the tasks I have included in the build document, is the 'ndoc' task. The source code contains xml commentary. However, when I build the application and run the Ndoc task, the resulting CHM file does not show the XML documentation correctly. Instead, I see the text "Missing <summary> documentation for ..." even though the class, method or property does have the correct comment. The task is as follows:
<ndoc>
<assemblies basedir="${base.dir}\${target.env}">
<include name="${project}.dll" />
</assemblies>
<summaries basedir="${base.dir}\${target.env}">
<include name="${project}.namespace.xml" />
</summaries>
<documenters>
<documenter name="MSDN">
<property name="OutputDirectory" value="\doc" />
<property name="HtmlHelpName" value="${project}" />
<property name="HtmlHelpCompilerFilename" value="hhc.exe" />
<property name="IncludeFavorites" value="False" />
<property name="Title" value="${project} Class Library" />
<property name="SplitTOCs" value="False" />
<property name="DefaulTOC" value="" />
<property name="ShowVisualBasic" value="False" />
<property name="ShowMissingSummaries" value="True" />
<property name="ShowMissingRemarks" value="True" />
<property name="ShowMissingParams" value="True" />
<property name="ShowMissingReturns" value="True" />
<property name="ShowMissingValues" value="True" />
<property name="DocumentInternals" value="False" />
<property name="DocumentProtected" value="True" />
<property name="DocumentPrivates" value="False" />
<property name="DocumentEmptyNamespaces" value="False" />
<property name="IncludeAssemblyVersion" value="False" />
<property name="CopyrightText" value="" />
<property name="CopyrightHref" value="" />
</documenter>
</documenters>
</ndoc>
The project namespace xml document contains the following code:
<namespaces>
<namespace name="MyNamespace">
The <b>MyNamespace</b> namespace.
</namespace>
</namespaces>
I would appreciate any ideas on where I am going wrong - I am sure it is a fundamental error I am making.
Regards
Glenn
Glenn Wilson
Corporate Systems Development
Drive thy business or it will drive thee. Benjamin Franklin (1706-1790)
Important: Fidelity Investments International, Fidelity Investment Services Limited, Fidelity Pensions Management and Financial Administration Services Limited (a Fidelity Group company) are all authorised and regulated in the UK by the Financial Services Authority and have their registered offices at Oakhill House, 130 Tonbridge Road, Hildenborough, Tonbridge, Kent TN11 9DZ. Tel 01732 361144. Fidelity only gives information on products and does not give investment advice to private clients based on individual circumstances. Any comments or statements made are not necessarily those of Fidelity. The information transmitted is intended only for the person or entity to which it is addressed and may contain confidential and/or privileged material. If you received this in error, please contact the sender and delete the material from any computer. All e-mails sent from or to Fidelity may be subject to our monitoring procedures. Direct link to Fidelity's website.
