XML Documentation?
-
I'm trying to have visual studio generate my .xml documentation file but for some reason it won't keep the project property "XML Documentation File". When I go into the project properties then go to Configuration Properties -> Build under the property XML Documentation File I type in the location where I want the .xml file then when I press apply it blanks it out. Why can't I set the property? Is there a way to force visual studio to apply the /doc argument? Please Help, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
-
I'm trying to have visual studio generate my .xml documentation file but for some reason it won't keep the project property "XML Documentation File". When I go into the project properties then go to Configuration Properties -> Build under the property XML Documentation File I type in the location where I want the .xml file then when I press apply it blanks it out. Why can't I set the property? Is there a way to force visual studio to apply the /doc argument? Please Help, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
-
You will have to go and apply the settings and reload the project in order the operation to work. Once you reload the project and go to the properties of the Project, you should see everything that you need to update.
I tried what you suggested but it still won't apply keep the setting or output the .xml file. I've even tried creating a new solution and adding the project to it but it didn't work. What can I do? Thanks, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
-
I tried what you suggested but it still won't apply keep the setting or output the .xml file. I've even tried creating a new solution and adding the project to it but it didn't work. What can I do? Thanks, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
If you are putting a path in front of the .xml file, eg. c:\MyDocuments\VSProjects\MyProject\bin\, then myproject.xml, you are putting the .xml doc in another place where VS can't see it. The IDE is expecting that the myproject.dll and myproject.xml to be in the same place, ie the output path in the project properties, which is usually bin\Debug or bin\Release. Just put the name of the file, which should be exactly the same name as the project dll except the extention. As for the issue with not having the settings stick, is beyond me. I tried several different approaches this morning and couldn't repeat the problem that you were describing. I do recall a project that gave me the same issue, but when I closed the solution and reopened it, the problem disappeared. I wish that I could be of more assistance. NDoc might be another alternative to use or http://www.csharpwarehouse.com/Code+Bank/471.aspx[^] here are some links that may help you out too: http://weblogs.asp.net/cazzu/archive/2003/12/17/44105.aspx [^]--deals with hardlinks http://www.squiffler.com/squiffler/article.aspx?id=1[^] --deals with doing web comments
-
If you are putting a path in front of the .xml file, eg. c:\MyDocuments\VSProjects\MyProject\bin\, then myproject.xml, you are putting the .xml doc in another place where VS can't see it. The IDE is expecting that the myproject.dll and myproject.xml to be in the same place, ie the output path in the project properties, which is usually bin\Debug or bin\Release. Just put the name of the file, which should be exactly the same name as the project dll except the extention. As for the issue with not having the settings stick, is beyond me. I tried several different approaches this morning and couldn't repeat the problem that you were describing. I do recall a project that gave me the same issue, but when I closed the solution and reopened it, the problem disappeared. I wish that I could be of more assistance. NDoc might be another alternative to use or http://www.csharpwarehouse.com/Code+Bank/471.aspx[^] here are some links that may help you out too: http://weblogs.asp.net/cazzu/archive/2003/12/17/44105.aspx [^]--deals with hardlinks http://www.squiffler.com/squiffler/article.aspx?id=1[^] --deals with doing web comments
it works! I tried putting just the filename, like you suggested, and it worked. I guess you can't put in a path + filename even if the path is the same as the project output. That's kind of confusing but at least I got it to work. Thanks a lot, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
-
it works! I tried putting just the filename, like you suggested, and it worked. I guess you can't put in a path + filename even if the path is the same as the project output. That's kind of confusing but at least I got it to work. Thanks a lot, Rob Tomson -- There are 10 kinds of people. Those who understand binary and those who don't.
You're welcome.