Hi Einar,
Try with the latest build. I've just knocked up a small test and I get the xml generated just from using the <solution> task. All I did was create a C# library, add a couple of methods & xmldoc headers and set the doc name on the project properties in VS. Then I did a NAnt script with a <solution> task pointing at the solution. Worked fine.
I've got the nightly build form 15th July 2005. It might be a bug that's been fixed.
Cheers,
Bill
| <[EMAIL PROTECTED]>
10/08/2005 12:04
|
To: <[EMAIL PROTECTED]> cc: <nant-users@lists.sourceforge.net> Subject: RE: [Nant-users] Creating XML documentation with Solution task only |
Bill,
Thanks for the reply. I am writing in C#, and using Nant 0.85-rc2.
When I use the <csc> task, specifying the doc attribute, the XML file is generated. It may seem, then, as if the <solution> task does not pass the /doc switch to the compiler, yet it definitely registers the existence of an XML documentation file specification in the project file - as it tries to copy the (non-existant) file, presumably to the output directory.
Kind regards,
Einar
-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
Sent: 10. august 2005 12:16
To: Høst, Einar
Cc: nant-users@lists.sourceforge.net; [EMAIL PROTECTED]
Subject: Re: [Nant-users] Creating XML documentation with Solution task only
Einar,
Just to confirm, I presume you are writing in C#, not VB.NET?
If it's a C# project, the documentation is actually produced by passing the /doc switch to the compiler. This is an attribute in the <csc> task, so youcould try that to prove it works, if so, then it could be an issue with the <solution> task not picking up the flag from the csproj file and passing it to the compiler. Also, if you perform an incremental compile (passing the /incremental flag to the compiler) then CSC won't generate documentation. I don't think NAnt does this however. As a check, try running NAnt with the verbose and debug options, then you should be able to see the command line passed to CSC in the output.
If you are using VB.NET, then I would presume that you are using something like VBCommenter to comment the code. This hooks into the build events in VS to generate the xml document file. It won't work outside VS. In this case, have a look at the vb.doc project on Sourceforge. This comes with a handy NAnt task you can call from within your script to generate the documentation.
HTH,
Bill
| <[EMAIL PROTECTED]> Sent by: [EMAIL PROTECTED] 10/08/2005 11:06 | To: <nant-users@lists.sourceforge.net> cc: Subject: [Nant-users] Creating XML documentation with Solution task only |
Hi,
I'm having a slightly annoying problem, that hopefully is easy to solve. I have specified an XML documentation file for my project in VS .NET, but when trying to compile the project using the solution task, the XML documentation file cannot be found. Apparently, VS .NET does not create the file when I specify it, but rather at some point during compilation. As it is, I have to perform a "manual" compile within VS .NET to create the file, before I can successfully compile with NAnt. One approach could be to parse the solution file, looking for XML documentation files, and creating them as necessary - but this seems a lot of work for such a simple task?
Kind regards,
Einar
As detailed in the company handbook, Avon Insurance has the facility to
monitor and read both incoming and outgoing communications by e-mail.
A copy of the company handbook can be found here: http://www.ho.nfumutual.co.uk/mutualnet/HANDBOOK/ITPolicies/ITSecure.htm
IMPORTANT
The information contained in this e-mail and any attachments is intended for the addressee only
and may contain legally privileged or confidential information. If you are not the intended
recipient you must not use, disclose, copy, distribute, alter, or take any action in reliance
on the information and Avon Insurance plc will not accept liability for any loss or damage howsoever
arising, directly or indirectly in reliance on it and gives no warranty or representation as to its
accuracy or reliability. If you are not the addressee, please notify us immediately on 01789 202121*
and delete the material from your computer and destroy any copies.
Avon Insurance plc reserves the right to monitor and record incoming and outgoing email messages for
the purposes of investigating or detecting unauthorised use of its system and ensuring its effective operation.
Avon Insurance plc will not accept liability for any loss or damage as a result of any virus being passed on.
Avon Insurance plc (No. 209606).
Registered in England. Registered Office: Arden Street, Stratford upon Avon, Warwickshire CV37 6WA.
Authorised and regulated by the Financial Services Authority.
A member of the NFU Mutual group of companies and the Association of British Insurers.
*For security and training purposes, telephone calls may be recorded and monitored.
As detailed in the company handbook, Avon Insurance has the facility to
monitor and read both incoming and outgoing communications by e-mail.
A copy of the company handbook can be found here: http://www.ho.nfumutual.co.uk/mutualnet/HANDBOOK/ITPolicies/ITSecure.htm
IMPORTANT
The information contained in this e-mail and any attachments is intended for the addressee only
and may contain legally privileged or confidential information. If you are not the intended
recipient you must not use, disclose, copy, distribute, alter, or take any action in reliance
on the information and Avon Insurance plc will not accept liability for any loss or damage howsoever
arising, directly or indirectly in reliance on it and gives no warranty or representation as to its
accuracy or reliability. If you are not the addressee, please notify us immediately on 01789 202121*
and delete the material from your computer and destroy any copies.
Avon Insurance plc reserves the right to monitor and record incoming and outgoing email messages for
the purposes of investigating or detecting unauthorised use of its system and ensuring its effective operation.
Avon Insurance plc will not accept liability for any loss or damage as a result of any virus being passed on.
Avon Insurance plc (No. 209606).
Registered in England. Registered Office: Arden Street, Stratford upon Avon, Warwickshire CV37 6WA.
Authorised and regulated by the Financial Services Authority.
A member of the NFU Mutual group of companies and the Association of British Insurers.
*For security and training purposes, telephone calls may be recorded and monitored.
