Rico,
The slashdoc file should be in the same directory as the assembly
(${base.dir}/Carat.xml = ${build.dir}/${filename}) ?
Gert
- Original Message -
From: Rico Schaepe [EMAIL PROTECTED]
To: nant-users@lists.sourceforge.net
Sent: Tuesday, August 01, 2006 8:53 AM
Subject: [NAnt-users] ndoc task doesn't create source documentation
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
